{"id":"com.postalform/postalform","slug":"com-postalform-postalform","title":"PostalForm","description":"Create mail drafts, upload PDFs, browse forms, track orders, and pay via MPP or x402.","version":"0.1.0","publisher":{"kind":"domain","id":"postalform.com","label":"postalform.com","url":"https://postalform.com"},"website":"https://postalform.com/developers","repository":"","remotes":[{"type":"streamable-http","url":"https://postalform.com/mcp"}],"packages":[],"published":"2026-09-27","updated":"2026-09-27","status":"online","auth":"","latency_ms":1420,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"postalform.list_forms","title":"List available forms","description":"Use this when you need the published single-mailpiece PostalForm workflow catalog available to agents. Coordinated statutory multi-recipient workflows are excluded.","read_only":true},{"name":"postalform.get_form_schema","title":"Get form schema","description":"Use this when you need a machine-usable schema for one supported single-mailpiece PostalForm workflow (fields, groups, attachments, and dependencies).","read_only":true},{"name":"postalform.search_addresses","title":"Search mailing addresses","description":"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.","read_only":true},{"name":"postalform.create_pdf_upload","title":"Create a PDF upload","description":"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.","read_only":false},{"name":"postalform.create_order_draft","title":"Create a mail order draft","description":"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 p","read_only":false},{"name":"postalform.preview_letter_order_draft","title":"Preview a mail order draft from letter text","description":"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.","read_only":true},{"name":"postalform.create_letter_order_draft","title":"Create a mail order draft from letter text","description":"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_pr","read_only":false},{"name":"postalform.create_form_order_draft","title":"Create a mail order draft from a workflow form submission","description":"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,","read_only":false},{"name":"postalform.create_machine_order","title":"Create or pay a machine order","description":"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 po","read_only":false},{"name":"postalform.pay_order","title":"Pay a prepared order with MPP","description":"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 do","read_only":false},{"name":"complete_checkout","title":"Pay a prepared checkout","description":"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","read_only":false},{"name":"postalform.get_order_status","title":"Get order status","description":"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","read_only":true},{"name":"postalform.ping","title":"Ping PostalForm","description":"Use this when you want a quick health check that the PostalForm MCP server is reachable.","read_only":true}],"server_info":{"name":"postalform","version":"0.1.0"},"category":"ecommerce","tags":["productivity","communication","crypto"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-09-27","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/com-postalform-postalform/"}