Premier Letters

com.premierlettersPublished by premierletters.comOfficial publisherv1.0.0Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Lets an assistant quote, preview, order and track real handwritten letters, cards and postcards mailed by Premier Letters.

What you can do
The server lets an assistant get live price quotes, list handwriting styles and the user's saved templates, and render an SVG preview of a letter. It can verify and standardize US mailing addresses through USPS, create and pay for real handwritten letter orders, and check order status, tracking summaries and per-recipient delivery. It also exposes account balance and a tool to create a top-up payment link.
When to use it
Use it when someone wants to send a physical handwritten letter, card or postcard and have the assistant handle quoting, previewing, ordering and tracking. Also useful for checking a US address or comparing paper and mailing options first.
Requirements
A remote endpoint plus a Premier Letters API key in the Authorization header; get_pricing, list_handwriting_styles and verify_address work without a key. connect_account emails the user an approval link to obtain a key. Network access is required.
Before you install
create_order places and pays for a real order, charging a saved card immediately or using prepaid balance; create_topup_link produces a Stripe payment link. The Authorization header carries an API key, and poll_secret and the returned api_key are also secrets. connect_account sends an approval link to the user's email address.

Installation

In SourceWeft

  1. Open Premier Letters in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.premierletters%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "premier-letters": {
      "type": "http",
      "url": "https://www.premierletters.com/api/mcp"
    }
  }
}

Tools

12

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.

Parametersmodeemailrequiredagent_namerequired

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.

Parametersrequest_idrequiredpoll_secretrequired

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.

Parameterschar_countpaper_typeoutput_modeletter_countproduct_typemailing_optionenvelope_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.

Takes no parameters.

list_templates

List the authenticated user's saved letter templates.

Parameterssortsearchfavorites_only

verify_address

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

Parametersziprequiredcityrequiredstaterequiredaddress_line1requiredaddress_line2

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.

Parametersmessagerequiredrecipientproduct_typehandwriting_style

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.

Parametersmessagerequiredoptionspaymentrecipientsskip_invalidreturn_addressidempotency_keyno_return_address_ackreturn_address_partial_ok

get_order_status

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

Parametersorder_idrequired

list_orders

List the authenticated user's recent orders.

Parameterslimitstatus

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.

Takes no parameters.

Version history

1
  1. v1.0.0LatestSep 21, 2026

Score

72% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts

    Publish an icon in the registry entry.

  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.