mailbox.bot MCP server

Official Model Context Protocol (MCP) server manifest for mailbox.bot — a physical postal mail API for AI agents. Send certified mail, letters, notices, and postcards — we print, stamp, and mail them with photos scanned and tracked. Turn your business mailbox address, PO Box, home office address, or virtual mailbox into inbound agentic context. Get a new postal receiving mailbox address is in private beta.

Send letters, certified mail, and packages from your agent. Sandbox keys for zero-charge testing on the same production endpoints.

• Website: https://mailbox.bot

• Install: https://mailbox.bot/mcp-install

• Docs: https://mailbox.bot/api-docs

• Registry: bot.mailbox/mailbox (DNS-verified on mailbox.bot)

What this repo is

This repository holds the public server.json manifest published to the official MCP Registry. The production server itself is hosted at https://mailbox.bot/api/mcp (streamable HTTP transport).

The repo also includes a small local stdio adapter (server.js) so registries such as Glama can start the server locally and inspect the mailbox.bot tool definitions. Production users should connect to the hosted endpoint.

If you're trying to use the server, go to mailbox.bot/mcp-install for client-specific setup (Claude Code, Claude Desktop, Cursor, etc.).

Related MCP server: slack-indexed

Local registry check

npm start

This starts a stdio MCP adapter for introspection. Authenticated tool calls should use the hosted streamable HTTP MCP endpoint at https://mailbox.bot/api/mcp.

Verifying authenticity

The namespace bot.mailbox/* is reserved via DNS proof on the apex domain mailbox.bot. Only the domain owner can publish servers under this namespace to the MCP Registry. If you see another server claiming to be mailbox.bot under a different namespace, it is not official.

The canonical manifest lives in this repo and is mirrored to the registry — both should match exactly.

Capabilities

• Outbound mail — send first-class letters, certified postal mail, and other USPS / FedEx / UPS classes from a PDF or a few common document formats.

• Inbound mail — receive, scan, forward, and shred physical mail at a US address in private beta.

• Sandbox mode — sk_agent_test_ keys exercise the full lifecycle (fulfillment photos, tracking, dispatch) with zero charge.

• Cost controls — dry_run cost preview, X-Max-Cost-Cents cap, per-key daily piece limits, structured retryable errors.

• Webhooks — signed delivery events with full payload inspection via REST.

Full tool list and schemas: see the docs and the OpenAPI spec at mailbox.bot/openapi.json.

License

MIT — covers this manifest and any examples added to this repo. The mailbox.bot service itself is operated under the mailbox.bot terms.

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• add_noteA
• add_tagA
• advance_test_outbound_mailA
• create_ruleA
• create_test_outbound_mailA
• get_facility_messagesA
• get_inbound_mailA
• get_mailboxA