Server definition
- Hash
- sha256:c7a73472b25a12415f1ca641197b00c7b4488c16471cbe5562812414fb8a9e45
- What it is
- What a remote MCP server returned when asked what it offers: 8 tools
The blob, as servednamed by its sha256
{
"instructions": "Premier Letters writes real letters, cards and postcards with an actual pen and mails them via USPS on behalf of the caller — from a single thank-you note to a large campaign. Pricing, handwriting styles and address verification are open to anyone; creating an order requires a Premier Letters API key (the user generates one at https://premierletters.com/settings/api-keys and passes it as \"Authorization: Bearer pl_live_...\").\" Recommended flow: call get_pricing to quote a cost, preview_letter to see and confirm the rendered letter, create_order to pay and send it, then get_order_status to check on delivery.",
"tools": [
{
"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, 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.",
"inputSchema": {
"properties": {
"idempotency_key": {
"description": "Optional client-supplied key. Not yet enforced server-side; reserved for future use.",
"type": "string"
},
"message": {
"description": "The letter text. Supports {{first_name}}, {{last_name}}, {{greeting}} merge fields per-recipient.",
"type": "string"
},
"options": {
"description": "handwriting_style, paper_type, product_type, mailing_option, authenticity_preset, include_letter, include_envelope, copies — see /openapi.json for the full field list.",
"type": "object"
},
"payment": {
"properties": {
"method": {
"description": "Defaults to \"checkout_session\".",
"enum": [
"card_on_file",
"checkout_session"
],
"type": "string"
},
"return_url": {
"type": "string"
}
},
"type": "object"
},
"recipients": {
"description": "One or more recipients. At least one is required unless options.product_type is a letter/card with no envelope.",
"items": {
"properties": {
"address_line1": {
"type": "string"
},
"address_line2": {
"type": "string"
},
"city": {
"type": "string"
},
"custom_fields": {
"type": "object"
},
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
},
"state": {
"type": "string"
},
"zip": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"skip_invalid": {
"description": "When true, invalid recipients are skipped instead of failing the whole order.",
"type": "boolean"
}
},
"required": [
"message"
],
"type": "object"
},
"name": "create_order",
"outputSchema": null
},
{
"description": "Get an order's status, delivery/tracking summary, and per-recipient mail status.",
"inputSchema": {
"properties": {
"order_id": {
"description": "The order UUID returned by create_order.",
"type": "string"
}
},
"required": [
"order_id"
],
"type": "object"
},
"name": "get_order_status",
"outputSchema": 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.",
"inputSchema": {
"properties": {
"char_count": {
"description": "Length of the letter message in characters. Longer letters cost more (character meter).",
"type": "number"
},
"letter_count": {
"description": "Number of recipients / pieces. Defaults to 1.",
"type": "number"
},
"mailing_option": {
"description": "Delivery option. Defaults to \"we_mail\" (we write, stamp, and mail it for you).",
"enum": [
"we_mail",
"you_mail_stamped",
"you_mail_no_stamp"
],
"type": "string"
},
"paper_type": {
"description": "Paper quality. Defaults to \"standard\".",
"enum": [
"standard",
"premium"
],
"type": "string"
},
"product_type": {
"description": "Product type (letter, card, postcard, etc). Informational only — does not change pricing components beyond envelope inclusion.",
"enum": [
"letter",
"card",
"a7",
"postcard",
"card_5x7",
"postcard_5x7",
"a4",
"a5",
"a6"
],
"type": "string"
}
},
"type": "object"
},
"name": "get_pricing",
"outputSchema": 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": {
"properties": {},
"type": "object"
},
"name": "list_handwriting_styles",
"outputSchema": null
},
{
"description": "List the authenticated user's recent orders.",
"inputSchema": {
"properties": {
"limit": {
"description": "Max orders to return (1-100). Defaults to 20.",
"type": "number"
},
"status": {
"description": "Optional status filter (pending_payment, paid, in_production, mailed, delivered, cancelled, refunded).",
"type": "string"
}
},
"type": "object"
},
"name": "list_orders",
"outputSchema": null
},
{
"description": "List the authenticated user's saved letter templates.",
"inputSchema": {
"properties": {
"favorites_only": {
"description": "Only return favorited templates.",
"type": "boolean"
},
"search": {
"description": "Filter templates by name or content substring.",
"type": "string"
},
"sort": {
"description": "Sort order. Defaults to \"recent\".",
"enum": [
"recent",
"most_used",
"name"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_templates",
"outputSchema": 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": {
"properties": {
"handwriting_style": {
"description": "Font UUID from list_handwriting_styles. Defaults to the house font.",
"type": "string"
},
"message": {
"description": "The letter text to render.",
"type": "string"
},
"product_type": {
"description": "Product slug: letter, card, postcard, etc. Defaults to \"letter\".",
"type": "string"
},
"recipient": {
"description": "Optional recipient info, used only to personalize {{merge fields}} in the message before rendering.",
"properties": {
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
}
},
"type": "object"
}
},
"required": [
"message"
],
"type": "object"
},
"name": "preview_letter",
"outputSchema": 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": {
"properties": {
"address_line1": {
"description": "Street address",
"type": "string"
},
"address_line2": {
"description": "Apt/suite/unit (optional)",
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"description": "Two-letter US state code",
"type": "string"
},
"zip": {
"description": "5-digit or ZIP+4 postal code",
"type": "string"
}
},
"required": [
"address_line1",
"city",
"state",
"zip"
],
"type": "object"
},
"name": "verify_address",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:c7a73472b25a12415f1ca641197b00c7b4488c16471cbe5562812414fb8a9e45 | sha256sum