mailbox.bot is an MCP server with 19 tools an agent can call, among them advance_test_outbound_mail, cancel_outbound_mail, create_test_outbound_mail. It answers at https://mailbox.bot/api/mcp over streamable HTTP, and it listed its tools to an anonymous client, so no sign-in was needed for that. Our probes reached it 10 of 10 times since 4 September 2026; the last check, on 17 October 2026, succeeded.
Physical mail API for AI agents. Send letters, certified mail, postcards from code via MCP.
Description as the publisher wrote it.
| Tool | What it does |
|---|---|
advance_test_outbound_mail | Advance a test_mode outbound mail record one lifecycle step and queue the matching webhook. submitted becomes ready with simulated pages/envelope photos; ready becomes mailed with carrier, dispatch method, receipt photo, and tracking when t Inputs: mail_id |
cancel_outbound_mail | Cancel a queued outbound mail job before facility printing starts. If the mail was funded with prepaid credits, eligible credits are returned to the member ledger. Safe to retry: already-cancelled mail returns cancelled status without creat Inputs: mail_id |
create_test_outbound_mail | Create a sandbox outbound mail record without uploading a real document. The record is always test_mode=true, cost_cents=0, includes estimated_live_cost_cents and cost_breakdown, and queues a mail.submitted webhook. USPS First-Class Mail ha Inputs: recipient_name, recipient_company, recipient_line1, recipient_city, recipient_state, recipient_zip |
get_facility_messages | Read the message thread with Austin HQ. Facility routing is automatic. Returns messages in reverse chronological order with sender role (member, facility, agent). Supports cursor-based pagination. Automatically marks facility messages as re Inputs: limit, before |
get_inbound_mail | Get one forwarded inbound mail item with compact draft_context by default. Use this before drafting an outbound reply when you need sender context, reply contact candidates, deadline clues, source files, and thread linkage in one stable pay Inputs: inbound_mail_id, include, signed_urls |
get_mailbox | Get your agent's real mailing address beta endpoint when the account has explicit beta access: street address + mailbox number for approved accounts. For generally available inbound context, use list_inbound_forwarding_addresses instead; th |
get_mailbox_md | Get the renter's MAILBOX.md standing instructions for this agent. Returns the full instruction text, version number, content hash, and last update timestamp. Call this on startup and cache the version — you must pass it to send_outbound_mai |
get_outbound_mail | Get full details of an outbound mail job including recipient address, mail class, page count, cost breakdown, current status, failure metadata, document metadata, and fulfillment photos. Legacy plaintext records may include direct document Inputs: mail_id |
get_postal_thread | Get one physical-mail thread with optional timeline events. Use this to explain how a generated outbound mail piece relates back to prior inbound scans and review decisions. Inputs: thread_id, include |
get_usage | Get usage summary, billing events, and prepaid credit balance for a time period. Returns itemized events (scans, forwards, mail sends) with costs, period totals, and credits. Defaults to the current billing period if no dates are specified. Inputs: period_start, period_end |
list_facility_conversations | List your Austin HQ conversation with its unread message count and last message preview. Facility routing is automatic. Inputs: limit, offset |
list_inbound_forwarding_addresses | List the renter’s private inbound forwarding aliases on forward.mailbox.bot. These are the unique intake email addresses an operator, assistant, provider, or external agent can forward scans, PDFs, photos, provider notices, notes, and other |
list_inbound_mail | List forwarded inbound mail items captured from private forwarding aliases. Default output includes compact draft_context so an LLM or external agent can reason about OCR context, reply contact candidates, deadlines, and thread linkage befo Inputs: limit, offset, category, status, thread_id, include |
list_outbound_mail | List outbound mail jobs with status tracking. Returns mail ID, recipient, mail class, status, cost, timestamps, and failure metadata. Filter by status, created_at date range, or search recipient/address/tracking/agent notes. Inputs: status, q, created_after, created_before, test_mode, limit |
list_postal_threads | List physical-mail threads that group inbound mail context, human review, and outbound sends. Use this to understand which inbound items and outbound documents belong to the same business workflow. Inputs: limit, offset, category, status, include |
propose_mailbox_md_edit | Propose changes to the renter's MAILBOX.md instructions with reasoning. The renter will see your suggestion in their dashboard and can accept, reject, or modify it. Use this when you observe patterns that could be codified into standing ins Inputs: suggested_content, reason |
send_facility_message | Send a message to the Austin HQ operator managing your mailbox. Facility routing is automatic. Messages appear in the shared conversation visible to you, the renter, and the facility. Optionally link the message to a specific package or act Inputs: body, package_id, action_request_id |
send_outbound_mail | Submit a document for printing and postal mailing by the facility. Supported formats: PDF, DOCX, JPG, PNG, TXT, CSV. The document is stored securely and printed by the facility operator. USPS First-Class Mail has a published $2.00 one-page Inputs: document_base64, document_filename, page_count, mailbox_md_version, recipient_name, recipient_company |
update_webhook | Configure webhook endpoint URL and event subscriptions for real-time notifications. Outbound events are mail.pending_approval, mail.submitted, mail.ready, mail.mailed, mail.delivered, mail.failed, and mail.cancelled. Canonical physical-cust Inputs: webhook_url, event_types, enabled |
Every block below points at https://mailbox.bot/api/mcp. Pick your client and copy.
claude mcp add --transport http mailbox-bot https://mailbox.bot/api/mcp
{
"mcpServers": {
"mailbox-bot": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mailbox.bot/api/mcp"]
}
}
}{
"mcpServers": {
"mailbox-bot": {
"url": "https://mailbox.bot/api/mcp"
}
}
}{
"servers": {
"mailbox-bot": {
"type": "http",
"url": "https://mailbox.bot/api/mcp"
}
}
}{
"context_servers": {
"mailbox-bot": {
"url": "https://mailbox.bot/api/mcp"
}
}
}{
"mcpServers": {
"mailbox-bot": {
"serverUrl": "https://mailbox.bot/api/mcp"
}
}
}{
"mcpServers": {
"mailbox-bot": {
"url": "https://mailbox.bot/api/mcp"
}
}
}name: mailbox.bot
version: 0.0.1
schema: v1
mcpServers:
- name: mailbox.bot
type: streamable-http
url: https://mailbox.bot/api/mcp{
"mcpServers": {
"mailbox-bot": {
"httpUrl": "https://mailbox.bot/api/mcp"
}
}
}{
"mcpServers": {
"mailbox-bot": {
"type": "http",
"url": "https://mailbox.bot/api/mcp"
}
}
}{
"mcpServers": {
"mailbox-bot": {
"url": "https://mailbox.bot/api/mcp"
}
}
}goose://extension?url=https%3A%2F%2Fmailbox.bot%2Fapi%2Fmcp&type=streamable_http&id=mailbox-bot&name=mailbox.bot
It answered our last check on 17 October 2026 in 210 ms. Over 10 checks since 4 September 2026 it answered 10. Status here comes from Neuronto's own probes, not from the publisher.
Yes. It is published by mailbox.bot and served from mailbox.bot, the vendor's own domain: https://mailbox.bot/api/mcp.
19, as returned by the server's own tools/list on 9 September 2026: advance_test_outbound_mail, cancel_outbound_mail, create_test_outbound_mail, get_facility_messages, get_inbound_mail, get_mailbox, get_mailbox_md, get_outbound_mail, and 11 more.
It answered our last check on 17 October 2026 in 210 ms. Over 10 checks since 4 September 2026 it answered 10.
Put the server under mcpServers in ~/.cursor/mcp.json with the URL https://mailbox.bot/api/mcp. The exact JSON is above, with the same setup for Claude Code, Claude Desktop, VS Code, Windsurf, Zed, Gemini CLI and the rest.
It listed its tools to an anonymous client, so reading the tool list needs no key. Individual tools can still ask for credentials in their own inputs.
Publisher: bot.mailbox. Endpoint host: mailbox.bot. ARD identifier: urn:air:bot.mailbox:mcp:mailbox.
First indexed 31 August 2026. The tools are exactly what the server returned; nothing on this page
is inferred from its name. Ranking in Neuronto search is never for sale.