{"schema_version":"v1","name":"postalform","title":"PostalForm MCP Server","version":"0.1.0","protocol":"mcp","protocol_version":"2025-11-25","description":"PostalForm MCP server for creating hosted-checkout mail drafts, uploading PDFs, browsing forms, tracking order status, and creating agent-paid MPP/x402 machine orders.","endpoint":"https://postalform.com/mcp","transport":{"type":"streamable-http","endpoint":"https://postalform.com/mcp"},"server_card_url":"https://postalform.com/.well-known/mcp/server-card.json","skill_url":"https://postalform.com/skill.md","llms_url":"https://postalform.com/llms.txt","llms_full_url":"https://postalform.com/llms-full.txt","documentation_url":"https://postalform.com/developers","agents_guide_url":"https://postalform.com/agents","pricing_calculator_url":"https://postalform.com/pricing-calculator","openapi_url":"https://postalform.com/openapi.json","authentication":{"type":"none","note":"No API key is required for the hosted MCP endpoint today. Draft tools use hosted checkout; autonomous payment tools require an MPP or x402 payment credential on retry."},"integrations":{"chatgpt":{"label":"ChatGPT and OpenAI Responses API","setup":"Configure a remote MCP server with server_url set to https://postalform.com/mcp. Prefer hosted-checkout draft tools unless the owner explicitly approved autonomous payment.","recommended_tools":["postalform.create_letter_order_draft","postalform.create_order_draft","postalform.create_form_order_draft","postalform.get_order_status"]},"gemini":{"label":"Gemini SDKs and Gemini CLI","setup":"Use a Gemini MCP-capable client with the streamable HTTP endpoint https://postalform.com/mcp. Gemini CLI can add it as an http transport server.","recommended_tools":["postalform.create_letter_order_draft","postalform.create_order_draft","postalform.create_form_order_draft","postalform.get_order_status"]},"generic_mcp":{"label":"Any MCP client that supports remote streamable HTTP","setup":"Add PostalForm with transport streamable-http and endpoint https://postalform.com/mcp. Read skill_url before sending real mail."}},"works_with":["ChatGPT","OpenAI Responses API","Gemini SDKs","Gemini CLI","Claude","Claude Code","Codex","Cursor","Windsurf","Cline","Replit","OpenClaw","Hermes","n8n","LangChain"],"tools":[{"name":"postalform.create_letter_order_draft","description":"Create a hosted-checkout draft from letter text. Best default for chat clients."},{"name":"postalform.create_order_draft","description":"Create a hosted-checkout draft from a PDF upload or file URL."},{"name":"postalform.create_form_order_draft","description":"Create a hosted-checkout draft from a published workflow form payload."},{"name":"postalform.create_machine_order","description":"Create or pay a direct MPP/x402 machine order. Use only in authorized autonomous runtimes with spend controls."},{"name":"postalform.get_order_status","description":"Poll paid order or draft status."}],"capabilities":{"tools":true,"resources":true,"hosted_checkout":true,"machine_payments":["mpp","x402"]}}