Official MCP RegistryListed
Premier Letters
Send real pen-written letters, cards and postcards: quote, preview, order and track by mail.
First seen 2 Oct 2026. Evidence as of 27 Oct 2026.
12
Tools
From an anonymous probe
1
Source listings
Each with its own history
15
Recorded changes
Since first seen
Tools
| Tool | Description | Behaviour |
|---|---|---|
| check_connection | Check whether the user approved a connect_account request. Returns status pending, denied, expired or claimed, or, exactly once, status approved with the api_key. Poll every 10-30 seconds. | Not declared |
| connect_account | Get a Premier Letters API key without the user copying one by hand. Pass the user's email and your name; we email them a link to approve (they can sign up from it if they have no account). Then call check_connection with the returned request_id and poll_secret every 10-30 seconds until it returns the api_key (returned once). Show the returned user_code to the user so they can match it on the approval page. No account or key needed to call this. | Not declared |
| create_order | Create and pay for a Premier Letters order — a real, handwritten letter mailed via USPS. Requires a Premier Letters API key. Use get_pricing or preview_letter first to confirm the price. For payment, "card_on_file" charges the caller's saved card immediately, "balance" pays from the prepaid account balance (no small-order handling fee; fails with insufficient_balance when short), or "checkout_session" returns a checkout_url for the human to complete payment in a browser. Envelope return address: an explicit no_return_address_ack: true always wins; otherwise a supplied return_address, else the account default. With neither address, set no_return_address_ack: true to send without one. | Not declared |
| create_topup_link | Create a Stripe Checkout link that adds prepaid credit (plus any bonus tier) to the authenticated account. Give checkout_url to the human to pay in a browser; the balance updates once they pay (check with get_balance). amount_cents must be a whole number between min_cents and max_cents from get_balance. | Not declared |
| get_balance | Get the authenticated account's prepaid balance (balance_cents) and the top-up rules: minimum and maximum top-up, bonus tiers and suggested amounts. Orders paid with payment.method "balance" skip the small-order handling fee. Use create_topup_link to add funds. | Not declared |
| get_order_status | Get an order's status, delivery/tracking summary, and per-recipient mail status. | Not declared |
| get_pricing | Get a live price quote for a Premier Letters order. Pass char_count (or letter_count for a rough estimate) plus optional mailing_option and paper_type to get a per-piece and total price, in cents. No account needed. Orders under 5 pieces carry a $0.99 per-piece handling fee (included in total_cents), waived when paid from a prepaid balance. Pass output_mode (printed_bw / printed_color) to quote a printed letter body instead of a pen-written one, and envelope_output_mode to quote a printed envelope. | Not declared |
| list_handwriting_styles | List available handwriting styles (fonts) for a letter order. Use the returned "id" as options.handwriting_style / handwriting_style when creating an order or previewing. | Not declared |
| list_orders | List the authenticated user's recent orders. | Not declared |
| list_templates | List the authenticated user's saved letter templates. | Not declared |
| preview_letter | Render a preview of a handwritten letter (as an SVG image) and get its price, before creating an order. Does not save anything. | Not declared |
| verify_address | Verify and standardize a US mailing address via USPS. Use before create_order to catch typos and get the USPS-standardized form. | Not declared |
Change history
- create_order: input schema changed
- create_order: description changed (+"return address: an explicit no_return_address_ack: true always wins;" +"a supplied return_address, else" +"account default. With neither address,")
- create_order: input schema changed (+return_address_partial_ok)
- get_pricing: input schema changed (+envelope_output_mode, +output_mode)
- get_pricing: description changed (+"Pass output_mode (printed_bw / printed_color) to quote a printed letter body instead of a pen-written one, and envelope_output_mode to quote a printed envelope.")
- get_balance: tool added
- create_topup_link: tool added
- create_order: input schema changed (+no_return_address_ack, +return_address)
- create_order: description changed (+"Envelope orders use return_address if given, otherwise the account's default return address; with neither, set no_return_address_ack: true to send without one.")
- connect_account: tool added
- check_connection: tool added
- server instructions changed (+"(or prints them, if asked)" +"get_pricing, list_handwriting_styles, verify_address, connect_account" +"check_connection work without")
- get_pricing: description changed (+"Orders under 5 pieces carry a $0.99 per-piece handling fee (included in total_cents), waived when paid from a prepaid balance.")
- create_order: input schema changed
- create_order: description changed (+""balance" pays from the prepaid account balance (no small-order handling fee; fails with insufficient_balance when short)," -"either")
| Source | Listing | First seen | Last seen | Versions |
|---|---|---|---|---|
| Official MCP Registry | com.premierletters/mcp | 2 Oct 2026 | 27 Oct 2026 | 1 |