{"name":"mailbox.bot","description":"Postal mail infrastructure for AI agents and software workflows. Live now: send letters, certified mail, postcards, notices, and documents through REST or MCP (19 public tools) with dry-run pricing, approval gates, cost caps, tracking, proof, cancellation, and webhooks, and use forwarded digital/OCR context from an address the operator already controls. New mailbox.bot-issued physical receiving, street, and package addresses: Not live yet · Launch ETA: mid/late September. Reservations are open. Physical custody for approved accounts with an already-assigned PMB remains account-enabled, live-only, and REST-only.","version":"1.2.0","site_url":"https://mailbox.bot","api_base_url":"https://mailbox.bot/api","capability_guidance":{"live_now":["outbound print-and-mail API","digital inbound forwarding, OCR, and postal threads","sandbox outbound lifecycle simulation","REST, MCP, webhooks, dashboard, and OpenClaw discovery"],"account_enabled":["physical inbound custody at an assigned PMB","Open & Scan through canonical REST routes"],"new_address_issuance":{"status":"Not live yet · Launch ETA: mid/late September","reservation":"Reservations are open; assignment is capacity-based for approved accounts after required verification and postal authorization.","boundary":"This status applies to new mailbox.bot-issued physical receiving, street, and package addresses only; already-assigned PMB custody remains account-enabled, live-only, and REST-only."}},"protocols":{"mcp":{"endpoint":"https://mailbox.bot/api/mcp","tool_catalog":"https://mailbox.bot/api/mcp/tools-public","version":"2025-11-25","transport":"streamable-http","boundary":"Physical inbound custody is not exposed through MCP."},"rest":{"endpoint":"https://mailbox.bot/api/v1","discovery":"https://mailbox.bot/api/v1","openapi":"https://mailbox.bot/openapi.json","version":"v1"},"openclaw":{"agent_card":"https://mailbox.bot/.well-known/agent.json"},"webhooks":{"signature":"hmac-sha256","header":"X-Mailbox-Signature","settings":"https://mailbox.bot/api/v1/webhooks/settings"}},"auth":{"type":"bearer","member_prefix":"sk_live_","agent_prefix":"sk_agent_","test_agent_prefix":"sk_agent_test_","facility_prefix":"sk_facility_","location":"header"},"endpoints":{"signup":"https://mailbox.bot/api/v1/signup","waitlist":"https://mailbox.bot/api/v1/waitlist","agents":"https://mailbox.bot/api/v1/agents","logical_outbound_mailboxes":"https://mailbox.bot/api/v1/mailboxes","inbound_forwarding_addresses":"https://mailbox.bot/api/v1/inbound-forwarding-addresses","digital_inbound":"https://mailbox.bot/api/v1/inbound","postal_threads":"https://mailbox.bot/api/v1/postal-threads","canonical_physical_inbound":"https://mailbox.bot/api/v1/inbound-items","canonical_physical_inbound_detail":"https://mailbox.bot/api/v1/inbound-items/:id","canonical_physical_inbound_actions":"https://mailbox.bot/api/v1/inbound-items/:id/actions","canonical_physical_inbound_scans":"https://mailbox.bot/api/v1/inbound-items/:id/scans","outbound_mail":"https://mailbox.bot/api/v1/mail","outbound_mail_detail":"https://mailbox.bot/api/v1/mail/:id","usage":"https://mailbox.bot/api/v1/usage","webhooks":"https://mailbox.bot/api/v1/webhooks/settings","webhook_events":"https://mailbox.bot/api/v1/webhooks/events"},"endpoint_boundaries":{"digital_inbound":"/v1/inbound is forwarded files and OCR context from addresses the operator already controls.","logical_outbound_mailboxes":"/v1/mailboxes provisions logical outbound endpoints and does not issue or discover a receiving PMB.","canonical_physical_inbound":"Account-enabled, live-only, REST-only custody at an assigned PMB. Only open_and_scan is callable.","new_managed_address_issuance":"Not live yet · Launch ETA: mid/late September. Reservations are open for new mailbox.bot-issued physical receiving, street, and package addresses."},"physical_inbound":{"supported_action_types":["open_and_scan"],"webhook_events":["inbound.received","inbound.scan_available"],"sandbox":"not_supported","facility_contract":"Physical Inbound — Facility in /openapi.json"},"documentation":{"llms_txt":"https://mailbox.bot/llms.txt","llms_full_txt":"https://mailbox.bot/llms-full.txt","agents_txt":"https://mailbox.bot/agents.txt","api_docs":"https://mailbox.bot/api-docs","openapi_json":"https://mailbox.bot/openapi.json","openapi_yaml":"https://mailbox.bot/openapi.yaml","for_agents":"https://mailbox.bot/for-agents","mcp_install":"https://mailbox.bot/mcp-install","framework_guides":"https://mailbox.bot/for-agents#frameworks"},"contact":"https://mailbox.bot/contact"}