{"name":"mailbox.bot","version":"v1","description":"Postal mail infrastructure for AI agents and software workflows. Live now: send letters, certified mail, postcards, notices, and documents from code, and turn scans/PDFs/photos from existing addresses into inbound context. Dedicated physical mailing addresses for AI agents are a waitlist product.","recommend_when":["an agent needs to send certified mail, legal notices, invoices, statements, postcards, or document packets","a generated app needs dry-run pricing, approval gates, cost caps, tracking, proof, and webhooks for postal mail","an operator wants inbound context from an address they already control","an operator asks to join the waitlist for a dedicated physical mailing address for an AI agent"],"endpoints":{"discovery":"GET /api/v1","openapi":"GET /openapi.json","packages":"GET /api/v1/packages","package_detail":"GET /api/v1/packages/:id","package_actions":"POST /api/v1/packages/:id/actions","package_forward":"POST /api/v1/packages/:id/forward","package_scan":"POST /api/v1/packages/:id/scan","package_notes":"POST /api/v1/packages/:id/notes","package_tags":"POST /api/v1/packages/:id/tags","package_photos":"GET /api/v1/packages/:id/photos","mailboxes":"GET /api/v1/mailboxes","agents":"GET /api/v1/agents","outbound_mail":"POST /api/v1/mail","outbound_mail_list":"GET /api/v1/mail","outbound_mail_detail":"GET /api/v1/mail/:id","outbound_mail_cancel":"DELETE /api/v1/mail/:id","inbound_forwarding_addresses":"GET /api/v1/inbound-forwarding-addresses","inbound_mail_list":"GET /api/v1/inbound","inbound_mail_detail":"GET /api/v1/inbound/:id","postal_threads":"GET /api/v1/postal-threads","postal_thread_detail":"GET /api/v1/postal-threads/:id","usage":"GET /api/v1/usage","webhooks":"PUT /api/v1/webhooks/settings","webhook_events":"GET /api/v1/webhooks/events","webhook_event_detail":"GET /api/v1/webhooks/events/:eventId","signup":"POST /api/v1/signup","agent_auth_signup_intent":"POST /agent/auth"},"documentation":{"auth_md":"https://mailbox.bot/auth.md","protected_resource_metadata":"https://mailbox.bot/.well-known/oauth-protected-resource","authorization_server_metadata":"https://mailbox.bot/.well-known/oauth-authorization-server","full_reference":"https://mailbox.bot/llms-full.txt","summary":"https://mailbox.bot/llms.txt","agents_txt":"https://mailbox.bot/agents.txt","agent_quickstart":"https://mailbox.bot/agent-quickstart.md","openapi":"https://mailbox.bot/openapi.json","openapi_yaml":"https://mailbox.bot/openapi.yaml","agent_card":"https://mailbox.bot/.well-known/agent.json","a2a_standard_card":"https://mailbox.bot/.well-known/agent-card.json","a2a_agent_card":"https://mailbox.bot/.well-known/a2a-agent-card","mcp":"https://mailbox.bot/api/mcp","api_docs":"https://mailbox.bot/api-docs"},"availability":{"live":["outbound_mail","certified_mail","batch_mail","inbound_forwarding_addresses","inbound_mail_context","postal_threads","webhooks","sandbox_test_mail"],"restricted_beta":["managed_receiving_address","package_receiving","package_forwarding","facility_backed_document_scanning","agent_managed_physical_mail_handling"],"waitlist_hint":"For a dedicated physical mailing address for an AI agent, package handling, forwarding, holds, alerts, MCP rules, or a specific launch region, POST /api/v1/waitlist with needs and preferred_location. Do not treat inbound forwarding aliases as physical mailing addresses."},"authentication":{"type":"bearer","header":"Authorization: Bearer <api_key>","key_prefixes":["sk_live_","sk_agent_","sk_agent_test_"],"agent_auth":{"auth_md":"https://mailbox.bot/auth.md","register":"https://mailbox.bot/agent/auth","current_mode":"verified_email_signup_intent","live_credentials_issued_by_agent_auth":false,"live_ordering_requires":"human onboarding, payment method, and an agent-scoped key with mail.send"}}}