Premier Letters MCP Server

by premierletters Your server? Claim it

not responding

Premier Letters is listed as active in the registry but did not answer our last check. It exposes 13 tools.

Send real pen-written letters, cards and postcards: quote, preview, order and track by mail.

Uptime history 48 days of history · worst day 0%

48 days agonow

0.0%

Uptime 24h

0 of 92 checks

Tools

read from the server

62 ms

Response time

average over 24h

open, no key

Access

streamable-http

What changed 17

Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 12 October 2026. No other catalogue keeps this.

4 Nov 2 tools changed the parameters they ask for create_order, get_pricing

4 Nov a tool appeared list_extras

4 Nov a tool description was rewritten get_pricing

22 Oct a tool description was rewritten create_order

22 Oct a tool changed the parameters it asks for create_order

20 Oct 4 tools appeared check_connection, connect_account, create_topup_link and 1 more

20 Oct 2 tool descriptions were rewritten create_order, get_pricing

20 Oct 2 tools changed the parameters they ask for create_order, get_pricing

12 Oct 2 tool descriptions were rewritten create_order, get_pricing

12 Oct a tool changed the parameters it asks for create_order

Premier Letters does not always answer

Over the last week it answered 7.5% of our checks. We check every 15 minutes, so you hear about the next outage within the hour — not from your users.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 2 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add mcp --transport http https://www.premierletters.com/api/mcp

Settings → Connectors → Add custom connector, then paste this address

https://www.premierletters.com/api/mcp

~/.codex/config.toml

[mcp_servers.mcp]
url = "https://www.premierletters.com/api/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://www.premierletters.com/api/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://www.premierletters.com/api/mcp"
    }
  }
}

Available tools 13

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

order

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.

get_order_status

Get an order's status, delivery/tracking summary, and per-recipient mail status.

balance

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.

connect

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.

connection

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.

extras

list_extras

List the extra pieces that can go in each envelope with a Premier Letters order: printed inserts, printed letters, your own inserts, flyers, postcards, business cards. Each has options, a per-unit price in cents, a lead time and a purchase mode: "instant" pieces are charged with the order, "request" pieces are priced by staff after the order is placed. Pass them as `extras` on create_order. With an API key, the account's own prices apply.

handwriting

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.

orders

list_orders

List the authenticated user's recent orders.

preview

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.

pricing

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, or facsimile for the handwriting printed on a laser printer) to quote a printed letter body instead of a pen-written one, and envelope_output_mode to quote a printed envelope.

templates

list_templates

List the authenticated user's saved letter templates.

topup

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.

verify

verify_address

Verify and standardize a US mailing address via USPS. Use before create_order to catch typos and get the USPS-standardized form.

Endpoints

URL	Transport	State	Latency	Checked
https://www.premierletters.com/api/mcp	streamable-http	answering	62 ms	2 min ago

Alternatives to Premier Letters

same job, measured the same way

Letter IRL

by letterirl

Write, preview and mail real letters and postcards to US addresses from your AI app.

answering

thanks.io

by thanks

Send real handwritten postcards, letters, notecards and gift cards, and track QR scan results.

answering

Mail by Pony

by mailbypony

Print and mail real letters through USPS. Write, preview the exact printed proof, then pay or send.

39 tools answering

Sendpaper

by ryan-tish

Your agent sends real postcards and letters. You approve; we print and mail.

6 tools answering

No Errands Mail

by noerrands

Mail real US letters, postcards and certified mail from an agent, quoted before sending.

answering

PieterPost MCP

by pieterpost-com

Design letters and cards, and prepare, review, pay for, and send letters and postcards.

answering

Paperjoy

by paperjoy

Send real handwritten postcards, written by robot pen and mailed in envelopes. Poland only.

answering

Postedly

by postedly

Letters, certified mail, postcards, fax, handwritten cards and checks; human review before payment.

answering

Premier Letters — questions

Answers built from our own checks of this server.

What can Premier Letters do?

It exposes 13 tools, read directly from the server on our last check. Among them: check_connection, connect_account, create_order, create_topup_link, get_balance, get_order_status and 7 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is Premier Letters working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 0 of 92 checks got a reply (0.0%), average response time 62 ms. The bar chart above shows every period we have measured.

The registry lists Premier Letters as active — why does it not respond?

The official MCP registry stores what the author submitted; it does not verify that the server still runs. We check the endpoint ourselves, and this one does not answer. Catalogues that copy the registry without checking will show it as working.

How do I connect Premier Letters?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Premier Letters need an API key?

No. Premier Letters completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 13 of them are readable on this page. This is what we observed, not what the docs claim.