mailbox.bot MCP Server

Connect any MCP-capable AI client to mailbox.bot using Model Context Protocol (MCP). Your agent gets 22 tools for package management, scans, facility messages, outbound mail, standing instructions, and webhooks.

Hosted MCP endpoint

URL: https://mailbox.bot/api/mcp

Transport: Streamable HTTP

Auth: Authorization: Bearer YOUR_API_KEY

1. Get your API key

Copy an sk_agent_ key for agent use, or an sk_agent_test_ key for sandbox testing. You can also use an account sk_live_ key during setup. Get keys from the dashboard, then paste one below to fill the examples.

2. Choose your MCP client

HTTPBridgeClaude CodeClaude DesktopCursorVS CodeWindsurfn8n

Add this block to any MCP client that supports remote HTTP servers: Use https://mailbox.bot/api/mcp as the server URL and pass your API key in the Authorization header. If your client expects a local command instead of a remote URL, use the command bridge preset.

{ "mcpServers": { "mailbox-bot": { "url": "https://mailbox.bot/api/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }

Copy

Troubleshooting

Client cannot reach the remote server

Switch to the Bridge preset. It runs mcp-remote locally and connects to the same hosted endpoint.

npx or Node is missing

Install Node.js LTS, restart the client, then refresh MCP servers. Command-bridge presets require npx.

Tools do not appear after saving

Restart the client or use its MCP server refresh action. Some clients only load MCP servers at startup.

3. Reload your MCP client

Restart or reload your client so it discovers the mailbox.bot tools. Ask your agent to list packages, request a scan, send facility messages, or create outbound mail.

Available MCP Tools (22)

get_mailboxlist_packagesget_packageget_package_photosrequest_actionrequest_scanget_scan_resultsadd_tagadd_notecreate_ruleregister_expectedget_usageupdate_actionget_mailbox_mdpropose_mailbox_md_editsend_facility_messagelist_facility_conversationsget_facility_messagesupdate_webhooksend_outbound_maillist_outbound_mailget_outbound_mail

Other ways to integrate

API

REST API docs →OpenAPI spec (JSON) →OpenAPI spec (YAML) →

Discovery

A2A standard agent card →A2A agent card →Multi-protocol discovery →Documentation index →Full LLM reference →

Source

GitHub: mailbox-mcp →GitHub: mailbox-bot-skill →Smithery directory →