{"data":{"name":"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","websiteUrl":"https://postalform.com/developers","repositoryUrl":null,"remotes":[{"url":"https://postalform.com/mcp","type":"streamable-http"}],"packages":[],"status":"active","isLatest":true,"publishedAt":"2026-09-27T19:32:34.612Z","updatedAt":"2026-09-27T19:32:34.612Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"stars":null,"title":"PostalForm","source":"official-registry","sourceId":"com.postalform/postalform","updatedAt":"2026-09-27T19:32:34.612Z","confidence":100,"websiteUrl":"https://postalform.com/developers","description":"Create mail drafts, upload PDFs, browse forms, track orders, and pay via MPP or x402.","verification":"official","repositoryUrl":null}],"toolIndex":{"tools":[{"serverName":"com.postalform/postalform","endpointFingerprint":"1fca818b5a75121bd555e37e93c58cad561dc63111ba2e1f2dee03dae94b559e","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 status and messages.","inputSchema":{"type":"object","properties":{"checkout_session_id":{"type":"string","minLength":1,"description":"The checkout session id to finalize."},"buyer":{"anyOf":[{"type":"object","properties":{"first_name":{"type":"string","minLength":1,"maxLength":256},"last_name":{"type":"string","minLength":1,"maxLength":256},"email":{"type":"string","maxLength":256,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"phone_number":{"type":"string","minLength":1,"maxLength":32}},"required":["first_name","email"]},{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":256},"email":{"type":"string","maxLength":256,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"phone_number":{"type":"string","minLength":1,"maxLength":32}},"required":["name","email"]}],"description":"Buyer identity details for the approved checkout."},"payment_data":{"type":"object","properties":{"token":{"type":"string","minLength":1},"provider":{"type":"string","enum":["stripe","adyen"]},"billing_address":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"line_one":{"type":"string","minLength":1,"maxLength":60},"line_two":{"type":"string","minLength":1,"maxLength":60},"city":{"type":"string","minLength":1,"maxLength":60},"state":{"type":"string","minLength":1,"maxLength":60},"country":{"type":"string","minLength":1,"maxLength":2},"postal_code":{"type":"string","minLength":1,"maxLength":20},"phone_number":{"type":"string","minLength":1,"maxLength":32}},"required":["name","line_one","city","state","country","postal_code"]}},"required":["token","provider"],"description":"Buyer-authorized payment token details. Use provider=stripe."}},"required":["checkout_session_id","buyer","payment_data"],"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"openWorldHint":true},"definitionHash":"406db45ea37179d5f14c29e066c1eb8a6b9390a5144bdce61f9c8ca0ff6de8bb","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:46:38.785Z","metadataTrust":"untrusted"},{"serverName":"com.postalform/postalform","endpointFingerprint":"1fca818b5a75121bd555e37e93c58cad561dc63111ba2e1f2dee03dae94b559e","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, then use postalform.pay_order with the order_id after buyer approval. Draft creation never pays. For x402, use postalform.create_machine_order.","inputSchema":{"type":"object","properties":{"payment_protocol":{"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.","type":"string","enum":["hosted","mpp"]},"buyer_name":{"description":"Receipt name; defaults to sender_name for MPP.","type":"string","minLength":1,"maxLength":256},"buyer_email":{"description":"Required for MPP receipt delivery.","type":"string","maxLength":256,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"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)$"},"slug":{"type":"string","minLength":1},"fields":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string"},"file_name":{"type":"string"},"content_type":{"type":"string"},"base64":{"type":"string","minLength":1}},"required":["id","base64"]}},"use_workflow_recipient":{"description":"Deprecated compatibility field. Predefined and computed workflow recipients are always enforced and cannot be overridden.","type":"boolean"},"sender_name":{"type":"string","minLength":1,"maxLength":255},"sender_address_id":{"type":"string","minLength":1,"maxLength":255},"sender_address_type":{"type":"string","enum":["Address","Container","Manual"]},"sender_address_text":{"type":"string","minLength":1,"maxLength":2000},"sender_address_manual":{"type":"object","properties":{"line1":{"type":"string","minLength":1},"line2":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"state":{"type":"string","minLength":1,"maxLength":60},"zip":{"type":"string","minLength":1,"maxLength":20},"countryCode":{"type":"string","minLength":2,"maxLength":2},"country":{"type":"string","minLength":2,"maxLength":2}},"required":["line1","city","zip"]},"recipient_name":{"type":"string","minLength":1,"maxLength":255},"recipient_address_id":{"type":"string","minLength":1,"maxLength":255},"recipient_address_type":{"type":"string","enum":["Address","Container","Manual"]},"recipient_address_text":{"type":"string","minLength":1,"maxLength":2000},"recipient_address_manual":{"type":"object","properties":{"line1":{"type":"string","minLength":1},"line2":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"state":{"type":"string","minLength":1,"maxLength":60},"zip":{"type":"string","minLength":1,"maxLength":20},"countryCode":{"type":"string","minLength":2,"maxLength":2},"country":{"type":"string","minLength":2,"maxLength":2}},"required":["line1","city","zip"]},"double_sided":{"type":"boolean"},"color":{"type":"boolean"},"mail_class":{"type":"string","enum":["standard","priority","express"]},"certified":{"type":"boolean"},"certified_return_receipt":{"type":"boolean"}},"required":["slug","sender_name","sender_address_type"],"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"openWorldHint":true},"definitionHash":"5590ad8f24ac83d425b4749b339460c09cb6ed7a50dc1fecb815f44a383bc895","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:46:38.785Z","metadataTrust":"untrusted"},{"serverName":"com.postalform/postalform","endpointFingerprint":"1fca818b5a75121bd555e37e93c58cad561dc63111ba2e1f2dee03dae94b559e","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_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.","inputSchema":{"type":"object","properties":{"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)$"},"letter":{"type":"object","properties":{"title":{"type":"string","maxLength":200},"body":{"type":"string","minLength":1,"maxLength":20000},"signature":{"anyOf":[{"type":"string","maxLength":2000},{"type":"object","properties":{"mode":{"type":"string","enum":["typed","drawn"]},"text":{"type":"string","maxLength":2000},"dataUrl":{"type":"string"},"printDataUrl":{"type":"string"}},"additionalProperties":false}]},"render":{"type":"object","properties":{"paper":{"type":"string","const":"letter"},"font_size":{"type":"integer","minimum":9,"maximum":14},"margin_in":{"type":"number","minimum":0.5,"maximum":1.5},"font":{"type":"string","enum":["times","helvetica"]}}}},"required":["body"]},"sender_name":{"type":"string","minLength":1,"maxLength":255},"sender_address_id":{"type":"string","minLength":1,"maxLength":255},"sender_address_type":{"type":"string","enum":["Address","Container","Manual"]},"sender_address_text":{"type":"string","minLength":1,"maxLength":2000},"sender_address_manual":{"type":"object","properties":{"line1":{"type":"string","minLength":1},"line2":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"state":{"type":"string","minLength":1,"maxLength":60},"zip":{"type":"string","minLength":1,"maxLength":20},"countryCode":{"type":"string","minLength":2,"maxLength":2},"country":{"type":"string","minLength":2,"maxLength":2}},"required":["line1","city","zip"]},"recipient_name":{"type":"string","minLength":1,"maxLength":255},"recipient_address_id":{"type":"string","minLength":1,"maxLength":255},"recipient_address_type":{"type":"string","enum":["Address","Container","Manual"]},"recipient_address_text":{"type":"string","minLength":1,"maxLength":2000},"recipient_address_manual":{"type":"object","properties":{"line1":{"type":"string","minLength":1},"line2":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"state":{"type":"string","minLength":1,"maxLength":60},"zip":{"type":"string","minLength":1,"maxLength":20},"countryCode":{"type":"string","minLength":2,"maxLength":2},"country":{"type":"string","minLength":2,"maxLength":2}},"required":["line1","city","zip"]},"double_sided":{"type":"boolean"},"color":{"type":"boolean"},"mail_class":{"type":"string","enum":["standard","priority","express"]},"certified":{"type":"boolean"},"certified_return_receipt":{"type":"boolean"},"payment_protocol":{"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.","type":"string","enum":["hosted","mpp"]},"buyer_name":{"description":"Receipt name; defaults to sender_name for MPP.","type":"string","minLength":1,"maxLength":256},"buyer_email":{"description":"Required for MPP receipt delivery.","type":"string","maxLength":256,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"required":["letter","sender_name","sender_address_type","recipient_name","recipient_address_type"],"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"openWorldHint":true},"definitionHash":"0f321732c07a7d6106d0a08936c7ec5f4b8412c34527c0ba261856de6b38813f","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:46:38.785Z","metadataTrust":"untrusted"},{"serverName":"com.postalform/postalform","endpointFingerprint":"1fca818b5a75121bd555e37e93c58cad561dc63111ba2e1f2dee03dae94b559e","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 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.","inputSchema":{"type":"object","properties":{"payment_protocol":{"description":"Direct machine payment protocol. Use mpp for Link CLI/Link MCP or Stripe SPT; use x402 for x402 wallet clients. Defaults to mpp.","type":"string","enum":["mpp","x402"]},"request_id":{"description":"Idempotency key. Reuse the same value and same order fields after a payment challenge.","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_name":{"type":"string","minLength":1,"maxLength":256,"description":"Buyer name for receipts."},"buyer_email":{"type":"string","maxLength":256,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$","description":"Buyer email for receipts."},"pdf":{"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.","anyOf":[{"type":"object","properties":{"download_url":{"type":"string","format":"uri"},"file_id":{"type":"string"}},"required":["download_url","file_id"]},{"type":"object","properties":{"upload_token":{"type":"string","minLength":1}},"required":["upload_token"]},{"type":"string","minLength":1}]},"letter":{"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.","type":"object","properties":{"title":{"type":"string","maxLength":200},"body":{"type":"string","minLength":1,"maxLength":20000},"signature":{"anyOf":[{"type":"string","maxLength":2000},{"type":"object","properties":{"mode":{"type":"string","enum":["typed","drawn"]},"text":{"type":"string","maxLength":2000},"dataUrl":{"type":"string"},"printDataUrl":{"type":"string"}},"additionalProperties":false}]},"render":{"type":"object","properties":{"paper":{"type":"string","const":"letter"},"font_size":{"type":"integer","minimum":9,"maximum":14},"margin_in":{"type":"number","minimum":0.5,"maximum":1.5},"font":{"type":"string","enum":["times","helvetica"]}}},"format":{"type":"string","enum":["text","html","markdown","rtf"]}},"required":["body"]},"form":{"description":"Workflow form payload from postalform.get_form_schema. Provide exactly one of pdf, letter, or form.","type":"object","properties":{"slug":{"type":"string","minLength":1},"fields":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"file_name":{"type":"string","minLength":1,"maxLength":255},"content_type":{"type":"string","minLength":1},"base64":{"type":"string","minLength":1}},"required":["id","base64"]}}},"required":["slug"]},"bulk":{"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.","type":"object","properties":{"campaign_name":{"type":"string","maxLength":255},"csv_content":{"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.","type":"string","minLength":1},"recipients":{"description":"JSON recipient list, mutually exclusive with csv_content. Each address can include merge_fields for text/HTML templates.","minItems":1,"type":"array","items":{"type":"object","properties":{"recipient_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"line1":{"type":"string","minLength":1},"line2":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"type":"string","minLength":1},"state":{"description":"Required for US and Canadian recipients. Omit or send null elsewhere.","anyOf":[{"type":"string"},{"type":"null"}]},"zip":{"type":"string","minLength":1,"description":"ZIP/postal code as a string, preserving leading zeros."},"country":{"description":"Mailing country code. Defaults to US.","anyOf":[{"type":"string"},{"type":"null"}]},"merge_fields":{"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.","type":"object","propertyNames":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}},"required":["line1","city","zip"],"additionalProperties":false}},"content_mode":{"type":"string","enum":["text","html","pdf"],"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."},"template_text":{"description":"Plain-text letter template. {{field}} inserts a merge value; HTML is not allowed.","type":"string"},"template_html":{"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.","type":"string"}},"required":["content_mode"],"additionalProperties":false},"file_name":{"type":"string","minLength":1,"maxLength":255},"sender_name":{"type":"string","minLength":1,"maxLength":255},"sender_address_id":{"type":"string","minLength":1},"sender_address_type":{"type":"string","enum":["Address","Manual"]},"sender_address_text":{"type":"string","minLength":1,"maxLength":2000},"sender_address_manual":{"type":"object","properties":{"line1":{"type":"string","minLength":1},"line2":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"state":{"type":"string","minLength":1,"maxLength":60},"zip":{"type":"string","minLength":1,"maxLength":20},"countryCode":{"type":"string","minLength":2,"maxLength":2},"country":{"type":"string","minLength":2,"maxLength":2}},"required":["line1","city","zip"]},"recipient_name":{"description":"Required for a single recipient. Omit when bulk supplies the recipient list.","type":"string","minLength":1,"maxLength":255},"recipient_address_id":{"type":"string","minLength":1},"recipient_address_type":{"type":"string","enum":["Address","Manual"]},"recipient_address_text":{"type":"string","minLength":1,"maxLength":2000},"recipient_address_manual":{"type":"object","properties":{"line1":{"type":"string","minLength":1},"line2":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"state":{"type":"string","minLength":1,"maxLength":60},"zip":{"type":"string","minLength":1,"maxLength":20},"countryCode":{"type":"string","minLength":2,"maxLength":2},"country":{"type":"string","minLength":2,"maxLength":2}},"required":["line1","city","zip"]},"double_sided":{"type":"boolean"},"color":{"type":"boolean"},"mail_class":{"type":"string","enum":["standard","priority","express"]},"certified":{"type":"boolean"},"certified_return_receipt":{"type":"boolean"},"signature_required":{"type":"boolean"},"mailpiece_type":{"type":"string","enum":["letter","postcard"]},"postcard_size":{"type":"string","enum":["4x6","6x9","11x6"]},"payment_authorization":{"description":"MPP retry value after paying with Link CLI/Link MCP. Pass the full Authorization header value, usually \"Payment ...\".","type":"string","minLength":1},"payment_signature":{"description":"x402 retry value after paying the PAYMENT-REQUIRED challenge.","type":"string","minLength":1}},"required":["buyer_name","buyer_email","sender_name"],"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"openWorldHint":true},"definitionHash":"d48acfb5aad3815120aa2bfa2f6102ca0238982b6c62cf2aa58756c9954d0a6f","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:46:38.785Z","metadataTrust":"untrusted"},{"serverName":"com.postalform/postalform","endpointFingerprint":"1fca818b5a75121bd555e37e93c58cad561dc63111ba2e1f2dee03dae94b559e","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 postalform.pay_order with the order_id after buyer approval. Draft creation never pays. For x402, use postalform.create_machine_order.","inputSchema":{"type":"object","properties":{"payment_protocol":{"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.","type":"string","enum":["hosted","mpp"]},"buyer_name":{"description":"Receipt name; defaults to sender_name for MPP.","type":"string","minLength":1,"maxLength":256},"buyer_email":{"description":"Required for MPP receipt delivery.","type":"string","maxLength":256,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"request_id":{"description":"Optional idempotency key. Reuse the same value if retrying the call.","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)$"},"pdf":{"anyOf":[{"type":"object","properties":{"download_url":{"type":"string","format":"uri"},"file_id":{"type":"string"}},"required":["download_url","file_id"]},{"type":"object","properties":{"upload_token":{"type":"string","minLength":1}},"required":["upload_token"]},{"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."},"file_name":{"description":"Optional display file name.","type":"string","minLength":1,"maxLength":255},"sender_name":{"type":"string","minLength":1,"maxLength":255,"description":"Sender's name (return address)."},"sender_address_id":{"description":"Loqate address id for the sender (required when sender_address_type is Address).","type":"string","minLength":1,"maxLength":255},"sender_address_type":{"type":"string","enum":["Address","Container","Manual"],"description":"Address suggestion type for the sender (from postalform.search_addresses). Use Manual to pass a structured address with countryCode when outside the US."},"sender_address_text":{"description":"Human-readable sender address preview (required when sender_address_type is Address; optional for Manual).","type":"string","minLength":1,"maxLength":2000},"sender_address_manual":{"description":"Sender manual address fields (required when sender_address_type is Manual).","type":"object","properties":{"line1":{"type":"string","minLength":1},"line2":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"state":{"type":"string","minLength":1,"maxLength":60},"zip":{"type":"string","minLength":1,"maxLength":20},"countryCode":{"type":"string","minLength":2,"maxLength":2},"country":{"type":"string","minLength":2,"maxLength":2}},"required":["line1","city","zip"]},"sender_company":{"description":"Optional company, department or attention line printed under sender_name in the return address (at most 40 characters).","type":"string","minLength":1,"maxLength":40},"recipient_name":{"type":"string","minLength":1,"maxLength":255,"description":"Recipient's name."},"recipient_company":{"description":"Optional company, department or attention line printed under recipient_name, for example \"Acme Corp, ATTN: Legal\" (at most 40 characters).","type":"string","minLength":1,"maxLength":40},"recipient_address_id":{"description":"Loqate address id for the recipient (required when recipient_address_type is Address).","type":"string","minLength":1,"maxLength":255},"recipient_address_type":{"type":"string","enum":["Address","Container","Manual"],"description":"Address suggestion type for the recipient (from postalform.search_addresses). Use Manual to pass a structured address with countryCode when outside the US."},"recipient_address_text":{"description":"Human-readable recipient address preview (required when recipient_address_type is Address; optional for Manual).","type":"string","minLength":1,"maxLength":2000},"recipient_address_manual":{"description":"Recipient manual address fields (required when recipient_address_type is Manual).","type":"object","properties":{"line1":{"type":"string","minLength":1},"line2":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"state":{"type":"string","minLength":1,"maxLength":60},"zip":{"type":"string","minLength":1,"maxLength":20},"countryCode":{"type":"string","minLength":2,"maxLength":2},"country":{"type":"string","minLength":2,"maxLength":2}},"required":["line1","city","zip"]},"double_sided":{"description":"Whether to print double-sided (default: true).","type":"boolean"},"color":{"description":"Whether to print in color (default: false).","type":"boolean"},"mail_class":{"description":"Mail service level (standard, priority, express).","type":"string","enum":["standard","priority","express"]},"certified":{"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).","type":"boolean"},"certified_return_receipt":{"description":"Add Electronic Return Receipt for US Certified Mail. Ignored for Canada Post Registered Mail and PinGen registered-mail destinations (default: false).","type":"boolean"}},"required":["pdf","sender_name","sender_address_type","recipient_name","recipient_address_type"],"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"openWorldHint":true},"definitionHash":"cf3325202d1d6998144848b36e667be5880f7c533f3d4176fc73cc5355457038","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:46:38.785Z","metadataTrust":"untrusted"},{"serverName":"com.postalform/postalform","endpointFingerprint":"1fca818b5a75121bd555e37e93c58cad561dc63111ba2e1f2dee03dae94b559e","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.","inputSchema":{"type":"object","properties":{"request_id":{"description":"Optional idempotency key. Reuse the same value if retrying the call.","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)$"},"file_name":{"description":"Optional original file name.","type":"string","minLength":1,"maxLength":255},"content_type":{"description":"Optional content type hint (application/pdf).","type":"string","minLength":1,"maxLength":255},"content_length":{"description":"Optional content length in bytes.","type":"integer","minimum":0,"maximum":9007199254740991}},"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"openWorldHint":true},"definitionHash":"71b0b804ea00fe465aef1a3ab5cb4ecb7eadcd745121305b859f8f571e0b373a","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:46:38.785Z","metadataTrust":"untrusted"},{"serverName":"com.postalform/postalform","endpointFingerprint":"1fca818b5a75121bd555e37e93c58cad561dc63111ba2e1f2dee03dae94b559e","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).","inputSchema":{"type":"object","properties":{"slug":{"type":"string","minLength":1,"description":"Workflow slug (e.g. \"8822\")."}},"required":["slug"],"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"98deb8bfca156a4c1e6ac34846a534d5c66d6c5dedce8ad12dd3a616055b0b43","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:46:38.785Z","metadataTrust":"untrusted"},{"serverName":"com.postalform/postalform","endpointFingerprint":"1fca818b5a75121bd555e37e93c58cad561dc63111ba2e1f2dee03dae94b559e","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 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.","inputSchema":{"type":"object","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."}},"required":["order_id"],"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"988de4eaddb4f2be998161c1c0cca6788df6b60b5b49a43cea0a7878ae1cfabd","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:46:38.785Z","metadataTrust":"untrusted"},{"serverName":"com.postalform/postalform","endpointFingerprint":"1fca818b5a75121bd555e37e93c58cad561dc63111ba2e1f2dee03dae94b559e","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.","inputSchema":{"type":"object","properties":{"q":{"description":"Optional search query (matches slug/name).","type":"string"},"limit":{"description":"Max results (default 50).","type":"integer","exclusiveMinimum":0,"maximum":200},"cursor":{"description":"Pagination cursor (opaque string).","type":"string"}},"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"46393fc26121c82996e26916d907e76916d3209e21201a77dc971d42dff4da6b","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:46:38.785Z","metadataTrust":"untrusted"},{"serverName":"com.postalform/postalform","endpointFingerprint":"1fca818b5a75121bd555e37e93c58cad561dc63111ba2e1f2dee03dae94b559e","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 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.","inputSchema":{"type":"object","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":{"description":"Buyer-approved MPP Authorization header, usually Payment ... . Omit to retrieve the challenge.","type":"string","minLength":1}},"required":["order_id"],"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"openWorldHint":true},"definitionHash":"2e1af985b6b5aa7ce54bd4b034c3edfd98554d8642b2aa73daff9cdae36193c3","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:46:38.785Z","metadataTrust":"untrusted"},{"serverName":"com.postalform/postalform","endpointFingerprint":"1fca818b5a75121bd555e37e93c58cad561dc63111ba2e1f2dee03dae94b559e","name":"postalform.ping","title":"Ping PostalForm","description":"Use this when you want a quick health check that the PostalForm MCP server is reachable.","inputSchema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"0763a62088c370cdbc9544331f26bfcca5d710631f27450418be0b216010cce0","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:46:38.785Z","metadataTrust":"untrusted"},{"serverName":"com.postalform/postalform","endpointFingerprint":"1fca818b5a75121bd555e37e93c58cad561dc63111ba2e1f2dee03dae94b559e","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.","inputSchema":{"type":"object","properties":{"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)$"},"letter":{"type":"object","properties":{"title":{"type":"string","maxLength":200},"body":{"type":"string","minLength":1,"maxLength":20000},"signature":{"anyOf":[{"type":"string","maxLength":2000},{"type":"object","properties":{"mode":{"type":"string","enum":["typed","drawn"]},"text":{"type":"string","maxLength":2000},"dataUrl":{"type":"string"},"printDataUrl":{"type":"string"}},"additionalProperties":false}]},"render":{"type":"object","properties":{"paper":{"type":"string","const":"letter"},"font_size":{"type":"integer","minimum":9,"maximum":14},"margin_in":{"type":"number","minimum":0.5,"maximum":1.5},"font":{"type":"string","enum":["times","helvetica"]}}}},"required":["body"]},"sender_name":{"type":"string","minLength":1,"maxLength":255},"sender_address_id":{"type":"string","minLength":1,"maxLength":255},"sender_address_type":{"type":"string","enum":["Address","Container","Manual"]},"sender_address_text":{"type":"string","minLength":1,"maxLength":2000},"sender_address_manual":{"type":"object","properties":{"line1":{"type":"string","minLength":1},"line2":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"state":{"type":"string","minLength":1,"maxLength":60},"zip":{"type":"string","minLength":1,"maxLength":20},"countryCode":{"type":"string","minLength":2,"maxLength":2},"country":{"type":"string","minLength":2,"maxLength":2}},"required":["line1","city","zip"]},"recipient_name":{"type":"string","minLength":1,"maxLength":255},"recipient_address_id":{"type":"string","minLength":1,"maxLength":255},"recipient_address_type":{"type":"string","enum":["Address","Container","Manual"]},"recipient_address_text":{"type":"string","minLength":1,"maxLength":2000},"recipient_address_manual":{"type":"object","properties":{"line1":{"type":"string","minLength":1},"line2":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"state":{"type":"string","minLength":1,"maxLength":60},"zip":{"type":"string","minLength":1,"maxLength":20},"countryCode":{"type":"string","minLength":2,"maxLength":2},"country":{"type":"string","minLength":2,"maxLength":2}},"required":["line1","city","zip"]},"double_sided":{"type":"boolean"},"color":{"type":"boolean"},"mail_class":{"type":"string","enum":["standard","priority","express"]},"certified":{"type":"boolean"},"certified_return_receipt":{"type":"boolean"}},"required":["letter","sender_name","sender_address_type","recipient_name","recipient_address_type"],"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"definitionHash":"cb1809601a126b5b2c76ebb832fd5e59ee1f958c7dc866059c55bb532b918608","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:46:38.785Z","metadataTrust":"untrusted"},{"serverName":"com.postalform/postalform","endpointFingerprint":"1fca818b5a75121bd555e37e93c58cad561dc63111ba2e1f2dee03dae94b559e","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.","inputSchema":{"type":"object","properties":{"target":{"description":"Which address field is being searched (used for UI context).","type":"string","enum":["sender","recipient"]},"query":{"type":"string","minLength":3,"description":"Partial address text, e.g. \"123 Main St\""},"country_code":{"description":"Two-letter country code to filter suggestions. Defaults to US.","type":"string","minLength":2,"maxLength":2},"container":{"description":"Loqate container id for drilling into suggestions, if provided","type":"string"}},"required":["query"],"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"4693b783016a874f78b063b282f44203033b8740eb78f99360de36dac3e17511","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T18:46:38.785Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"1fca818b5a75121bd555e37e93c58cad561dc63111ba2e1f2dee03dae94b559e","protocol":"streamable-http","status":"indexed","toolCount":13,"observedAt":"2026-11-16T18:46:38.785Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"com.postalform/postalform":{"url":"https://postalform.com/mcp"}}},"Cursor":{"mcpServers":{"com.postalform/postalform":{"url":"https://postalform.com/mcp"}}},"VS Code":{"servers":{"com.postalform/postalform":{"type":"http","url":"https://postalform.com/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://postalform.com/mcp"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:com.postalform%2Fpostalform","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/com.postalform%2Fpostalform","name":"com.postalform/postalform","description":"Create mail drafts, upload PDFs, browse forms, track orders, and pay via MPP or x402.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://postalform.com/mcp"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":"https://postalform.com/developers","repositoryUrl":null,"version":"0.1.0"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"com.postalform/postalform","status":"online","lastCheckedAt":"2026-11-20T07:17:10.095Z","lastSuccessfulCheck":"2026-11-20T07:17:10.095Z","latencyMs":82,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T07:17:10.095Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T07:17:10.095Z"},"security":null,"timestamps":{"createdAt":"2026-09-27T19:32:34.612Z","updatedAt":"2026-09-27T19:32:34.612Z","observedAt":"2026-11-20T07:17:10.095Z"},"compatibility":{"serverVersion":"0.1.0","protocolVersions":[{"protocol":"mcp","version":null}]}}}}