Preview a letter
quote_and_preview_letterPreview a text-only physical letter draft. Requires a real U.S. recipient mailing address and text that fits the text-only letter limit. Its answer says what sending it takes and when the mail usually arrives. A letter too long for one page runs on to a second or third page, printed on both sides and paid with Pay & Send; three pages is the longest. Only when the person asks for USPS Certified Mail (it costs more), pass mailService "certified"; "certified_return_receipt" adds an electronic return receipt. Certified mail is paid with Pay & Send, never a letter pack or a gift letter, and a new preview of a certified letter must pass mailService again. The person sends it on the page request_send links to: call request_send and give the person its link.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"recipient": "<recipient>",
"bodyText": "<bodyText>",
"signOff": "<signOff>"
},
"name": "quote_and_preview_letter"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sender | No | ||
| signOff | Yes | ||
| arriveBy | No | Optional. The date the mail should arrive by, YYYY-MM-DD, such as a birthday or an event. Letter IRL holds the mail and sends it to the printer in time; USPS does not guarantee First-Class dates. Omit it to mail as soon as possible. | |
| bodyText | Yes | ||
| headline | No | Optional, for the celebration stationery only: a short line printed large above the letter, such as "Happy Birthday, Sam!". It must fit on one line, and takes three of the page's lines; leave it out for confetti alone. | |
| monogram | No | Optional, for the monogram stationery only: the initials to print, one to three letters, such as "JMS". Leave it out to use the initials of the return address's name. | |
| recipient | Yes | ||
| signature | No | Optional. Whether the letter prints the person's saved signature under the sign-off's first line (set_signature saves one). Left out, the person's last choice: on once a signature is saved. True with none saved is refused. Pass false to leave it off. | |
| sendAsGift | No | Set true only when the user asks to send this as their gift letter: it is free and adds a printed page with a card for the recipient. Leave it out otherwise; a gift letter is then used only if the balance cannot pay. | |
| stationery | No | Optional. The letter's stationery: classic, a plain page; monogram, initials in a ring; botanical, a line-drawn sprig; celebration, confetti with an optional headline; typewriter, the letter typed in a monospace face, which fits fewer words on the page; or handwritten, the letter in a handwriting face on faint ruled lines, which has no Greek, Hebrew or Vietnamese. Each but classic prints the date at the top right. Left out, the letter is in the account's last choice, or classic if it has none. Leave it out unless the user asks for a style or for a plain page (classic), or names an occasion a style suits. | |
| mailService | No | Optional. How the letter travels: standard (the default), certified (USPS Certified Mail, which gives a tracking number), or certified_return_receipt (Certified Mail with an electronic return receipt). Certified mail costs more and is paid with Pay & Send: no letter pack and no gift letter pays for it. Leave it out for an ordinary letter. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pages | No | Present only for a letter of more than one page: the pages it prints on, both sides of the paper. No letter pack or gift letter pays for it; it is paid with Pay & Send. | |
| draftId | Yes | ||
| giftCard | No | ||
| schedule | No | ||
| signature | No | While signatures are offered: whether the letter prints the person's saved signature, and why | |
| canSendNow | Yes | ||
| layoutType | Yes | ||
| stationery | No | While stationery is offered: the stationery the page was drawn in, with the date line, initials and headline it prints, and why: asked for, the account's last choice, or classic by default | |
| mailService | No | Present only when the letter goes as certified mail: certified, or certified_return_receipt (with an electronic return receipt). Paid with Pay & Send. | |
| wordsVersion | No | While a letter's words can be changed in place: the version of the letter's words, which set_letter_words takes to say which words it replaces | |
| arrivalWindow | No | The arrival dates that can be chosen now: what can be scheduled, not when this mail arrives | |
| deliveryClass | No | ||
| contentVersion | No | The version of this mail as it is now: send it with the send, so what is mailed is what the person saw | |
| draftExpiresAt | Yes | ||
| addressWarnings | No | ||
| lettersRequired | Yes | ||
| sendEligibility | Yes | ||
| deliveryEstimate | No | ||
| reasonCannotSend | No | ||
| deliveryDisclaimer | No | ||
| giftLettersAvailable | No | ||
| estimatedDeliveryDays | No | ||
| savedReturnAddressNote | No | ||
| usedSavedReturnAddress | No | ||
| senderAddressValidation | No | ||
| recipientAddressValidation | No |