postalform
Registry code: 75e482398fd8c9f8
PostalForm prints and mails physical letters, documents, and forms via USPS. Typical flow: validate addresses, prepare a draft and review its price, then obtain buyer approval before complete_checkout with a compatible Stripe payment token, hosted checkout, or a direct MPP/x402 payment. Every unpaid machine order also returns a hosted checkout_url fallback. Without a compatible wallet, present that URL and poll status_url. For MPP, any PDF, letter, or form draft can use payment_protocol=mpp and buyer_email. Review the preview and total, then call postalform.pay_order with only the order_id…
- endpoint
- https://postalform.com/mcp
- door code
- 1c06c357db3db191
- protocol
- http-sse ·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 postalform live?
- Yes — it answered the hub's last check (checked 1h ago). It answered 100% of checks over the last 30 days.
- Is postalform free to use?
- Yes — the hub reached it with no key and no payment.
- What tools does postalform have?
- 13 tools: postalform.create_form_order_draft, postalform.list_forms, postalform.create_order_draft, postalform.preview_letter_order_draft, postalform.ping, postalform.get_form_schema, postalform.search_addresses, postalform.create_pdf_upload, ….
- Is postalform 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.
90 days 99.6%· all time 99.5%
last good check
of 13 tools
- degraded → live
- live → degraded· timeout after 20000ms
- degraded → live
- live → degraded· timeout after 20000ms
- degraded → live
- topic
- communication
- used for
- mail a physical letter
- mail a pdf document via usps
- validate mailing addresses
- track mail order status
- takes → gives
- text, documents → data
- tools
- 6 reads4 changes data3 moves money
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.
through this hub
successful
what callers paid
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.
postalform.create_form_order_draft changes data unknown never probed
Prepare a supported workflow form for mailing and return the order ID, total, hosted checkout URL, and checkout session. After buyer approval, a compatible client can use complete_checkout with a Stripe shared payment token; otherwise present the hosted checkout URL. To prepare for MPP, set payment_protocol=mpp and buyer_email; receive a PDF preview, hosted checkout_url fallback and MPP challenge, then use postalform.pay_order with the order_id after buyer approval. Draft creation never pays. For x402, use postalform.create_machine_order.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug", "sender_name", "sender_address_type" ], "properties": { "slug": { "type": "string", "minLength": 1 }, "color": { "type": "boolean" }, "fields": { "type": "object", "default": {}, "propertyNames": { "type": "string" }, "additionalProperties": {} }, "certified": { "type": "boolean" }, "buyer_name": { "type": "string", "maxLength": 256, "minLength": 1, "description": "Receipt name; defaults to sender_name for MPP." }, "mail_class": { "enum": [ "standard", "priority", "express" ], "type": "string" }, "request_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "attachments": { "type": "array", "items": { "type": "object", "required": [ "id", "base64" ], "properties": { "id": { "type": "string", "minLength": 1 }, "label": { "type": "string" }, "base64": { "type": "string", "minLength": 1 }, "file_name": { "type": "string" }, "content_type": { "type": "string" } } } }, "buyer_email": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "maxLength": 256, "description": "Required for MPP receipt delivery." }, "sender_name": { "type": "string", "maxLength": 255, "minLength": 1 }, "double_sided": { "type": "boolean" }, "recipient_name": { "type": "string", "maxLength": 255, "minLength": 1 }, "payment_protocol": { "enum": [ "hosted", "mpp" ], "type": "string", "description": "Optional payment path. Defaults to hosted checkout. Choose mpp to return a payment challenge for this same prepared order; buyer_email is required. Draft creation never pays." }, "sender_address_id": { "type": "string", "maxLength": 255, "minLength": 1 }, "sender_address_text": { "type": "string", "maxLength": 2000, "minLength": 1 }, "sender_address_type": { "enum": [ "Address", "Container", "Manual" ], "type": "string" }, "recipient_address_id": { "type": "string", "maxLength": 255, "minLength": 1 }, "sender_address_manual": { "type": "object", "required": [ "line1", "city", "zip" ], "properties": { "zip": { "type": "string", "maxLength": 20, "minLength": 1 }, "city": { "type": "string", "minLength": 1 }, "line1": { "type": "string", "minLength": 1 }, "line2": { "type": "string", "minLength": 1 }, "state": { "type": "string", "maxLength": 60, "minLength": 1 }, "country": { "type": "string", "maxLength": 2, "minLength": 2 }, "countryCode": { "type": "string", "maxLength": 2, "minLength": 2 } } }, "recipient_address_text": { "type": "string", "maxLength": 2000, "minLength": 1 }, "recipient_address_type": { "enum": [ "Address", "Container", "Manual" ], "type": "string" }, "use_workflow_recipient": { "type": "boolean", "description": "Deprecated compatibility field. Predefined and computed workflow recipients are always enforced and cannot be overridden." }, "certified_return_receipt": { "type": "boolean" }, "recipient_address_manual": { "type": "object", "required": [ "line1", "city", "zip" ], "properties": { "zip": { "type": "string", "maxLength": 20, "minLength": 1 }, "city": { "type": "string", "minLength": 1 }, "line1": { "type": "string", "minLength": 1 }, "line2": { "type": "string", "minLength": 1 }, "state": { "type": "string", "maxLength": 60, "minLength": 1 }, "country": { "type": "string", "maxLength": 2, "minLength": 2 }, "countryCode": { "type": "string", "maxLength": 2, "minLength": 2 } } } } }arguments 232 linespostalform.list_forms reads unknown never probed
Use this when you need the published single-mailpiece PostalForm workflow catalog available to agents. Coordinated statutory multi-recipient workflows are excluded.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "q": { "type": "string", "description": "Optional search query (matches slug/name)." }, "limit": { "type": "integer", "maximum": 200, "description": "Max results (default 50).", "exclusiveMinimum": 0 }, "cursor": { "type": "string", "description": "Pagination cursor (opaque string)." } } }arguments 20 linespostalform.create_order_draft changes data unknown never probed
Prepare an existing PDF for mailing and return the order ID, total, hosted checkout URL, and checkout session. After buyer approval, a compatible client can pass a Stripe shared payment token to complete_checkout; otherwise present the hosted checkout URL. To prepare for MPP, set payment_protocol=mpp and buyer_email; receive a PDF preview, hosted checkout_url fallback and MPP challenge, then use postalform.pay_order with the order_id after buyer approval. Draft creation never pays. For x402, use postalform.create_machine_order.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "pdf", "sender_name", "sender_address_type", "recipient_name", "recipient_address_type" ], "properties": { "pdf": { "anyOf": [ { "type": "object", "required": [ "download_url", "file_id" ], "properties": { "file_id": { "type": "string" }, "download_url": { "type": "string", "format": "uri" } } }, { "type": "object", "required": [ "upload_token" ], "properties": { "upload_token": { "type": "string", "minLength": 1 } } }, { "type": "string", "minLength": 1 } ], "description": "The PDF to mail. Accepts attachment objects ({ download_url, file_id }). Fallbacks: upload_token from postalform.create_pdf_upload, data:application/pdf;base64,..., or a public HTTPS download URL." }, "color": { "type": "boolean", "description": "Whether to print in color (default: false)." }, "certified": { "type": "boolean", "description": "Whether to add proof mail: USPS Certified Mail for US destinations, Canada Post Registered Mail through PostGrid for Canadian destinations, or PinGen registered mail for supported European destinations (default: false)." }, "file_name": { "type": "string", "maxLength": 255, "minLength": 1, "description": "Optional display file name." }, "buyer_name": { "type": "string", "maxLength": 256, "minLength": 1, "description": "Receipt name; defaults to sender_name for MPP." }, "mail_class": { "enum": [ "standard", "priority", "express" ], "type": "string", "description": "Mail service level (standard, priority, express)." }, "request_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "description": "Optional idempotency key. Reuse the same value if retrying the call." }, "buyer_email": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "maxLength": 256, "description": "Required for MPP receipt delivery." }, "sender_name": { "type": "string", "maxLength": 255, "minLength": 1, "description": "Sender's name (return address)." }, "double_sided": { "type": "boolean", "description": "Whether to print double-sided (default: true)." }, "recipient_name": { "type": "string", "maxLength": 255, "minLength": 1, "description": "Recipient's name." }, "sender_company": { "type": "string", "maxLength": 40, "minLength": 1, "description": "Optional company, department or attention line printed under sender_name in the return address (at most 40 characters)." }, "payment_protocol": { "enum": [ "hosted", "mpp" ], "type": "string", "description": "Optional payment path. Defaults to hosted checkout. Choose mpp to return a payment challenge for this same prepared order; buyer_email is required. Draft creation never pays." }, "recipient_company": { "type": "string", "maxLength": 40, "minLength": 1, "description": "Optional company, department or attention line printed under recipient_name, for example \"Acme Corp, ATTN: Legal\" (at most 40 characters)." }, "sender_address_id": { "type": "string", "maxLength": 255, "minLength": 1, "description": "Loqate address id for the sender (required when sender_address_type is Address)." }, "sender_address_text": { "type": "string", "maxLength": 2000, "minLength": 1, "description": "Human-readable sender address preview (required when sender_address_type is Address; optional for Manual)." }, "sender_address_type": { "enum": [ "Address", "Container", "Manual" ], "type": "string", "description": "Address suggestion type for the sender (from postalform.search_addresses). Use Manual to pass a structured address with countryCode when outside the US." }, "recipient_address_id": { "type": "string", "maxLength": 255, "minLength": 1, "description": "Loqate address id for the recipient (required when recipient_address_type is Address)." }, "sender_address_manual": { "type": "object", "required": [ "line1", "city", "zip" ], "properties": { "zip": { "type": "string", "maxLength": 20, "minLength": 1 }, "city": { "type": "string", "minLength": 1 }, "line1": { "type": "string", "minLength": 1 }, "line2": { "type": "string", "minLength": 1 }, "state": { "type": "string", "maxLength": 60, "minLength": 1 }, "country": { "type": "string", "maxLength": 2, "minLength": 2 }, "countryCode": { "type": "string", "maxLength": 2, "minLength": 2 } }, "description": "Sender manual address fields (required when sender_address_type is Manual)." }, "recipient_address_text": { "type": "string", "maxLength": 2000, "minLength": 1, "description": "Human-readable recipient address preview (required when recipient_address_type is Address; optional for Manual)." }, "recipient_address_type": { "enum": [ "Address", "Container", "Manual" ], "type": "string", "description": "Address suggestion type for the recipient (from postalform.search_addresses). Use Manual to pass a structured address with countryCode when outside the US." }, "certified_return_receipt": { "type": "boolean", "description": "Add Electronic Return Receipt for US Certified Mail. Ignored for Canada Post Registered Mail and PinGen registered-mail destinations (default: false)." }, "recipient_address_manual": { "type": "object", "required": [ "line1", "city", "zip" ], "properties": { "zip": { "type": "string", "maxLength": 20, "minLength": 1 }, "city": { "type": "string", "minLength": 1 }, "line1": { "type": "string", "minLength": 1 }, "line2": { "type": "string", "minLength": 1 }, "state": { "type": "string", "maxLength": 60, "minLength": 1 }, "country": { "type": "string", "maxLength": 2, "minLength": 2 }, "countryCode": { "type": "string", "maxLength": 2, "minLength": 2 } }, "description": "Recipient manual address fields (required when recipient_address_type is Manual)." } } }arguments 260 linespostalform.preview_letter_order_draft reads unknown never probed
Use this to prepare a non-writing preview for a mailed letter before creating checkout. It renders the letter, validates the addresses, and returns a widget with a create-draft action.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "letter", "sender_name", "sender_address_type", "recipient_name", "recipient_address_type" ], "properties": { "color": { "type": "boolean" }, "letter": { "type": "object", "required": [ "body" ], "properties": { "body": { "type": "string", "maxLength": 20000, "minLength": 1 }, "title": { "type": "string", "maxLength": 200 }, "render": { "type": "object", "properties": { "font": { "enum": [ "times", "helvetica" ], "type": "string" }, "paper": { "type": "string", "const": "letter" }, "font_size": { "type": "integer", "maximum": 14, "minimum": 9 }, "margin_in": { "type": "number", "maximum": 1.5, "minimum": 0.5 } } }, "signature": { "anyOf": [ { "type": "string", "maxLength": 2000 }, { "type": "object", "properties": { "mode": { "enum": [ "typed", "drawn" ], "type": "string" }, "text": { "type": "string", "maxLength": 2000 }, "dataUrl": { "type": "string" }, "printDataUrl": { "type": "string" } }, "additionalProperties": false } ] } } }, "certified": { "type": "boolean" }, "mail_class": { "enum": [ "standard", "priority", "express" ], "type": "string" }, "request_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "sender_name": { "type": "string", "maxLength": 255, "minLength": 1 }, "double_sided": { "type": "boolean" }, "recipient_name": { "type": "string", "maxLength": 255, "minLength": 1 }, "sender_address_id": { "type": "string", "maxLength": 255, "minLength": 1 }, "sender_address_text": { "type": "string", "maxLength": 2000, "minLength": 1 }, "sender_address_type": { "enum": [ "Address", "Container", "Manual" ], "type": "string" }, "recipient_address_id": { "type": "string", "maxLength": 255, "minLength": 1 }, "sender_address_manual": { "type": "object", "required": [ "line1", "city", "zip" ], "properties": { "zip": { "type": "string", "maxLength": 20, "minLength": 1 }, "city": { "type": "string", "minLength": 1 }, "line1": { "type": "string", "minLength": 1 }, "line2": { "type": "string", "minLength": 1 }, "state": { "type": "string", "maxLength": 60, "minLength": 1 }, "country": { "type": "string", "maxLength": 2, "minLength": 2 }, "countryCode": { "type": "string", "maxLength": 2, "minLength": 2 } } }, "recipient_address_text": { "type": "string", "maxLength": 2000, "minLength": 1 }, "recipient_address_type": { "enum": [ "Address", "Container", "Manual" ], "type": "string" }, "certified_return_receipt": { "type": "boolean" }, "recipient_address_manual": { "type": "object", "required": [ "line1", "city", "zip" ], "properties": { "zip": { "type": "string", "maxLength": 20, "minLength": 1 }, "city": { "type": "string", "minLength": 1 }, "line1": { "type": "string", "minLength": 1 }, "line2": { "type": "string", "minLength": 1 }, "state": { "type": "string", "maxLength": 60, "minLength": 1 }, "country": { "type": "string", "maxLength": 2, "minLength": 2 }, "countryCode": { "type": "string", "maxLength": 2, "minLength": 2 } } } } }arguments 242 linespostalform.ping reads unknown never probed
Use this when you want a quick health check that the PostalForm MCP server is reachable.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "properties": {} }arguments 5 linespostalform.get_form_schema reads unknown never probed
Use this when you need a machine-usable schema for one supported single-mailpiece PostalForm workflow (fields, groups, attachments, and dependencies).
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug" ], "properties": { "slug": { "type": "string", "minLength": 1, "description": "Workflow slug (e.g. \"8822\")." } } }arguments 14 linespostalform.search_addresses reads unknown never probed
Use this to search for a mailing address and return Loqate suggestions with IDs. Pass country_code to filter by country; it defaults to US. If a suggestion has type "Container" (building/complex), call this tool again with container=<id> and a refined query to drill down to type "Address". Only type "Address" is valid for order creation.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "query" ], "properties": { "query": { "type": "string", "minLength": 3, "description": "Partial address text, e.g. \"123 Main St\"" }, "target": { "enum": [ "sender", "recipient" ], "type": "string", "description": "Which address field is being searched (used for UI context)." }, "container": { "type": "string", "description": "Loqate container id for drilling into suggestions, if provided" }, "country_code": { "type": "string", "maxLength": 2, "minLength": 2, "description": "Two-letter country code to filter suggestions. Defaults to US." } } }arguments 32 linespostalform.create_pdf_upload changes data unknown never probed
Use this when the host cannot provide a PDF file param directly. It creates a short-lived PDF upload URL and upload token (multipart/form-data, file field). Let the HTTP client generate Content-Type with its multipart boundary.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "file_name": { "type": "string", "maxLength": 255, "minLength": 1, "description": "Optional original file name." }, "request_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "description": "Optional idempotency key. Reuse the same value if retrying the call." }, "content_type": { "type": "string", "maxLength": 255, "minLength": 1, "description": "Optional content type hint (application/pdf)." }, "content_length": { "type": "integer", "maximum": 9007199254740991, "minimum": 0, "description": "Optional content length in bytes." } } }arguments 30 linespostalform.create_letter_order_draft changes data unknown never probed
Prepare letter text for mailing and return the order ID, total, hosted checkout URL, and checkout session. Accepts text directly; no PDF upload or browser is needed. Letter drafts may include typed or drawn signatures. After buyer approval, a compatible client can use complete_checkout with a Stripe shared payment token; otherwise present the hosted checkout URL. To prepare for MPP, set payment_protocol=mpp and buyer_email; receive a PDF preview, hosted checkout_url fallback and MPP challenge, then use postalform.pay_order with the order_id after buyer approval. Draft creation never pays. For x402, use postalform.create_machine_order.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "letter", "sender_name", "sender_address_type", "recipient_name", "recipient_address_type" ], "properties": { "color": { "type": "boolean" }, "letter": { "type": "object", "required": [ "body" ], "properties": { "body": { "type": "string", "maxLength": 20000, "minLength": 1 }, "title": { "type": "string", "maxLength": 200 }, "render": { "type": "object", "properties": { "font": { "enum": [ "times", "helvetica" ], "type": "string" }, "paper": { "type": "string", "const": "letter" }, "font_size": { "type": "integer", "maximum": 14, "minimum": 9 }, "margin_in": { "type": "number", "maximum": 1.5, "minimum": 0.5 } } }, "signature": { "anyOf": [ { "type": "string", "maxLength": 2000 }, { "type": "object", "properties": { "mode": { "enum": [ "typed", "drawn" ], "type": "string" }, "text": { "type": "string", "maxLength": 2000 }, "dataUrl": { "type": "string" }, "printDataUrl": { "type": "string" } }, "additionalProperties": false } ] } } }, "certified": { "type": "boolean" }, "buyer_name": { "type": "string", "maxLength": 256, "minLength": 1, "description": "Receipt name; defaults to sender_name for MPP." }, "mail_class": { "enum": [ "standard", "priority", "express" ], "type": "string" }, "request_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "buyer_email": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "maxLength": 256, "description": "Required for MPP receipt delivery." }, "sender_name": { "type": "string", "maxLength": 255, "minLength": 1 }, "double_sided": { "type": "boolean" }, "recipient_name": { "type": "string", "maxLength": 255, "minLength": 1 }, "payment_protocol": { "enum": [ "hosted", "mpp" ], "type": "string", "description": "Optional payment path. Defaults to hosted checkout. Choose mpp to return a payment challenge for this same prepared order; buyer_email is required. Draft creation never pays." }, "sender_address_id": { "type": "string", "maxLength": 255, "minLength": 1 }, "sender_address_text": { "type": "string", "maxLength": 2000, "minLength": 1 }, "sender_address_type": { "enum": [ "Address", "Container", "Manual" ], "type": "string" }, "recipient_address_id": { "type": "string", "maxLength": 255, "minLength": 1 }, "sender_address_manual": { "type": "object", "required": [ "line1", "city", "zip" ], "properties": { "zip": { "type": "string", "maxLength": 20, "minLength": 1 }, "city": { "type": "string", "minLength": 1 }, "line1": { "type": "string", "minLength": 1 }, "line2": { "type": "string", "minLength": 1 }, "state": { "type": "string", "maxLength": 60, "minLength": 1 }, "country": { "type": "string", "maxLength": 2, "minLength": 2 }, "countryCode": { "type": "string", "maxLength": 2, "minLength": 2 } } }, "recipient_address_text": { "type": "string", "maxLength": 2000, "minLength": 1 }, "recipient_address_type": { "enum": [ "Address", "Container", "Manual" ], "type": "string" }, "certified_return_receipt": { "type": "boolean" }, "recipient_address_manual": { "type": "object", "required": [ "line1", "city", "zip" ], "properties": { "zip": { "type": "string", "maxLength": 20, "minLength": 1 }, "city": { "type": "string", "minLength": 1 }, "line1": { "type": "string", "minLength": 1 }, "line2": { "type": "string", "minLength": 1 }, "state": { "type": "string", "maxLength": 60, "minLength": 1 }, "country": { "type": "string", "maxLength": 2, "minLength": 2 }, "countryCode": { "type": "string", "maxLength": 2, "minLength": 2 } } } } }arguments 263 linespostalform.create_machine_order moves money unknown never probed
Create a single PDF, letter, workflow-form order, or bulk letter campaign and pay through MPP or x402 after buyer approval. For bulk, provide exactly one of bulk.csv_content or bulk.recipients (JSON address objects with optional merge_fields), plus a shared PDF or text/HTML template. Omit top-level recipient fields and review campaign_url, recipient count and total. Bulk MPP orders can also use postalform.pay_order after fetching its challenge. The unpaid response also includes checkout_url and status_url for this same order. Without an available compatible wallet, give the buyer checkout_url and poll status_url; never recreate the order to change payment paths. Single-recipient clients with a Stripe shared payment token can instead use a draft tool followed by complete_checkout; other clients should present the hosted checkout URL.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "buyer_name", "buyer_email", "sender_name" ], "properties": { "pdf": { "anyOf": [ { "type": "object", "required": [ "download_url", "file_id" ], "properties": { "file_id": { "type": "string" }, "download_url": { "type": "string", "format": "uri" } } }, { "type": "object", "required": [ "upload_token" ], "properties": { "upload_token": { "type": "string", "minLength": 1 } } }, { "type": "string", "minLength": 1 } ], "description": "Existing PDF to mail. For a single recipient, provide exactly one of pdf, letter, or form. For bulk.content_mode=pdf, this PDF is sent to every CSV or JSON recipient. Prefer upload_token from postalform.create_pdf_upload." }, "bulk": { "type": "object", "required": [ "content_mode" ], "properties": { "recipients": { "type": "array", "items": { "type": "object", "required": [ "line1", "city", "zip" ], "properties": { "zip": { "type": "string", "minLength": 1, "description": "ZIP/postal code as a string, preserving leading zeros." }, "city": { "type": "string", "minLength": 1 }, "line1": { "type": "string", "minLength": 1 }, "line2": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "state": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Required for US and Canadian recipients. Omit or send null elsewhere." }, "country": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Mailing country code. Defaults to US." }, "merge_fields": { "type": "object", "description": "Optional template values. {{field_name}} inserts a value as plain text (HTML-escaped in html mode); in html mode, {{{field_name}}} inserts it as HTML. Address field names and full_address are reserved.", "propertyNames": { "type": "string", "pattern": "^[a-z][a-z0-9_]*$" }, "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, "recipient_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, "minItems": 1, "description": "JSON recipient list, mutually exclusive with csv_content. Each address can include merge_fields for text/HTML templates." }, "csv_content": { "type": "string", "minLength": 1, "description": "Recipient CSV text, mutually exclusive with recipients. Required columns: line1, city, state, zip. Optional: recipient_name, line2, country. Other columns can be used as merge fields." }, "content_mode": { "enum": [ "text", "html", "pdf" ], "type": "string", "description": "pdf sends the same top-level PDF to every recipient; text/html render template_text/template_html with CSV columns or JSON merge_fields." }, "campaign_name": { "type": "string", "maxLength": 255 }, "template_html": { "type": "string", "description": "HTML letter template. {{field}} inserts a merge value as escaped text; {{{field}}} inserts it as HTML (use this for per-recipient HTML bodies). Scripts and remote resources are not loaded; embed images as data: URLs." }, "template_text": { "type": "string", "description": "Plain-text letter template. {{field}} inserts a merge value; HTML is not allowed." } }, "description": "Bulk letter campaign: exactly one of csv_content or recipients (JSON list), plus shared PDF or text/HTML template. Omit single-recipient fields, letter, form, and postcard options. color and double_sided apply to every mailpiece.", "additionalProperties": false }, "form": { "type": "object", "required": [ "slug" ], "properties": { "slug": { "type": "string", "minLength": 1 }, "fields": { "type": "object", "default": {}, "propertyNames": { "type": "string" }, "additionalProperties": {} }, "attachments": { "type": "array", "items": { "type": "object", "required": [ "id", "base64" ], "properties": { "id": { "type": "string", "minLength": 1 }, "label": { "type": "string", "minLength": 1 }, "base64": { "type": "string", "minLength": 1 }, "file_name": { "type": "string", "maxLength": 255, "minLength": 1 }, "content_type": { "type": "string", "minLength": 1 } } } } }, "description": "Workflow form payload from postalform.get_form_schema. Provide exactly one of pdf, letter, or form." }, "color": { "type": "boolean" }, "letter": { "type": "object", "required": [ "body" ], "properties": { "body": { "type": "string", "maxLength": 20000, "minLength": 1 }, "title": { "type": "string", "maxLength": 200 }, "format": { "enum": [ "text", "html", "markdown", "rtf" ], "type": "string" }, "render": { "type": "object", "properties": { "font": { "enum": [ "times", "helvetica" ], "type": "string" }, "paper": { "type": "string", "const": "letter" }, "font_size": { "type": "integer", "maximum": 14, "minimum": 9 }, "margin_in": { "type": "number", "maximum": 1.5, "minimum": 0.5 } } }, "signature": { "anyOf": [ { "type": "string", "maxLength": 2000 }, { "type": "object", "properties": { "mode": { "enum": [ "typed", "drawn" ], "type": "string" }, "text": { "type": "string", "maxLength": 2000 }, "dataUrl": { "type": "string" }, "printDataUrl": { "type": "string" } }, "additionalProperties": false } ] } }, "description": "Letter text to render and mail. Provide exactly one of pdf, letter, or form. Optional format may be text, html, markdown, or rtf; default is text. Optional signature may be a typed string or drawn signature payload." }, "certified": { "type": "boolean" }, "file_name": { "type": "string", "maxLength": 255, "minLength": 1 }, "buyer_name": { "type": "string", "maxLength": 256, "minLength": 1, "description": "Buyer name for receipts." }, "mail_class": { "enum": [ "standard", "priority", "express" ], "type": "string" }, "request_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "description": "Idempotency key. Reuse the same value and same order fields after a payment challenge." }, "buyer_email": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "maxLength": 256, "description": "Buyer email for receipts." }, "sender_name": { "type": "string", "maxLength": 255, "minLength": 1 }, "double_sided": { "type": "boolean" }, "postcard_size": { "enum": [ "4x6", "6x9", "11x6" ], "type": "string" }, "mailpiece_type": { "enum": [ "letter", "postcard" ], "type": "string" }, "recipient_name": { "type": "string", "maxLength": 255, "minLength": 1, "description": "Required for a single recipient. Omit when bulk supplies the recipient list." }, "payment_protocol": { "enum": [ "mpp", "x402" ], "type": "string", "description": "Direct machine payment protocol. Use mpp for Link CLI/Link MCP or Stripe SPT; use x402 for x402 wallet clients. Defaults to mpp." }, "payment_signature": { "type": "string", "minLength": 1, "description": "x402 retry value after paying the PAYMENT-REQUIRED challenge." }, "sender_address_id": { "type": "string", "minLength": 1 }, "signature_required": { "type": "boolean" }, "sender_address_text": { "type": "string", "maxLength": 2000, "minLength": 1 }, "sender_address_type": { "enum": [ "Address", "Manual" ], "type": "string" }, "recipient_address_id": { "type": "string", "minLength": 1 }, "payment_authorization": { "type": "string", "minLength": 1, "description": "MPP retry value after paying with Link CLI/Link MCP. Pass the full Authorization header value, usually \"Payment ...\"." }, "sender_address_manual": { "type": "object", "required": [ "line1", "city", "zip" ], "properties": { "zip": { "type": "string", "maxLength": 20, "minLength": 1 }, "city": { "type": "string", "minLength": 1 }, "line1": { "type": "string", "minLength": 1 }, "line2": { "type": "string", "minLength": 1 }, "state": { "type": "string", "maxLength": 60, "minLength": 1 }, "country": { "type": "string", "maxLength": 2, "minLength": 2 }, "countryCode": { "type": "string", "maxLength": 2, "minLength": 2 } } }, "recipient_address_text": { "type": "string", "maxLength": 2000, "minLength": 1 }, "recipient_address_type": { "enum": [ "Address", "Manual" ], "type": "string" }, "certified_return_receipt": { "type": "boolean" }, "recipient_address_manual": { "type": "object", "required": [ "line1", "city", "zip" ], "properties": { "zip": { "type": "string", "maxLength": 20, "minLength": 1 }, "city": { "type": "string", "minLength": 1 }, "line1": { "type": "string", "minLength": 1 }, "line2": { "type": "string", "minLength": 1 }, "state": { "type": "string", "maxLength": 60, "minLength": 1 }, "country": { "type": "string", "maxLength": 2, "minLength": 2 }, "countryCode": { "type": "string", "maxLength": 2, "minLength": 2 } } } } }arguments 524 linespostalform.pay_order moves money unknown never probed
Get an MPP challenge or pay an existing MPP PDF, letter, workflow-form order, or bulk letter campaign after buyer approval. Use the order_id returned by any draft tool with payment_protocol=mpp or by create_machine_order. When switching from create_machine_order, omit the credential first to get this payment endpoint’s challenge. Review the preview or campaign_url, recipient count and total. No document or addresses are resubmitted. Without payment_authorization this only returns a challenge; with it, this can pay and send real mail. Reuse the same order_id on retries and follow the returned payment status.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "order_id" ], "properties": { "order_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "payment_authorization": { "type": "string", "minLength": 1, "description": "Buyer-approved MPP Authorization header, usually Payment ... . Omit to retrieve the challenge." } } }arguments 19 linescomplete_checkout moves money unknown never probed
After the buyer approves the prepared order and total, pay its existing checkout session using a compatible Stripe payment token, including a shared payment token (spt_...). Pass the order ID as checkout_session_id; do not resend the document or addresses. On an interrupted request, retry the same checkout and token. Existing authorized, processing, or paid payments are reused; follow the returned status and messages.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "checkout_session_id", "buyer", "payment_data" ], "properties": { "buyer": { "anyOf": [ { "type": "object", "required": [ "first_name", "email" ], "properties": { "email": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "maxLength": 256 }, "last_name": { "type": "string", "maxLength": 256, "minLength": 1 }, "first_name": { "type": "string", "maxLength": 256, "minLength": 1 }, "phone_number": { "type": "string", "maxLength": 32, "minLength": 1 } } }, { "type": "object", "required": [ "name", "email" ], "properties": { "name": { "type": "string", "maxLength": 256, "minLength": 1 }, "email": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "maxLength": 256 }, "phone_number": { "type": "string", "maxLength": 32, "minLength": 1 } } } ], "description": "Buyer identity details for the approved checkout." }, "payment_data": { "type": "object", "required": [ "token", "provider" ], "properties": { "token": { "type": "string", "minLength": 1 }, "provider": { "enum": [ "stripe", "adyen" ], "type": "string" }, "billing_address": { "type": "object", "required": [ "name", "line_one", "city", "state", "country", "postal_code" ], "properties": { "city": { "type": "string", "maxLength": 60, "minLength": 1 }, "name": { "type": "string", "maxLength": 255, "minLength": 1 }, "state": { "type": "string", "maxLength": 60, "minLength": 1 }, "country": { "type": "string", "maxLength": 2, "minLength": 1 }, "line_one": { "type": "string", "maxLength": 60, "minLength": 1 }, "line_two": { "type": "string", "maxLength": 60, "minLength": 1 }, "postal_code": { "type": "string", "maxLength": 20, "minLength": 1 }, "phone_number": { "type": "string", "maxLength": 32, "minLength": 1 } } } }, "description": "Buyer-authorized payment token details. Use provider=stripe." }, "checkout_session_id": { "type": "string", "minLength": 1, "description": "The checkout session id to finalize." } } }arguments 150 linespostalform.get_order_status reads unknown never probed
Read payment status and total, processing, stored mailing/carrier status, the latest 50 public tracking events, and electronic return receipt availability. Use payment_status_label and payment_status_description: payment_authorized means authorized awaiting capture, even when is_paid=false and paid_at=null. Do not request another payment for authorized, processing or received payments. Bulk orders also return campaign_url, recipient count and per-status counts; use the campaign dashboard for individual recipients. Missing carrier evidence is null; processing or a tracking number alone does not prove mailing or delivery. This read does not pay, mail, or acquire receipts.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "order_id" ], "properties": { "order_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "description": "PostalForm order id." } } }arguments 15 lines
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.
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.
- Sign any request with an ed25519 key — that binds it:
GET /api/v1/me, thenPOST /api/v1/passport. - 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. - Ask the hub to check:
POST /api/v1/passport/claim-endpointwith this listing's id75e482398fd8c9f8.
Every step, filled in for this listing: https://brick.blue/api/v1/agents/75e482398fd8c9f8/claim.
Over MCP: the claim_endpoint tool.
[](https://brick.blue/agent/75e482398fd8c9f8?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.
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.
MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.
Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.
- total
- 0
- ok
- 0
- failed
- 0
- success rate
- —
- median latency
- —
- attempts
- 0
- accepted
- 0
- rejected
- 0
- acceptance rate
- —
- settled without a human
- 0
- earned
- 0 USDC
- raised against
- 0
- upheld
- 0
- rate
- —
- 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.