Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "premierletters": {
      "type": "http",
      "url": "https://www.premierletters.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${PREMIERLETTERS_TOKEN}"
      }
    }
  }
}

claude mcp add --transport http premierletters https://www.premierletters.com/api/mcp --header "Authorization: Bearer ${PREMIERLETTERS_TOKEN}"

[mcp_servers.premierletters]
url = "https://www.premierletters.com/api/mcp"
bearer_token_env_var = "PREMIERLETTERS_TOKEN"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "premierletters": {
      "type": "remote",
      "url": "https://www.premierletters.com/api/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:PREMIERLETTERS_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "premierletters": {
      "type": "http",
      "url": "https://www.premierletters.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${PREMIERLETTERS_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=premierletters&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vd3d3LnByZW1pZXJsZXR0ZXJzLmNvbS9hcGkvbWNwIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyICR7UFJFTUlFUkxFVFRFUlNfVE9LRU59In19"
}

{
  "servers": {
    "premierletters": {
      "type": "http",
      "url": "https://www.premierletters.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${PREMIERLETTERS_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "premierletters": {
      "httpUrl": "https://www.premierletters.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${PREMIERLETTERS_TOKEN}"
      }
    }
  }
}

extensions:
  "premierletters":
    enabled: true
    name: "premierletters"
    type: streamable_http
    uri: "https://www.premierletters.com/api/mcp"
    headers:
      "Authorization": "Bearer ${PREMIERLETTERS_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${PREMIERLETTERS_TOKEN}. The registry never accepts secret values.

Quality 73 / 100needs work

protocol75 · weight 25

warn
protocol.modernnewest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
n/a
protocol.statelessonly applies to 2026-07-28 servers
pass
protocol.transportstreamable HTTP
n/a
protocol.list_ttlonly applies to 2026-07-28 servers

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene71 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
fail
tools.annotationsno tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
fail
tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: list_templates (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_order_status (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_balance (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
pass
tools.token_costabout 2,363 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability75 · weight 15

warn
stability.changes8 tool changes in 30 days
pass
stability.rug_pullno tool changed its meaning under the same name

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

12 tools, about 2,363 tokens to load them all · tool set 8f0d2552b549 · tools last changed 2026-10-19 · checked 2026-10-20 05:45 UTC

Tool changes

2026-10-19create_topup_linkadded
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.
2026-10-19get_balanceadded
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.
2026-10-19create_orderchangeddescription, input schema
before
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.
after · 80% of words in common
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 orders use return_address if given, otherwise the account's default return address; with neither, set no_return_address_ack: true to send without one.
2026-10-19get_pricingchangeddescription, input schema
before
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.
after · 80% of words in common
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.
2026-10-19check_connectionadded
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.
2026-10-19connect_accountadded
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.
2026-10-11create_orderchangeddescription, input schema
before
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, either "card_on_file" charges the caller's saved card immediately, or "checkout_session" returns a checkout_url for the human to complete payment in a browser.
after · 75% of words in common
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.
2026-10-11get_pricingchangeddescription
before
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.
after · 67% of words in common
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.

Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 83 / 100

no-repository

provenance55

liveness100

freshness100

hygiene80

+dns-namespace +website +reachable +uptime-100% +updated-29d-ago -no-repository

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://www.premierletters.com/api/mcp` streamable-http	none	yes	100%	293 ms	2025-06-18	2026-10-20

Tools (12)

`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.
`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.
`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 orders use return_address if given, otherwise the account's default return address; with neither, set no_return_address_ack: true to send without one.
`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_balance.
`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.
`get_order_status`	Get an order's status, delivery/tracking summary, and per-recipient mail status.
`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.
`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_orders`	List the authenticated user's recent orders.
`list_templates`	List the authenticated user's saved letter templates.
`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.
`verify_address`	Verify and standardize a US mailing address via USPS. Use before create_order to catch typos and get the USPS-standardized form.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "com.premierletters/mcp",
  "title": "Premier Letters",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "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."
        }
      ]
    }
  ],
  "version": "1.0.0",
  "websiteUrl": "https://www.premierletters.com/developers",
  "description": "Send real pen-written letters, cards and postcards: quote, preview, order and track by mail."
}