All servers · Markets & trading · Payments & accounting · Shops & products

Premier Letters

com.premierletters/mcp · v1.0.0

Measured by MCP Station

Description written by the publisher, not verified

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

Connect

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

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

Tools as reported by the server

• 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 th
• 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.
• 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)
• 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.
• list_templates
  List the authenticated user's saved letter templates.
• verify_address
  Verify and standardize a US mailing address via USPS. Use before create_order to catch typos and get the USPS-standardized form.
• 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.
• 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
• get_order_status
  Get an order's status, delivery/tracking summary, and per-recipient mail status.
• list_orders
  List the authenticated user's recent orders.
• 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.
• 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_bala

Tool changes

• 2026-10-22: 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
• 2026-10-21: 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
• 2026-10-20: 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
• 2026-10-16: get_pricing, list_handwriting_styles, list_templates, verify_address, preview_letter, create_order, get_order_status, list_orders

Website · JSON · Text for agents · Registry updated 2026-09-21