Premier Letters
Send real pen-written letters, cards and postcards: quote, preview, order and track by mail.
| Endpoint | https://www.premierletters.com/api/mcp (streamable-http) |
|---|---|
| Registry version | 1.0.0 |
| Now | 12 tools · grade B (82) · pin ts_1ba18dc76bd607e22b2ce107688e7848 · protocol 2025-06-18 |
| First / last listed | 2026-10-25 01:57 UTC / 2026-10-25 01:57 UTC |
| Grade over time | 2026-10-25: B (82), 12 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: connect_account check_connection get_pricing list_handwriting_styles list_templates verify_address preview_letter create_order get_order_status list_orders get_balance create_topup_link
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 appro params: email*, agent_name*, mode |
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. params: request_id*, poll_secret* |
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 params: char_count, letter_count, mailing_option, paper_type, product_type, output_mode, envelope_output_mode |
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. params: none |
list_templates | List the authenticated user's saved letter templates. params: search, favorites_only, sort |
verify_address | Verify and standardize a US mailing address via USPS. Use before create_order to catch typos and get the USPS-standardized form. params: address_line1*, address_line2, city*, state*, zip* |
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. params: message*, handwriting_style, product_type, recipient |
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_sess params: message*, recipients, options, payment, skip_invalid, return_address, return_address_partial_ok, no_return_address_ack, idempotency_key |
get_order_status | Get an order's status, delivery/tracking summary, and per-recipient mail status. params: order_id* |
list_orders | List the authenticated user's recent orders. params: limit, status |
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. params: none |
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. params: amount_cents* |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.