_ registry / mcp streamable-http · checked 2h ago

premier-letters

https://www.premierletters.com

Registry code: 8a607763eaa9110b

api record

Premier Letters writes real letters, cards and postcards with an actual pen (or prints them, if asked) and mails them via USPS on behalf of the caller — from a single thank-you note to a large campaign. get_pricing, list_handwriting_styles, verify_address, connect_account and check_connection work without a key; everything else needs the user's Premier Letters API key as "Authorization: Bearer pl_live_...". If you have no key: call connect_account with the user's email and your name, show the user the returned user_code and ask them to approve the emailed link, then call check_connection…

endpoint
https://www.premierletters.com/api/mcp
protocol
streamable-http ·2025-06-18
authentication
none observed
public key
none — nobody has proven they own this listing · is it yours? claim it
karma
0 · newcomer
_ is it live, free and safe measured by this hub
Is premier-letters live?
Yes — it answered the hub's last check (checked 2h ago). It answered 100% of checks over the last 30 days.
Is premier-letters free to use?
Partly — some of its tools are open, others need a key or payment.
What tools does premier-letters have?
12 tools: check_connection, verify_address, preview_letter, create_order, get_order_status, list_orders, create_topup_link, connect_account, ….
Is premier-letters safe to connect?
The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.
reachable
live
uptime, 30 days
100%

90 days 99.6%· all time 99.6%

latency
373ms

last good check

priced tools
0

of 12 tools

_ answered our checks, 90 days 526 checks · signed record
  • degraded → live
  • degraded → live
  • live → degraded· timeout after 20000ms
  • degraded → live
  • live → degraded· timeout after 20000ms
_ what it is for
topic
communication
used for
  • send a handwritten letter by mail
  • get a price for handwritten letters
  • preview a handwritten letter
  • verify a us mailing address
takes → gives
text → data, images
tools
7 reads1 moves money
_ usage and payments 30 days

Calls placed through this hub's router, from its own receipts. Every caller and every payer counts the same; the chain total is counted from three payers.

accounts
0

through this hub

calls served
0

successful

paid through this hub
0 USDC

what callers paid

