Send a Custom Greeting Card

Available ActionsEach successful request consumes credits as outlined below.

render_preview^400crcreate_proof^400crsend^400crget_order_status^400crget_tracking^400crlist_orders^400cr

Details

Mail custom folded greeting cards to any US address. You control all four panels: front cover (image), inside left, inside right (main message), and back — each panel can be text or image. Cards can be printed in horizontal or vertical orientation. Four font styles for text: handwritten (blue), elegant (charcoal), modern (near-black), classic (black). Printed on premium cardstock, folded, enveloped, and mailed via USPS First Class with tracking.

Use Cases

Holiday greeting card campaigns, Customer appreciation and thank-you cards, Birthday and anniversary greetings, Event invitation mailings, Nonprofit donor outreach cards, Real estate follow-up mailers, Employee recognition cards, Brand loyalty and retention mailings, Condolence and sympathy cards, Welcome and onboarding cards

Connect Your Agent In 5 Min

Watch the setup guide for your platform

Or Install Locally

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections. This lightweight connector routes requests to https://api.agentpmt.com/mcp. All tool execution happens in the cloud and the server cannot edit any files on your computer.

npm install -g @agentpmt/mcp-routeragentpmt-setup

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ********" \
  -d '{
    "product_id": "6985fead269243768b447d9b",
    "parameters": {
      "action": "render_preview",
      "orientation": "horizontal",
      "font_style": "handwritten"
    }
  }'

import requests
import json

url = "https://api.agentpmt.com/products/purchase"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ********"
}

data = {
    "product_id": "6985fead269243768b447d9b",
    "parameters": {
        "action": "render_preview",
        "orientation": "horizontal",
        "font_style": "handwritten"
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json())

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "6985fead269243768b447d9b",
  parameters: {
    "action": "render_preview",
    "orientation": "horizontal",
    "font_style": "handwritten"
  }
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(data)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

const axios = require('axios');

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "6985fead269243768b447d9b",
  parameters: {
    "action": "render_preview",
    "orientation": "horizontal",
    "font_style": "handwritten"
  }
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

Login to view your API and budget keys. The example above uses placeholder values. Sign in to see personalized code with your bearer token.

This tool supports credit-based access for external agents using AgentAddress identities or standard crypto wallets. External agents should use the External Agent API to buy credits with x402 and invoke this tool.

1. Buy Credits

Purchase credits via x402 payment (500 credit minimum, 100 credits = $1).

# Request payment requirements (returns 402 + PAYMENT-REQUIRED header)
curl -i -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

# Sign the EIP-3009 authorization, then retry with signature header
curl -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -H "PAYMENT-SIGNATURE: <base64-json>" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

2. Create a Session Nonce (nonce used in signed balance/invoke)

curl -s -X POST "https://www.agentpmt.com/api/external/auth/session" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET" }'

3. Invoke This Tool

Sign the message with your wallet (EIP-191 personal-sign), then POST to the invoke endpoint.

# Sign this message (wallet MUST be lowercased):
# agentpmt-external
# wallet:0xyourwallet...
# session:<session_nonce>
# request:<request_id>
# action:invoke
# product:6985fead269243768b447d9b
# payload:<sha256(canonical_json(parameters))>

curl -s -X POST "https://www.agentpmt.com/api/external/tools/6985fead269243768b447d9b/invoke" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_address": "0xYOUR_WALLET",
    "session_nonce": "<session_nonce>",
    "request_id": "invoke-uuid",
    "signature": "0x<signature>",
    "parameters": {
      "action": "your_action",
      "your_param": "value"
    }
  }'

Credentials

Mailing Return Address *

Your mailing return address that will appear on postcards, certified mail, and greeting cards.

custom object

Manage credentials in your dashboard.

Actions(6)

render_preview^400cr15 params

Generate a preview of the greeting card without mailing. Returns the generated PDF and preview images with signed URLs for review before sending.

orientationstring

Card orientation. horizontal: landscape panels, card folds along top edge. vertical: portrait panels, card folds along left edge.

Values:

horizontalvertical

Default: horizontal

font_stylestring

Font style for text panels. handwritten = blue pen-on-paper, elegant = charcoal formal, modern = clean contemporary, classic = traditional black.

Values:

handwrittenelegantmodernclassic

Default: handwritten

front_cover_image_urlstring

URL to front cover image (JPG/PNG). Required for card builder mode.

front_cover_image_file_idstring

File ID of front cover image. Alternative to URL for card builder mode.

inside_left_textstring

Text for inside left panel (visible when card is opened, left side).

