# cards. for agents.

> An agent-facing facade over Postable.com. Lets an AI agent compose, preview, and hand off a real paper greeting card for a human to pay for. Mother's Day 2026 launch; v1 supports a curated set of illustrated folded Mother's Day cards to U.S. addresses only.

## What this service does

- Accepts card-sending intent from an agent via MCP or REST.
- Holds canonical order state so the agent doesn't have to.
- Drives Postable's public website (guest checkout, no account needed) via a hosted browser.
- Captures the real handwritten inside of the card from Postable's editor and renders it in a signed preview URL.
- Hands the user off to Postable's Stripe checkout to pay. We never see card numbers.

## What this service does NOT do

- Does not run an LLM on the agent's behalf. If the user wants a message drafted, the calling agent drafts it, then passes the text to `compose_message`.
- Does not store payment information.
- Does not ship photo-upload cards, bulk orders, or cards outside the Mother's Day launch catalog in v1.
- Does not provide in-transit tracking. USPS does not track stamped single-card mailings. Postable emails a confirmation with the order ID.

## Transports

- MCP (stdio + HTTP) at cards-for-agents.com under the `cards-for-agents` server namespace.
- REST at https://api.cards-for-agents.com. Same tool names become POST endpoints.

## Canonical tools

- `search_cards(query?, limit?)` — find Mother's Day cards by text.
- `get_card_details(slug)` — fetch one card.
- `create_order(occasion)` — start an order; returns `order_id`.
- `set_card(order_id, slug)` — attach a card to an order.
- `compose_message(order_id, draft | context)` — attach the user's message.
- `set_recipient(order_id, name, street, city, state, zip)` — recipient.
- `validate_recipient(order_id)` — cheap format check.
- `set_sender(order_id, name, street, city, state, zip, email)` — sender + receipt email.
- `preview_order(order_id)` — drive Postable's cart, capture the real handwritten inside, return signed preview URL + totals.
- `confirm_and_handoff(order_id)` — return Postable cart URL so the user can pay.

## Catalog

- a-great-mom — A Great Mom by E. Frances Paper
- mothers-day-flowers-5 — Mother's Day Flowers by Vine & Thistle (default)
- as-a-mom — As A Mom by Bloomwolf Studio

## Typical pricing

- Card: $5.99
- Stamp: $0.78
- Sales tax: computed from the sender's ZIP
- Typical total in California: $7.23

## Key constraints for the agent

- Always show the preview URL to the user before calling `confirm_and_handoff`. The user decides whether to place the real order.
- Ask the user for the recipient's address before calling `preview_order`. We cannot invent it.
- Ask the user what they want the card to say. If they give you context instead of text, draft the text yourself and pass it to `compose_message` as `draft`.
- Remind the user they pay Postable directly; we don't touch the card.

## Links

- Homepage: https://cards-for-agents.com
- Tool reference: https://cards-for-agents.com/tools
- Pricing: https://cards-for-agents.com/pricing
- FAQ: https://cards-for-agents.com/faq
- Partner / fulfillment: https://www.postable.com