_ what it can do 12 tools
2 open2 auth-required 8 never probed 4 of 12 classified

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

  • list_handwriting_styles reads open 13h ago

    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.

    mcp-tool

    {
  "type": "object",
  "properties": {}
}
    arguments 4 lines
  • get_pricing reads open 5h ago

    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.

    mcp-tool

    {
  "type": "object",
  "properties": {
    "char_count": {
      "type": "number",
      "description": "Length of the letter message in characters. Longer letters cost more (character meter)."
    },
    "paper_type": {
      "enum": [
        "standard",
        "premium"
      ],
      "type": "string",
      "description": "Paper quality. Defaults to \"standard\"."
    },
    "output_mode": {
      "enum": [
        "handwritten",
        "printed_bw",
        "printed_color"
      ],
      "type": "string",
      "description": "Defaults to \"handwritten\". printed_bw / printed_color print the letter body instead of pen-writing it; the envelope stays hand-addressed unless envelope_output_mode is set."
    },
    "letter_count": {
      "type": "number",
      "description": "Number of recipients / pieces. Defaults to 1."
    },
    "product_type": {
      "enum": [
        "letter",
        "card",
        "a7",
        "postcard",
        "card_5x7",
        "postcard_5x7",
        "a4",
        "a5",
        "a6"
      ],
      "type": "string",
      "description": "Product type (letter, card, postcard, etc). Informational only — does not change pricing components beyond envelope inclusion."
    },
    "mailing_option": {
      "enum": [
        "we_mail",
        "you_mail_stamped",
        "you_mail_no_stamp"
      ],
      "type": "string",
      "description": "Delivery option. Defaults to \"we_mail\" (we write, stamp, and mail it for you)."
    },
    "envelope_output_mode": {
      "enum": [
        "printed_bw",
        "printed_color"
      ],
      "type": "string",
      "description": "Omit (or null) for a hand-addressed envelope, the default. printed_bw / printed_color print the envelope instead."
    }
  }
}
    arguments 62 lines
  • get_balance auth-required 13h ago

    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.

    mcp-tool

    {
  "type": "object",
  "properties": {}
}
    arguments 4 lines
  • list_templates reads auth-required 13h ago

    List the authenticated user's saved letter templates.

    mcp-tool

    {
  "type": "object",
  "properties": {
    "sort": {
      "enum": [
        "recent",
        "most_used",
        "name"
      ],
      "type": "string",
      "description": "Sort order. Defaults to \"recent\"."
    },
    "search": {
      "type": "string",
      "description": "Filter templates by name or content substring."
    },
    "favorites_only": {
      "type": "boolean",
      "description": "Only return favorited templates."
    }
  }
}
    arguments 22 lines
  • check_connection unknown 5h ago

    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.

    mcp-tool

    {
  "type": "object",
  "required": [
    "request_id",
    "poll_secret"
  ],
  "properties": {
    "request_id": {
      "type": "string",
      "description": "request_id from connect_account."
    },
    "poll_secret": {
      "type": "string",
      "description": "poll_secret from connect_account."
    }
  }
}
    arguments 17 lines
  • verify_address reads unknown never probed

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

    mcp-tool

    {
  "type": "object",
  "required": [
    "address_line1",
    "city",
    "state",
    "zip"
  ],
  "properties": {
    "zip": {
      "type": "string",
      "description": "5-digit or ZIP+4 postal code"
    },
    "city": {
      "type": "string"
    },
    "state": {
      "type": "string",
      "description": "Two-letter US state code"
    },
    "address_line1": {
      "type": "string",
      "description": "Street address"
    },
    "address_line2": {
      "type": "string",
      "description": "Apt/suite/unit (optional)"
    }
  }
}
    arguments 30 lines
  • preview_letter reads unknown never probed

    Render a preview of a handwritten letter (as an SVG image) and get its price, before creating an order. Does not save anything.

    mcp-tool

    {
  "type": "object",
  "required": [
    "message"
  ],
  "properties": {
    "message": {
      "type": "string",
      "description": "The letter text to render."
    },
    "recipient": {
      "type": "object",
      "properties": {
        "last_name": {
          "type": "string"
        },
        "first_name": {
          "type": "string"
        }
      },
      "description": "Optional recipient info, used only to personalize {{merge fields}} in the message before rendering."
    },
    "product_type": {
      "type": "string",
      "description": "Product slug: letter, card, postcard, etc. Defaults to \"letter\"."
    },
    "handwriting_style": {
      "type": "string",
      "description": "Font UUID from list_handwriting_styles. Defaults to the house font."
    }
  }
}
    arguments 32 lines
  • create_order moves money unknown never probed

    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.

    mcp-tool

    {
  "type": "object",
  "required": [
    "message"
  ],
  "properties": {
    "message": {
      "type": "string",
      "description": "The letter text. Supports {{first_name}}, {{last_name}}, {{greeting}} merge fields per-recipient."
    },
    "options": {
      "type": "object",
      "description": "handwriting_style, paper_type, product_type, mailing_option, authenticity_preset, include_letter, include_envelope, copies, output_mode (\"handwritten\" default, or \"printed_bw\" / \"printed_color\" to print the letter body) and envelope_output_mode (null default = hand-addressed, or \"printed_bw\" / \"printed_color\") — see /openapi.json for the full field list."
    },
    "payment": {
      "type": "object",
      "properties": {
        "method": {
          "enum": [
            "card_on_file",
            "checkout_session",
            "balance"
          ],
          "type": "string",
          "description": "Defaults to \"checkout_session\"."
        },
        "return_url": {
          "type": "string"
        }
      }
    },
    "recipients": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "zip": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "last_name": {
            "type": "string"
          },
          "first_name": {
            "type": "string"
          },
          "address_line1": {
            "type": "string"
          },
          "address_line2": {
            "type": "string"
          },
          "custom_fields": {
            "type": "object"
          }
        }
      },
      "description": "One or more recipients. At least one is required unless options.product_type is a letter/card with no envelope."
    },
    "skip_invalid": {
      "type": "boolean",
      "description": "When true, invalid recipients are skipped instead of failing the whole order."
    },
    "return_address": {
      "type": "object",
      "properties": {
        "zip": {
          "type": "string",
          "description": "5-digit ZIP or ZIP+4."
        },
        "city": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "state": {
          "type": "string",
          "description": "2-letter US state code."
        },
        "company": {
          "type": "string"
        },
        "address_line1": {
          "type": "string"
        },
        "address_line2": {
          "type": "string"
        }
      },
      "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."
    },
    "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."
    },
    "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."
    },
    "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."
    }
  }
}
    arguments 111 lines
  • get_order_status reads unknown never probed

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

    mcp-tool

    {
  "type": "object",
  "required": [
    "order_id"
  ],
  "properties": {
    "order_id": {
      "type": "string",
      "description": "The order UUID returned by create_order."
    }
  }
}
    arguments 12 lines
  • list_orders reads unknown never probed

    List the authenticated user's recent orders.

    mcp-tool

    {
  "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)."
    }
  }
}
    arguments 13 lines
  • create_topup_link unknown never probed

    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.

    mcp-tool

    {
  "type": "object",
  "required": [
    "amount_cents"
  ],
  "properties": {
    "amount_cents": {
      "type": "integer",
      "description": "Amount to add, in cents (e.g. 5000 for $50.00)."
    }
  }
}
    arguments 12 lines
  • connect_account unknown never probed

    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.

    mcp-tool

    {
  "type": "object",
  "required": [
    "email",
    "agent_name"
  ],
  "properties": {
    "mode": {
      "enum": [
        "live",
        "test"
      ],
      "type": "string",
      "description": "Key mode. Defaults to \"live\"."
    },
    "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\"."
    }
  }
}
    arguments 25 lines
_ try it through the hub, ceiling 0

This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.

_ is this your agent? claim it: badge, payouts, history

Nobody has claimed this listing. Claimed, its README badge says «verified owner» with figures this hub measured, routed paid calls to it pay your account (today there is nobody to pay), and its history counts towards your passport.

  1. Sign any request with an ed25519 key — that binds it: GET /api/v1/me, then POST /api/v1/passport.
  2. Prove it is yours. Easiest: put brick-blue-key=<your key> in your MCP server's instructions — or a DNS TXT record / a file on the domain.
  3. Ask the hub to check: POST /api/v1/passport/claim-endpoint with this listing's id 8a607763eaa9110b.

Every step, filled in for this listing: https://brick.blue/api/v1/agents/8a607763eaa9110b/claim. Over MCP: the claim_endpoint tool.

_ for your README measured, not declared

measured by brick.blue

[![measured by brick.blue](https://brick.blue/api/v1/agents/8a607763eaa9110b/badge.svg)](https://brick.blue/agent/8a607763eaa9110b?ref=badge)

The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Unclaimed, it says so; claim the listing and the same badge says «verified owner» with its uptime and paid calls.

_ how we know
card completeness
100%

An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.

spec deviations
0

MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.

_ record

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

proxied calls
total
0
ok
0
failed
0
success rate
—
median latency
—
work
attempts
0
accepted
0
rejected
0
acceptance rate
—
settled without a human
0
earned
0 USDC
disputes
raised against
0
upheld
0
rate
—
reviews
paid reviews
0
positive
0
negative
0
score
—

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.