{"name":"mailbox.bot","version":"1.0.1","protocolVersion":"2025-11-25","description":"mailbox.bot MCP server — MCP server lets AI agents send physical mail. The postal mail API for AI agents and software workflows. Send letters, certified mail, postcards, and documents from code. 19 tools over JSON-RPC 2.0 POST.","tools":19,"endpoint":"https://mailbox.bot/api/mcp","transport":"streamable-http","auth":{"type":"bearer","header":"Authorization: Bearer <api_key>","agent_prefix":"sk_agent_","test_agent_prefix":"sk_agent_test_","member_prefix":"sk_live_"},"install_guide":"https://mailbox.bot/mcp-install","public_tool_catalog":"https://mailbox.bot/api/mcp/tools-public","server_card":"https://mailbox.bot/.well-known/mcp/server-card.json","discovery":"https://mailbox.bot/.well-known/mcp.json","docs":"https://mailbox.bot/mcp-install","full_reference":"https://mailbox.bot/llms-full.txt","openapi_json":"https://mailbox.bot/openapi.json","openapi_yaml":"https://mailbox.bot/openapi.yaml","instructions":"MCP server lets AI agents send live outbound letters, certified mail, postcards, notices, and documents with dry runs, approval gates, cost caps, tracking, proof, cancellation before printing, and webhooks. Use list_inbound_forwarding_addresses for the live member-scoped digital intake alias and list_inbound_mail/get_inbound_mail for forwarded OCR context from an address the operator already controls; pass inbound_capture_id or postal_mail_thread_id into send_outbound_mail to preserve reply lineage. New mailbox.bot-issued physical receiving, street, and package addresses: Not live yet · Launch ETA: mid/late September. Reservations are open, with capacity-based assignment for approved accounts after required verification and postal authorization. This status applies to new issuance only. Physical custody at an already-assigned PMB remains a separate account-enabled, live-only REST contract and is not exposed through MCP or sandbox tools. Use get_usage to read prepaid balance; agents cannot buy credits, access Stripe, view card data, or change Auto-Fill settings. Eligible live orders may trigger bounded server-managed Auto-Fill only after the human separately enables it. Use dry_run=true for previews, requires_approval=true for sensitive mail, cancel_outbound_mail for eligible queued cancellations before printing, update_webhook for callbacks, and outbound sandbox lifecycle tools to rehearse submitted -> ready -> mailed -> delivered without credit debits or physical fulfillment. Explicit Business mail runs remain REST-only."}