{"data":{"name":"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","websiteUrl":"https://www.premierletters.com/developers","repositoryUrl":null,"remotes":[{"url":"https://www.premierletters.com/api/mcp","type":"streamable-http","headers":[{"name":"Authorization","isSecret":true,"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."}]}],"packages":[],"status":"active","isLatest":true,"publishedAt":"2026-09-21T02:46:52.606Z","updatedAt":"2026-09-21T02:46:52.606Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"stars":null,"title":"Premier Letters","source":"official-registry","sourceId":"com.premierletters/mcp","updatedAt":"2026-09-21T02:46:52.606Z","confidence":100,"websiteUrl":"https://www.premierletters.com/developers","description":"Send real pen-written letters, cards and postcards: quote, preview, order and track by mail.","verification":"official","repositoryUrl":null}],"toolIndex":{"tools":[{"serverName":"com.premierletters/mcp","endpointFingerprint":"ec02e8ac8ba28afe545f053c7943dab08aeab9855191aa09dd94de86b3b642df","name":"check_connection","title":null,"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.","inputSchema":{"type":"object","properties":{"request_id":{"type":"string","description":"request_id from connect_account."},"poll_secret":{"type":"string","description":"poll_secret from connect_account."}},"required":["request_id","poll_secret"]},"annotations":null,"definitionHash":"efeb026a168587832ce1ffadeebd29d80a11ad57886226d1591369f3ac80a0dc","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:47:06.317Z","metadataTrust":"untrusted"},{"serverName":"com.premierletters/mcp","endpointFingerprint":"ec02e8ac8ba28afe545f053c7943dab08aeab9855191aa09dd94de86b3b642df","name":"connect_account","title":null,"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 approval page. No account or key needed to call this.","inputSchema":{"type":"object","properties":{"email":{"type":"string","description":"The account owner's email address. The approval link is sent here."},"agent_name":{"type":"string","description":"Your name as the user will see it, 1-80 characters: letters, digits, spaces and . , ' & ( ) - _ only (no links), e.g. \"Claude\"."},"mode":{"type":"string","enum":["live","test"],"description":"Key mode. Defaults to \"live\"."}},"required":["email","agent_name"]},"annotations":null,"definitionHash":"c1bc6119699fcf1f679fa50e20e91bf86fcd2b12b8ac8d477def28eae0de96d3","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:47:06.317Z","metadataTrust":"untrusted"},{"serverName":"com.premierletters/mcp","endpointFingerprint":"ec02e8ac8ba28afe545f053c7943dab08aeab9855191aa09dd94de86b3b642df","name":"create_order","title":null,"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 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.","inputSchema":{"type":"object","properties":{"message":{"type":"string","description":"The letter text. Supports {{first_name}}, {{last_name}}, {{greeting}} merge fields per-recipient."},"recipients":{"type":"array","description":"One or more recipients. At least one is required unless options.product_type is a letter/card with no envelope.","items":{"type":"object","properties":{"first_name":{"type":"string"},"last_name":{"type":"string"},"address_line1":{"type":"string"},"address_line2":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"zip":{"type":"string"},"custom_fields":{"type":"object"}}}},"options":{"type":"object","description":"handwriting_style, paper_type, product_type, mailing_option, authenticity_preset, include_letter, include_envelope, copies, output_mode (\"handwritten\" default; \"facsimile\" prints the handwriting on a laser printer; \"printed_bw\" / \"printed_color\" print typed text) and envelope_output_mode (null default = hand-addressed, or \"facsimile\" / \"printed_bw\" / \"printed_color\") — see /openapi.json for the full field list."},"payment":{"type":"object","properties":{"method":{"type":"string","enum":["card_on_file","checkout_session","balance"],"description":"Defaults to \"checkout_session\"."},"return_url":{"type":"string"}}},"skip_invalid":{"type":"boolean","description":"When true, invalid recipients are skipped instead of failing the whole order."},"return_address":{"type":"object","description":"Return address written on the envelope. Omit to use the account's default return address. Required unless the account has a default or no_return_address_ack is true. An explicit no_return_address_ack: true always wins; otherwise a supplied return_address, else the account default. name, address_line1, city, state and zip are required unless return_address_partial_ok is true.","properties":{"name":{"type":"string"},"company":{"type":"string"},"address_line1":{"type":"string"},"address_line2":{"type":"string"},"city":{"type":"string"},"state":{"type":"string","description":"2-letter US state code."},"zip":{"type":"string","description":"5-digit ZIP or ZIP+4."}}},"return_address_partial_ok":{"type":"boolean","description":"Send return_address exactly as written although it is incomplete: at least one of name, company, address_line1, city, state, zip. Only the filled lines print (a name alone is fine). Without it an incomplete return_address is refused."},"no_return_address_ack":{"type":"boolean","description":"Send with no return address at all. An explicit no_return_address_ack: true always wins; otherwise a supplied return_address, else the account default. Undeliverable mail is then destroyed."},"idempotency_key":{"type":"string","description":"Client-supplied key (1–255 chars). Repeating a call with the same key returns the original order instead of creating a second one. Always set this when you might retry."},"mailing":{"type":"object","description":"Optional: a built mailing instead of piecing together options + extras. Either a tier {\"tier\":\"essential\"} (luxe = pen letter + pen envelope; signature = pen-addressed envelope, printed-handwriting letter; essential = printed handwriting throughout; print = printed type) or a full mailing: {\"tier\":\"signature\",\"main\":{\"format\":\"card\",\"size\":\"card\",\"design\":\"thank_you\"},\"contents\":[{\"item\":\"business_card\",\"qty\":1}],\"addons\":[{\"id\":\"foil_seal\"}],\"envelopeStock\":\"premium_cream\"}. It sets product_type, output modes, paper, envelope and mailing_option, and adds its pieces to extras. Price it first with get_pricing (same mailing). Item ids: /llms-full.txt \"Build a mailing\"."},"extras":{"type":"array","description":"Optional extra pieces for each envelope (printed insert, printed letter, your own insert, flyer, business card…). Call list_extras for pieces, options and prices. \"instant\" pieces are charged with the order; \"request\" pieces are priced by staff afterwards and cost nothing now.","items":{"type":"object","properties":{"piece":{"type":"string","description":"Piece key from list_extras."},"options":{"type":"object","description":"Option choices, e.g. { \"size\": \"small\", \"color\": \"bw\" }. Omitted options take the first choice."},"quantity":{"type":"integer","minimum":1,"description":"Per recipient (default) or in total when scope is \"flat\". Default 1."},"scope":{"type":"string","enum":["per_recipient","flat"]},"artwork_url":{"type":"string","description":"https URL of print-ready artwork (PDF/PNG/JPEG). Required for instant printed pieces."},"note":{"type":"string","description":"Anything staff should know about this piece."},"role":{"type":"string","enum":["pen_stock"],"description":"Write the handwritten letter ON this printed piece (printed letter, letter flyer, 4x6 postcard). Needs a pen-written letter of the matching product type."}},"required":["piece"]}}},"required":["message"]},"annotations":null,"definitionHash":"11d77e60071ec4541a83018c6b6e3ea9d212b17cadd9e25968024f9cb2a42bc1","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:47:06.317Z","metadataTrust":"untrusted"},{"serverName":"com.premierletters/mcp","endpointFingerprint":"ec02e8ac8ba28afe545f053c7943dab08aeab9855191aa09dd94de86b3b642df","name":"create_topup_link","title":null,"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.","inputSchema":{"type":"object","properties":{"amount_cents":{"type":"integer","description":"Amount to add, in cents (e.g. 5000 for $50.00)."}},"required":["amount_cents"]},"annotations":null,"definitionHash":"df2b25e2df91df22675e36b5f3d3afb65dcaee776d3aeeeaffb2d4a0df68e4ae","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:47:06.317Z","metadataTrust":"untrusted"},{"serverName":"com.premierletters/mcp","endpointFingerprint":"ec02e8ac8ba28afe545f053c7943dab08aeab9855191aa09dd94de86b3b642df","name":"get_balance","title":null,"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.","inputSchema":{"type":"object","properties":{}},"annotations":null,"definitionHash":"c0ca5e5d29556ab78c4c1a786ec4418452ceab6d648b8c1cdceda32176647bd5","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:47:06.317Z","metadataTrust":"untrusted"},{"serverName":"com.premierletters/mcp","endpointFingerprint":"ec02e8ac8ba28afe545f053c7943dab08aeab9855191aa09dd94de86b3b642df","name":"get_order_status","title":null,"description":"Get an order's status, delivery/tracking summary, and per-recipient mail status.","inputSchema":{"type":"object","properties":{"order_id":{"type":"string","description":"The order UUID returned by create_order."}},"required":["order_id"]},"annotations":null,"definitionHash":"1f08379c7b0d1bcab88c7b799b3941eb578902f0bd256aa1362f6790aae334fb","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:47:06.317Z","metadataTrust":"untrusted"},{"serverName":"com.premierletters/mcp","endpointFingerprint":"ec02e8ac8ba28afe545f053c7943dab08aeab9855191aa09dd94de86b3b642df","name":"get_pricing","title":null,"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-written one, and envelope_output_mode to quote a printed envelope. Or pass tier (luxe = letter and envelope written with a real pen; signature = pen-addressed envelope with a printed-handwriting letter; essential = printed handwriting throughout; print = printed type) and/or mailing (a whole built mailing: contents such as coupons, flyers, business cards; add-ons such as wax seals or QR codes; paper and envelope stock) to price it line by line. Every response lists the tiers with their per-piece price.","inputSchema":{"type":"object","properties":{"char_count":{"type":"number","description":"Length of the letter message in characters. Longer letters cost more (character meter)."},"letter_count":{"type":"number","description":"Number of recipients / pieces. Defaults to 1."},"mailing_option":{"type":"string","enum":["we_mail","you_mail_stamped","you_mail_no_stamp"],"description":"Delivery option. Defaults to \"we_mail\" (we write, stamp, and mail it for you)."},"paper_type":{"type":"string","enum":["standard","premium_white","premium"],"description":"Letter paper stock. \"standard\" = white page (included), \"premium_white\" = premium white page, \"premium\" = premium cream page. Defaults to \"standard\". The response carries each stock's exact spec sheet (brand, item number, weight, thickness, brightness)."},"sheet_count":{"type":"number","description":"Sheets the letter runs to (preview_letter returns page_count). Long letters on heavier paper can pass 1 oz; every ounce over 1 adds the USPS extra-ounce rate when we mail it. Defaults to 1."},"envelope_stock":{"type":"string","enum":["standard","premium_white","premium_cream"],"description":"Envelope stock: \"standard\" (white, included), \"premium_white\" or \"premium_cream\". Defaults to \"standard\". Ignored for postcards."},"product_type":{"type":"string","enum":["letter","card","a7","postcard","card_5x7","postcard_5x7","a4","a5","a6"],"description":"Product type (letter, card, postcard, etc). Informational only — does not change pricing components beyond envelope inclusion."},"output_mode":{"type":"string","enum":["handwritten","facsimile","printed_bw","printed_color"],"description":"Defaults to \"handwritten\". facsimile prints the handwriting layout on a laser printer; printed_bw / printed_color print typed text. The envelope stays hand-addressed unless envelope_output_mode is set."},"envelope_output_mode":{"type":"string","enum":["facsimile","printed_bw","printed_color"],"description":"Omit (or null) for a hand-addressed envelope, the default. facsimile prints the handwritten addressing; printed_bw / printed_color print typed addressing."},"tier":{"type":"string","enum":["luxe","signature","essential","print"],"description":"Price a tier: luxe (Letter and envelope written with a real pen); signature (A real pen on the envelope, printed handwriting inside); essential (Printed handwriting, letter and envelope); print (Clean printed type)."},"mailing":{"type":"object","description":"A built mailing (same shape as the mailing field on create_order). Example: {\"tier\":\"signature\",\"contents\":[{\"item\":\"coupon\",\"qty\":1}],\"addons\":[{\"id\":\"wax_seal\"}]}. See /llms-full.txt \"Build a mailing\" for every item id."}}},"annotations":null,"definitionHash":"7737754368e092fcc900758d476605c819f990ccf6f6af52de2e846f993188d1","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:47:06.317Z","metadataTrust":"untrusted"},{"serverName":"com.premierletters/mcp","endpointFingerprint":"ec02e8ac8ba28afe545f053c7943dab08aeab9855191aa09dd94de86b3b642df","name":"list_extras","title":null,"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 an API key, the account's own prices apply.","inputSchema":{"type":"object","properties":{}},"annotations":null,"definitionHash":"118fc8df428fc9e3510a8b5faaeefbf1c270e87dc43c6ffe46fe3c3f562f6069","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:47:06.317Z","metadataTrust":"untrusted"},{"serverName":"com.premierletters/mcp","endpointFingerprint":"ec02e8ac8ba28afe545f053c7943dab08aeab9855191aa09dd94de86b3b642df","name":"list_handwriting_styles","title":null,"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.","inputSchema":{"type":"object","properties":{}},"annotations":null,"definitionHash":"1d344e40cc8a684c898748fdc2e57832654d4cfad9d9f28ac8c5a79e336302a7","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:47:06.317Z","metadataTrust":"untrusted"},{"serverName":"com.premierletters/mcp","endpointFingerprint":"ec02e8ac8ba28afe545f053c7943dab08aeab9855191aa09dd94de86b3b642df","name":"list_orders","title":null,"description":"List the authenticated user's recent orders.","inputSchema":{"type":"object","properties":{"limit":{"type":"number","description":"Max orders to return (1-100). Defaults to 20."},"status":{"type":"string","description":"Optional status filter (pending_payment, paid, in_production, mailed, delivered, cancelled, refunded)."}}},"annotations":null,"definitionHash":"538b3e8bd014fd20d8ce09c3f61e965f4ba1aa0eb73d7f665abe0f683b635476","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:47:06.317Z","metadataTrust":"untrusted"},{"serverName":"com.premierletters/mcp","endpointFingerprint":"ec02e8ac8ba28afe545f053c7943dab08aeab9855191aa09dd94de86b3b642df","name":"list_templates","title":null,"description":"List the authenticated user's saved letter templates.","inputSchema":{"type":"object","properties":{"search":{"type":"string","description":"Filter templates by name or content substring."},"favorites_only":{"type":"boolean","description":"Only return favorited templates."},"sort":{"type":"string","enum":["recent","most_used","name"],"description":"Sort order. Defaults to \"recent\"."}}},"annotations":null,"definitionHash":"a3d77e251deff12c4dc1234e765aff3e4403321980994c43133211e63fb676b3","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:47:06.317Z","metadataTrust":"untrusted"},{"serverName":"com.premierletters/mcp","endpointFingerprint":"ec02e8ac8ba28afe545f053c7943dab08aeab9855191aa09dd94de86b3b642df","name":"preview_letter","title":null,"description":"Render a preview of a handwritten letter (as an SVG image) and get its price, before creating an order. Does not save anything.","inputSchema":{"type":"object","properties":{"message":{"type":"string","description":"The letter text to render."},"handwriting_style":{"type":"string","description":"Font UUID from list_handwriting_styles. Defaults to the house font."},"product_type":{"type":"string","description":"Product slug: letter, card, postcard, etc. Defaults to \"letter\"."},"recipient":{"type":"object","description":"Optional recipient info, used only to personalize {{merge fields}} in the message before rendering.","properties":{"first_name":{"type":"string"},"last_name":{"type":"string"}}}},"required":["message"]},"annotations":null,"definitionHash":"eab63709c80f8c12eae7f5e80f638e814cb6e305db3625e1e8a88d1714f32ce1","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:47:06.317Z","metadataTrust":"untrusted"},{"serverName":"com.premierletters/mcp","endpointFingerprint":"ec02e8ac8ba28afe545f053c7943dab08aeab9855191aa09dd94de86b3b642df","name":"verify_address","title":null,"description":"Verify and standardize a US mailing address via USPS. Use before create_order to catch typos and get the USPS-standardized form.","inputSchema":{"type":"object","properties":{"address_line1":{"type":"string","description":"Street address"},"address_line2":{"type":"string","description":"Apt/suite/unit (optional)"},"city":{"type":"string"},"state":{"type":"string","description":"Two-letter US state code"},"zip":{"type":"string","description":"5-digit or ZIP+4 postal code"}},"required":["address_line1","city","state","zip"]},"annotations":null,"definitionHash":"59e8a7657300c07d29a6fe35b2d84bee087b50b37fc2577fd633ed515d3ec7e7","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:47:06.317Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"ec02e8ac8ba28afe545f053c7943dab08aeab9855191aa09dd94de86b3b642df","protocol":"streamable-http","status":"indexed","toolCount":13,"observedAt":"2026-11-16T18:47:06.317Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"com.premierletters/mcp":{"url":"https://www.premierletters.com/api/mcp"}}},"Cursor":{"mcpServers":{"com.premierletters/mcp":{"url":"https://www.premierletters.com/api/mcp"}}},"VS Code":{"servers":{"com.premierletters/mcp":{"type":"http","url":"https://www.premierletters.com/api/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://www.premierletters.com/api/mcp"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:com.premierletters%2Fmcp","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/com.premierletters%2Fmcp","name":"com.premierletters/mcp","description":"Send real pen-written letters, cards and postcards: quote, preview, order and track by mail.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://www.premierletters.com/api/mcp"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":"https://www.premierletters.com/developers","repositoryUrl":null,"version":"1.0.0"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"com.premierletters/mcp","status":"online","lastCheckedAt":"2026-11-20T07:17:12.857Z","lastSuccessfulCheck":"2026-11-20T07:17:12.857Z","latencyMs":172,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T07:17:12.857Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T07:17:12.857Z"},"security":null,"timestamps":{"createdAt":"2026-09-21T02:46:52.606Z","updatedAt":"2026-09-21T02:46:52.606Z","observedAt":"2026-11-20T07:17:12.857Z"},"compatibility":{"serverVersion":"1.0.0","protocolVersions":[{"protocol":"mcp","version":null}]}}}}