Your agent sends real postcards and letters. You approve; we print and mail.
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Cancel an order that has not been paid yet. Paid orders can be cancelled by emailing support before they are printed.
Order id, ord_…
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Cancel an order that has not been paid yet. Paid orders can be cancelled by emailing support before they are printed.
| Argument | Type | Description |
|---|---|---|
| order_id* | string | Order id, ord_… |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "string",
"description": "Order id, ord_…"
}
}
}Create a printed letter order (8.5x11, mailed in a #10 envelope) and get a payment link. Either write it (content.body, up to ~3 pages, optional photo) or mail the user's own PDF (content.pdf_url, a public https link, up to 6 pages). Set certified to "certified" for USPS Certified Mail with tracking and proof of delivery, or "certified_return_receipt" to add the recipient's signature; use these when the user needs proof (tax notice replies, lease notices, disputes, demand letters). Or set express for USPS Priority Mail (not with certified). Prices: get_pricing. Mails only after the user pays.
| Argument | Type | Description |
|---|---|---|
| to | object | Recipient's US mailing address (or use recipients for several people) |
| from* | object | Return address; printed on the mail piece |
| content* | object | The letter: body text (optionally with a photo) or your own PDF |
| express | boolean | Send by express (USPS Priority Mail, usually 2–3 days, with tracking) for an extra charge; see get_pricing. Not available with certified. |
| certified | string | USPS Certified Mail. "certified": tracking number and proof of mailing and delivery. "certified_return_receipt": adds the recipient's signature as proof of delivery, which landlords, courts and agencies often require. "none": regular First-Class. Prices: get_pricing. |
| recipients | array | Send the same piece to several people: 2-25 US addresses, used INSTEAD of to. Each gets their own order and tracking; one payment covers all. |
| customer_email | string | Where to send the receipt and status updates |
| idempotency_key | string | Any unique string; retrying with the same key returns the original order instead of creating a duplicate |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"from",
"content"
],
"properties": {
"to": {
"type": "object",
"required": [
"name",
"line1",
"city",
"state",
"zip"
],
"properties": {
"zip": {
"type": "string",
"pattern": "^\\d{5}(-\\d{4})?$",
"description": "5-digit US ZIP code, or ZIP+4"
},
"city": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "City"
},
"name": {
"type": "string",
"maxLength": 60,
"minLength": 1,
"description": "Recipient or sender full name"
},
"line1": {
"type": "string",
"maxLength": 64,
"minLength": 3,
"description": "Street address"
},
"line2": {
"type": "string",
"maxLength": 64,
"description": "Apartment, suite, unit"
},
"state": {
"type": "string",
"description": "Two-letter US state code, e.g. NY"
},
"company": {
"type": "string",
"maxLength": 60,
"description": "Company name, printed under the person's name"
}
},
"description": "Recipient's US mailing address (or use recipients for several people)"
},
"from": {
"type": "object",
"required": [
"name",
"line1",
"city",
"state",
"zip"
],
"properties": {
"zip": {
"type": "string",
"pattern": "^\\d{5}(-\\d{4})?$",
"description": "5-digit US ZIP code, or ZIP+4"
},
"city": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "City"
},
"name": {
"type": "string",
"maxLength": 60,
"minLength": 1,
"description": "Recipient or sender full name"
},
"line1": {
"type": "string",
"maxLength": 64,
"minLength": 3,
"description": "Street address"
},
"line2": {
"type": "string",
"maxLength": 64,
"description": "Apartment, suite, unit"
},
"state": {
"type": "string",
"description": "Two-letter US state code, e.g. NY"
},
"company": {
"type": "string",
"maxLength": 60,
"description": "Company name, printed under the person's name"
}
},
"description": "Return address; printed on the mail piece"
},
"content": {
"type": "object",
"properties": {
"body": {
"type": "string",
"maxLength": 9000,
"minLength": 1,
"description": "Full letter text. Plain text; blank lines separate paragraphs. Use this OR pdf_url."
},
"font": {
"enum": [
"serif",
"sans"
],
"type": "string",
"default": "serif",
"description": "Typeface for the letter body (text letters)"
},
"color": {
"type": "boolean",
"description": "PDF letters only: print in color (costs a little more; see get_pricing). Text letters print in color automatically when they include image_url."
},
"pdf_url": {
"type": "string",
"maxLength": 2000,
"description": "Mail your own document instead of body text: a public https link to a PDF (up to 6 pages). Pages are fitted to 8.5×11 and a blank address page is added in front."
},
"image_url": {
"type": "string",
"maxLength": 2000,
"description": "Text letters only: optional photo printed at the top (https JPG or PNG). A letter with a photo prints in color, for a small surcharge (see get_pricing)."
},
"pdf_pages": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Set by Sendpaper: page count of the PDF"
}
},
"description": "The letter: body text (optionally with a photo) or your own PDF"
},
"express": {
"type": "boolean",
"default": false,
"description": "Send by express (USPS Priority Mail, usually 2–3 days, with tracking) for an extra charge; see get_pricing. Not available with certified."
},
"certified": {
"enum": [
"none",
"certified",
"certified_return_receipt"
],
"type": "string",
"default": "none",
"description": "USPS Certified Mail. \"certified\": tracking number and proof of mailing and delivery. \"certified_return_receipt\": adds the recipient's signature as proof of delivery, which landlords, courts and agencies often require. \"none\": regular First-Class. Prices: get_pricing."
},
"recipients": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"line1",
"city",
"state",
"zip"
],
"properties": {
"zip": {
"type": "string",
"pattern": "^\\d{5}(-\\d{4})?$",
"description": "5-digit US ZIP code, or ZIP+4"
},
"city": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "City"
},
"name": {
"type": "string",
"maxLength": 60,
"minLength": 1,
"description": "Recipient or sender full name"
},
"line1": {
"type": "string",
"maxLength": 64,
"minLength": 3,
"description": "Street address"
},
"line2": {
"type": "string",
"maxLength": 64,
"description": "Apartment, suite, unit"
},
"state": {
"type": "string",
"description": "Two-letter US state code, e.g. NY"
},
"company": {
"type": "string",
"maxLength": 60,
"description": "Company name, printed under the person's name"
}
}
},
"maxItems": 25,
"minItems": 2,
"description": "Send the same piece to several people: 2-25 US addresses, used INSTEAD of to. Each gets their own order and tracking; one payment covers all."
},
"customer_email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Where to send the receipt and status updates"
},
"idempotency_key": {
"type": "string",
"maxLength": 120,
"description": "Any unique string; retrying with the same key returns the original order instead of creating a duplicate"
}
}
}Create a postcard order (4x6, 6x9 or 6x11) and get a payment link. Front layouts: a big headline on a color, one photo, a photo with a caption, or a collage of 2-4 photos; the back carries the message (handwriting, serif or sans) and addresses. Set express for USPS Priority Mail (2-3 days, tracked). Mails only after the user pays.
| Argument | Type | Description |
|---|---|---|
| to | object | Recipient's US mailing address (or use recipients for several people) |
| from* | object | Return address; printed on the mail piece |
| size | string | Postcard size: 4x6, 6x9 or 6x11 (see get_pricing for prices) |
| content* | object | Front (an image URL or a headline) and the message on the back |
| express | boolean | Send by express (USPS Priority Mail, usually 2–3 days, with tracking) for an extra charge; see get_pricing. Not available with certified. |
| recipients | array | Send the same piece to several people: 2-25 US addresses, used INSTEAD of to. Each gets their own order and tracking; one payment covers all. |
| customer_email | string | Where to send the receipt and status updates |
| idempotency_key |
Get the status of a postcard or letter order by id (ord_...).
| Argument | Type | Description |
|---|---|---|
| order_id* | string | Order id, ord_… |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "string",
"description": "Order id, ord_…"
}
}
}List mail products and prices (USD, printing + USPS First-Class postage included, US addresses only).
No arguments.
{
"type": "object",
"properties": {}
}Pay for an unpaid order with a Stripe shared payment token (spt_…) the user approved, scoped to at least the order amount in USD. For an order created with recipients, this pays for the whole group at once (scope the token to batch.price). On success the order is paid and goes to print. Use only after the user approved the purchase.
| Argument | Type | Description |
|---|---|---|
| order_id* | string | Order id from create_postcard or create_letter, ord_… |
| shared_payment_token* | string | Stripe shared payment token, spt_… |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"order_id",
"shared_payment_token"
],
"properties": {
"order_id": {
"type": "string",
"description": "Order id from create_postcard or create_letter, ord_…"
},
"shared_payment_token": {
"type": "string",
"description": "Stripe shared payment token, spt_…"
}
}
}| string |
| Any unique string; retrying with the same key returns the original order instead of creating a duplicate |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"from",
"content"
],
"properties": {
"to": {
"type": "object",
"required": [
"name",
"line1",
"city",
"state",
"zip"
],
"properties": {
"zip": {
"type": "string",
"pattern": "^\\d{5}(-\\d{4})?$",
"description": "5-digit US ZIP code, or ZIP+4"
},
"city": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "City"
},
"name": {
"type": "string",
"maxLength": 60,
"minLength": 1,
"description": "Recipient or sender full name"
},
"line1": {
"type": "string",
"maxLength": 64,
"minLength": 3,
"description": "Street address"
},
"line2": {
"type": "string",
"maxLength": 64,
"description": "Apartment, suite, unit"
},
"state": {
"type": "string",
"description": "Two-letter US state code, e.g. NY"
},
"company": {
"type": "string",
"maxLength": 60,
"description": "Company name, printed under the person's name"
}
},
"description": "Recipient's US mailing address (or use recipients for several people)"
},
"from": {
"type": "object",
"required": [
"name",
"line1",
"city",
"state",
"zip"
],
"properties": {
"zip": {
"type": "string",
"pattern": "^\\d{5}(-\\d{4})?$",
"description": "5-digit US ZIP code, or ZIP+4"
},
"city": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "City"
},
"name": {
"type": "string",
"maxLength": 60,
"minLength": 1,
"description": "Recipient or sender full name"
},
"line1": {
"type": "string",
"maxLength": 64,
"minLength": 3,
"description": "Street address"
},
"line2": {
"type": "string",
"maxLength": 64,
"description": "Apartment, suite, unit"
},
"state": {
"type": "string",
"description": "Two-letter US state code, e.g. NY"
},
"company": {
"type": "string",
"maxLength": 60,
"description": "Company name, printed under the person's name"
}
},
"description": "Return address; printed on the mail piece"
},
"size": {
"enum": [
"4x6",
"6x9",
"6x11"
],
"type": "string",
"default": "4x6",
"description": "Postcard size: 4x6, 6x9 or 6x11 (see get_pricing for prices)"
},
"content": {
"type": "object",
"required": [
"message"
],
"properties": {
"layout": {
"enum": [
"headline",
"photo",
"photo_caption",
"collage"
],
"type": "string",
"description": "Front layout: headline (big text on a color), photo (one full-bleed photo), photo_caption (photo with a caption band), collage (2-4 photos). Inferred from the fields when omitted."
},
"caption": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "photo_caption: short text over a band at the bottom of the photo"
},
"message": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "The message on the back"
},
"front_theme": {
"enum": [
"ink",
"sky",
"sunset",
"forest",
"rose",
"sand",
"night",
"mint"
],
"type": "string",
"default": "ink",
"description": "headline layout: color theme (ink, sky, sunset, forest, rose, sand, night, mint)"
},
"front_images": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000
},
"maxItems": 4,
"minItems": 2,
"description": "Collage: 2 to 4 https photo URLs, laid out in a grid"
},
"message_font": {
"enum": [
"handwriting",
"serif",
"sans"
],
"type": "string",
"default": "handwriting",
"description": "Font for the message on the back"
},
"headline_font": {
"enum": [
"serif",
"sans",
"script"
],
"type": "string",
"default": "serif",
"description": "Font for the headline or caption: serif, sans or script (handwritten)"
},
"front_headline": {
"type": "string",
"maxLength": 60,
"description": "headline layout: big text for the front, e.g. 'Happy birthday, Sam!'"
},
"front_image_url": {
"type": "string",
"maxLength": 2000,
"description": "https URL of a photo or design for the front (JPG or PNG); for photo and photo_caption"
}
},
"description": "Front (an image URL or a headline) and the message on the back"
},
"express": {
"type": "boolean",
"default": false,
"description": "Send by express (USPS Priority Mail, usually 2–3 days, with tracking) for an extra charge; see get_pricing. Not available with certified."
},
"recipients": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"line1",
"city",
"state",
"zip"
],
"properties": {
"zip": {
"type": "string",
"pattern": "^\\d{5}(-\\d{4})?$",
"description": "5-digit US ZIP code, or ZIP+4"
},
"city": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "City"
},
"name": {
"type": "string",
"maxLength": 60,
"minLength": 1,
"description": "Recipient or sender full name"
},
"line1": {
"type": "string",
"maxLength": 64,
"minLength": 3,
"description": "Street address"
},
"line2": {
"type": "string",
"maxLength": 64,
"description": "Apartment, suite, unit"
},
"state": {
"type": "string",
"description": "Two-letter US state code, e.g. NY"
},
"company": {
"type": "string",
"maxLength": 60,
"description": "Company name, printed under the person's name"
}
}
},
"maxItems": 25,
"minItems": 2,
"description": "Send the same piece to several people: 2-25 US addresses, used INSTEAD of to. Each gets their own order and tracking; one payment covers all."
},
"customer_email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Where to send the receipt and status updates"
},
"idempotency_key": {
"type": "string",
"maxLength": 120,
"description": "Any unique string; retrying with the same key returns the original order instead of creating a duplicate"
}
}
}