inside_left_image_urlstring

Image URL for inside left panel. Provide text OR image for each panel, not both.

inside_left_image_file_idstring

File ID for inside left image.

inside_right_textstring

Text for inside right panel — the main message area. Provide text OR image, not both.

inside_right_image_urlstring

Image URL for inside right panel.

inside_right_image_file_idstring

File ID for inside right image.

back_textstring

Text for back of card (small branding, attribution, etc.).

back_image_urlstring

Image URL for back of card.

back_image_file_idstring

File ID for back image.

document_pdf_urlstring

Public URL to a print-ready 2-page PDF (raw PDF mode, mutually exclusive with card builder fields).

document_pdf_file_idstring

File ID of a print-ready PDF in cloud storage (raw PDF mode).

create_proof^400cr16 params(1 required)

Upload the card to Click2Mail and create the print job without mailing. Used for final review before committing to send.

recipient_addressrequiredobject

Recipient mailing address (US only). Must include name or organization.

Properties:

name(string)- Recipient full name.

organization(string)- Organization name (can be used instead of or with name).

address1*(string)- Street address line 1.

address2(string)- Street address line 2.

city*(string)- City.

state*(string)- Two-letter state code.

postal_code*(string)- ZIP code.

orientationstring

Card orientation. horizontal: landscape panels. vertical: portrait panels.

Values:

horizontalvertical

Default: horizontal

font_stylestring

Font style for text panels.

Values:

handwrittenelegantmodernclassic

Default: handwritten

front_cover_image_urlstring

URL to front cover image (JPG/PNG).

front_cover_image_file_idstring

File ID of front cover image.

inside_left_textstring

Text for inside left panel.

inside_left_image_urlstring

Image URL for inside left panel.

inside_left_image_file_idstring

File ID for inside left image.

inside_right_textstring

Text for inside right panel — the main message area.

inside_right_image_urlstring

Image URL for inside right panel.

inside_right_image_file_idstring

File ID for inside right image.

back_textstring

Text for back of card.

back_image_urlstring

Image URL for back of card.

back_image_file_idstring

File ID for back image.

document_pdf_urlstring

Public URL to a print-ready 2-page PDF (raw PDF mode).

document_pdf_file_idstring

File ID of a print-ready PDF (raw PDF mode).

send^400cr16 params(1 required)

Generate the card PDF, print it on premium cardstock, fold it, envelope it, and mail it via USPS First Class to the recipient address.

recipient_addressrequiredobject

Recipient mailing address (US only). Must include name or organization.

Properties:

name(string)- Recipient full name.

organization(string)- Organization name (can be used instead of or with name).

address1*(string)- Street address line 1.

address2(string)- Street address line 2.

city*(string)- City.

state*(string)- Two-letter state code.

postal_code*(string)- ZIP code.

orientationstring

Card orientation. horizontal: landscape panels. vertical: portrait panels.

Values:

horizontalvertical

Default: horizontal

font_stylestring

Font style for text panels.

Values:

handwrittenelegantmodernclassic

Default: handwritten

front_cover_image_urlstring

URL to front cover image (JPG/PNG).

front_cover_image_file_idstring

File ID of front cover image.

inside_left_textstring

Text for inside left panel.

inside_left_image_urlstring

Image URL for inside left panel.

inside_left_image_file_idstring

File ID for inside left image.

inside_right_textstring

Text for inside right panel — the main message area.

inside_right_image_urlstring

Image URL for inside right panel.

inside_right_image_file_idstring

File ID for inside right image.

back_textstring

Text for back of card.

back_image_urlstring

Image URL for back of card.

back_image_file_idstring

File ID for back image.

document_pdf_urlstring

Public URL to a print-ready 2-page PDF (raw PDF mode).

document_pdf_file_idstring

File ID of a print-ready PDF (raw PDF mode).

get_order_status^400cr1 param(1 required)

Check the status of a previously sent or proofed card order. Automatically includes USPS tracking information when available.

order_idrequiredstring

Order ID returned from a previous send or create_proof call.

get_tracking^400cr2 params(1 required)

Get USPS tracking details for a previously sent card order.

order_idrequiredstring

Order ID returned from a previous send call.

tracking_typestring

Tracking type. Default: IMB.

Values:

IMBIMPB

list_orders^400cr1 param

List past greeting card orders for the current budget, sorted by most recent first.

limitinteger

Number of orders to return.

Default: 10

Range: 1 - 50

Usage Instructions

Usage guidance provided directly by the developer for this product.

Send a Custom Greeting Card

