Premier Letters
by premierletters.com · remote · no sign-in to list tools · v1.0.0 · published by com.premierletters
Send real pen-written letters, cards and postcards: quote, preview, order and track by mail.
Final · 1Changes · 3
12 tools: 1 do something that can't be undone, 3 change things and 8 only read.
Scanned Oct 21, 2026
- Deletes or cancels0Claude Code: deny
- Can't be undone1Claude Code: ask: see these tools
- Changes things3Claude Code: ask: see these tools
- Only reads8Claude Code: allow: see these tools
No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http premierletters https://www.premierletters.com/api/mcpTools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
12 tools
Can't be undone 1Claude Code: ask
create_orderCreate and pay for a Premier Letters order — a real, handwritten letter mailed via USPS.No findings
Why it is in this group
- The name "create_order" says "create": a word for a change.
- The input addresses people (input.recipients): what it sends cannot be taken back.
Description, as the server wrote it 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.
Changes things 3Claude Code: ask
check_connectionCheck whether the user approved a connect_account request.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
Description, as the server wrote it 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.
create_topup_linkCreate a Stripe Checkout link that adds prepaid credit (plus any bonus tier) to the authenticated account.No findings
Why it is in this group
- The name "create_topup_link" says "create": a word for a change.
Description, as the server wrote it 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_addressVerify and standardize a US mailing address via USPS.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
Description, as the server wrote it Verify and standardize a US mailing address via USPS. Use before create_order to catch typos and get the USPS-standardized form.
Only reads 8Claude Code: allow
connect_accountGet a Premier Letters API key without the user copying one by hand.No findings
Why it is in this group
- The description's first verb is "get": a word for reading.
Description, as the server wrote it 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.
get_balanceGet the authenticated account's prepaid balance (balance_cents) and the top-up rules: minimum and maximum top-up, bonus tiers and suggested amounts.No findings
Why it is in this group
- The name "get_balance" says "get": a word for reading.
Description, as the server wrote it 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.
get_order_statusGet an order's status, delivery/tracking summary, and per-recipient mail status.No findings
Why it is in this group
- The name "get_order_status" says "get": a word for reading.
Description, as the server wrote it Get an order's status, delivery/tracking summary, and per-recipient mail status.
get_pricingGet a live price quote for a Premier Letters order.No findings
Why it is in this group
- The name "get_pricing" says "get": a word for reading.
Description, as the server wrote it 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.
list_handwriting_stylesList available handwriting styles (fonts) for a letter order.No findings
Why it is in this group
- The name "list_handwriting_styles" says "list": a word for reading.
Description, as the server wrote it 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.
list_ordersList the authenticated user's recent orders.No findings
Why it is in this group
- The name "list_orders" says "list": a word for reading.
Description, as the server wrote it List the authenticated user's recent orders.
list_templatesList the authenticated user's saved letter templates.No findings
Why it is in this group
- The name "list_templates" says "list": a word for reading.
Description, as the server wrote it List the authenticated user's saved letter templates.
preview_letterRender a preview of a handwritten letter (as an SVG image) and get its price, before creating an order.No findings
Why it is in this group
- The name "preview_letter" says "preview": a word for reading.
Description, as the server wrote it Render a preview of a handwritten letter (as an SVG image) and get its price, before creating an order. Does not save anything.
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Install
Pinned to version 1.0.0. Values in angle brackets are yours to fill in.
claude mcp add --transport http premierletters https://www.premierletters.com/api/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__premierletters__connect_account",
"mcp__premierletters__get_pricing",
"mcp__premierletters__list_handwriting_styles",
"mcp__premierletters__list_templates",
"mcp__premierletters__preview_letter",
"mcp__premierletters__get_order_status",
"mcp__premierletters__list_orders",
"mcp__premierletters__get_balance"
],
"ask": [
"mcp__premierletters__check_connection",
"mcp__premierletters__verify_address",
"mcp__premierletters__create_order",
"mcp__premierletters__create_topup_link"
],
"deny": []
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as premierletters. Review it before you use it.