Skip to main content

​
create_postcard

​
string
default:"4x6"
4x6 or 6x9.
​
Address
required
Recipient: name, line1, optional line2, city, two-letter state, zip. US only.
​
Address
required
Return address, printed on the card.
​
string
https URL of a JPG or PNG. Use this or front_headline.
​
string
Up to 60 characters of big text for a text-only front, with front_theme: ink, sky, sunset or forest.
​
string
required
The message on the back, up to 600 characters.
​
string
Any unique string; a retry with the same key returns the original order.

​
create_letter

Same to, from and idempotency_key, plus:
​
string
required
Plain text, blank lines between paragraphs, up to about 3 pages.
​
string
default:"serif"
serif or sans.

​
pay_order

​
string
required
The order to pay (ord_…).
​
string
required
A Stripe shared payment token (spt_…) scoped to at least the order amount in USD.

​
What the agent gets back

Both create tools return a sentence telling the agent what to do next, followed by the order as JSON:
The server also sends instructions at connection time telling the agent to confirm addresses and wording with the user before creating an order.