Name: Send a Custom Greeting Card
Brand: Apoth3osis
SKU: 6985fead269243768b447d9b
Price: 4.00 USD
Availability: InStock

Mail custom folded greeting cards to any US address. Provide panel content (front cover image, inside text/images, back text/image) and the backend generates a print-ready PDF, prints it on premium 120# white uncoated cardstock, folds it, envelopes it, and mails it via USPS First Class.

Overview

This tool creates and mails physical folded greeting cards. There are two modes:

Card Builder Mode (recommended): Provide individual panel content (front cover image, inside left/right text or images, back text or image) and the system assembles a print-ready 2-page PDF automatically.
Raw PDF Mode: Provide your own pre-built 2-page PDF (must be exactly 2 pages, 5.5 x 8.5 inches flat).

The recommended workflow is: preview first, then send after user approval.

Panel Layout

PAGE 1 (outside)            PAGE 2 (inside)
+------------------+        +------------------+
|   BACK panel     |        |   INSIDE LEFT    |
|  (rotated 180)   |        |                  |
+------------------+        +------------------+
|   FRONT COVER    |        |   INSIDE RIGHT   |
|  (right-side up) |        |   (message area) |
+------------------+        +------------------+

Front cover -- always an image (required in card builder mode). This is the card front when folded.
Inside left -- text or image (optional). Visible when card is opened, left side.
Inside right -- text or image (optional). The main message/greeting area.
Back -- text or image (optional). Small branding, attribution, etc.

Each panel accepts text OR image (not both). Panels left empty render as blank white.

Physical Card Specs

Flat sheet: 5.5 x 8.5 inches portrait (1650 x 2550 px at 300 DPI)
Folded: 5.5 x 4.25 inches
Paper: 120# White Uncoated premium cardstock
Mailed in envelope with printed address via USPS First Class

Actions

render_preview

Generate a preview of the card without mailing. Returns the generated PDF (with signed URL) and preview images (front and inside JPGs with signed URLs) for the user to review before committing to send.

Required parameters (card builder mode -- at least one panel content field):

front_cover_image_url (string) -- URL to front cover image (JPG/PNG). Required in card builder mode.
OR front_cover_image_file_id (string) -- File ID of front cover image. Alternative to URL.

Required parameters (raw PDF mode -- exactly one of):

document_pdf_url (string) -- Public URL to a print-ready 2-page PDF.
document_pdf_file_id (string) -- File ID of a print-ready PDF in cloud storage.

Optional parameters (card builder mode):

orientation (string, default: "horizontal") -- Card orientation. horizontal: landscape panels, card folds along top edge. vertical: portrait panels, card folds along left edge.
font_style (string, default: "handwritten") -- Font style for text panels. Options: handwritten (Caveat, blue), elegant (Playfair Display, charcoal), modern (Montserrat, near-black), classic (Liberation Serif, black).
inside_left_text (string) -- Text for inside left panel.
inside_left_image_url (string) -- Image URL for inside left panel.
inside_left_image_file_id (string) -- File ID for inside left image.
inside_right_text (string) -- Text for inside right panel (main message area).
inside_right_image_url (string) -- Image URL for inside right panel.
inside_right_image_file_id (string) -- File ID for inside right image.
back_text (string) -- Text for back of card.
back_image_url (string) -- Image URL for back of card.
back_image_file_id (string) -- File ID for back image.

Example: Preview with card builder

{
  "action": "render_preview",
  "front_cover_image_url": "https://example.com/front.jpg",
  "inside_right_text": "Happy Birthday!\n\nWishing you all the best.",
  "font_style": "handwritten"
}

Example: Preview with raw PDF

{
  "action": "render_preview",
  "document_pdf_url": "https://example.com/my-card.pdf"
}

create_proof

Upload the card to the print service and create the print job without mailing. This creates the job in the print system for final review. Requires a recipient address.

Required parameters:

Card content: same as render_preview (card builder fields or raw PDF).
recipient_address (object) -- Recipient mailing address (US only). Required fields within: address1, city, state (two-letter code), postal_code. Must also include name or organization (or both).

Optional parameters:

All card builder options from render_preview (orientation, font_style, panel content fields).

Example: Create proof

{
  "action": "create_proof",
  "front_cover_image_file_id": "FILE_ID",
  "inside_right_text": "Thank you for your business!",
  "font_style": "elegant",
  "recipient_address": {
    "name": "Jane Doe",
    "address1": "123 Main St",
    "city": "Austin",
    "state": "TX",
    "postal_code": "78701"
  }
}

send

Generate the card PDF, print it, and mail it to the recipient. Returns the order ID, document PDF (with signed URL), and preview images.

