{"id":"com.premierletters/mcp","slug":"com-premierletters-mcp","title":"Premier Letters","description":"Send real pen-written letters, cards and postcards: quote, preview, order and track by mail.","version":"1.0.0","publisher":{"kind":"domain","id":"premierletters.com","label":"premierletters.com","url":"https://premierletters.com"},"website":"https://www.premierletters.com/developers","repository":"","remotes":[{"type":"streamable-http","url":"https://www.premierletters.com/api/mcp","headers":[{"description":"Bearer <your Premier Letters API key> (create one at https://www.premierletters.com/settings/api-keys). Optional for get_pricing, list_handwriting_styles and verify_address.","isSecret":true,"name":"Authorization"}]}],"packages":[],"published":"2026-09-21","updated":"2026-09-21","status":"online","auth":"","latency_ms":951,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"connect_account","title":"","description":"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","read_only":false},{"name":"check_connection","title":"","description":"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.","read_only":false},{"name":"get_pricing","title":"","description":"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. There is no small-order fee. 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-","read_only":false},{"name":"list_handwriting_styles","title":"","description":"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.","read_only":false},{"name":"list_templates","title":"","description":"List the authenticated user's saved letter templates.","read_only":false},{"name":"verify_address","title":"","description":"Verify and standardize a US mailing address via USPS. Use before create_order to catch typos and get the USPS-standardized form.","read_only":false},{"name":"preview_letter","title":"","description":"Render a preview of a handwritten letter (as an SVG image) and get its price, before creating an order. Does not save anything.","read_only":false},{"name":"list_extras","title":"","description":"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 a","read_only":false},{"name":"create_order","title":"","description":"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 (fails with insufficient_balance when short), or \"checkout_session\" returns a checkout_url f","read_only":false},{"name":"get_order_status","title":"","description":"Get an order's status, delivery/tracking summary, and per-recipient mail status.","read_only":false},{"name":"list_orders","title":"","description":"List the authenticated user's recent orders.","read_only":false},{"name":"get_balance","title":"","description":"Get the authenticated account's prepaid balance (balance_cents) and the top-up rules: minimum and maximum top-up, bonus tiers and suggested amounts. Use create_topup_link to add funds.","read_only":false},{"name":"create_topup_link","title":"","description":"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.","read_only":false}],"server_info":{"name":"premier-letters","version":"1.0.0"},"category":"ecommerce","tags":["communication"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-09-21","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/com-premierletters-mcp/"}