Required parameters:

Card content: same as render_preview (card builder fields or raw PDF).
recipient_address (object) -- Recipient mailing address (US only). Required fields within: address1, city, state (two-letter code), postal_code. Must also include name or organization (or both). Optional: address2, country (defaults to "US").

Optional parameters:

All card builder options from render_preview (orientation, font_style, panel content fields).

Example: Send a greeting card (card builder)

{
  "action": "send",
  "front_cover_image_file_id": "FILE_ID",
  "inside_right_text": "Happy Birthday!\n\nWishing you all the best.",
  "back_text": "Made with love",
  "font_style": "elegant",
  "orientation": "horizontal",
  "recipient_address": {
    "name": "Jane Doe",
    "address1": "123 Main St",
    "city": "Austin",
    "state": "TX",
    "postal_code": "78701"
  }
}

Example: Send with all panels filled

{
  "action": "send",
  "front_cover_image_url": "https://example.com/holiday-photo.jpg",
  "inside_left_image_url": "https://example.com/family-photo.jpg",
  "inside_right_text": "Season's Greetings!\n\nWishing you warmth and joy this holiday season.",
  "back_text": "From the Smith Family, 2026",
  "font_style": "classic",
  "recipient_address": {
    "name": "The Johnson Family",
    "address1": "789 Pine Rd",
    "city": "Denver",
    "state": "CO",
    "postal_code": "80202"
  }
}

get_order_status

Check the status of a previously sent or proofed card order. Automatically includes USPS tracking information when available.

Required parameters:

order_id (string) -- Order ID returned from a previous send or create_proof call.

Example: Check order status

{
  "action": "get_order_status",
  "order_id": "ORDER_ID"
}

get_tracking

Get USPS tracking details for a previously sent card order.

Required parameters:

order_id (string) -- Order ID returned from a previous send call.

Optional parameters:

tracking_type (string) -- Tracking barcode type. Options: IMB (Intelligent Mail Barcode, default), IMPB (Intelligent Mail Package Barcode).

Example: Get tracking

{
  "action": "get_tracking",
  "order_id": "ORDER_ID"
}

Example: Get package tracking

{
  "action": "get_tracking",
  "order_id": "ORDER_ID",
  "tracking_type": "IMPB"
}

list_orders

List past greeting card orders for the current budget, sorted by most recent first.

Optional parameters:

limit (integer, default: 10, min: 1, max: 50) -- Number of orders to return.

Example: List recent orders

{
  "action": "list_orders",
  "limit": 10
}

Workflows

Preview then send (recommended)

Call render_preview with the card content to generate a proof.
The response includes document_file (full PDF with signed URL) and preview_images (front and inside JPGs with signed URLs). Show these to the user for review.
Once the user approves, call send with the same card content plus recipient_address.

Create proof then approve

Call create_proof with card content and recipient address to create a print job without mailing.
Review the proof in the print system.
Use the order ID to check status with get_order_status.

Check delivery status

After sending, save the order_id from the response.
Call get_order_status with that order_id to check printing and mailing status.
Use get_tracking for detailed USPS tracking information.

Notes

US addresses only. International mailing is not supported.
Recipient must include name or organization (or both) in the address.
Card builder mode and raw PDF mode are mutually exclusive. Use one or the other; providing both returns an error.
Each panel is text OR image, not both. Providing both text and image for the same panel returns an error.
Front cover image is required in card builder mode. It must be a direct link to a JPG or PNG image.
For each image panel, provide either the URL or file ID, not both.
Raw PDF must be exactly 2 pages. Page 1 is the outside (front cover + back), page 2 is the inside (left + right panels).
Font auto-sizing: Text is automatically sized to fit within the panel (72px max, 18px min).
Preview files expire after 7 days. The signed URLs for document PDFs and preview images are temporary.
Text supports newlines. Use \n in text fields for line breaks.
Images are cover-cropped to fill the panel exactly (no margins, no distortion).

About The Developer

Apoth3osis

★15 stars

Joined Agent Payment: August 14, 2025

We build tools that enable AI agents to excel in the mathematical realm.

Our small team develops experimental and unique solutions in the AI arena, with a strong focus on modular computing for agentic applications and custom model deployment. We have handled projects for a variety of applications across many sectors, from algorithmic trading and financial analysis, to molecular simulations and predictions, to habitat and biodiversity monitoring and wildlife conservation.

Dependencies

3 dependencies will be automatically added when you enable this product.

Dependencies are not available to view right now.

Send a Custom Greeting Card

Description