Agents Index

mailbox.bot

Online

Hosted mailbox.bot postal MCP. $15/mo mailboxes are live now.

Visit publisherConnectJSON

What it can do: 55 tools

  • get_mailbox read-onlyGet your agent's real mailing address: street address + mailbox number (PMB) at the Manhattan Beach, CA facility. The PMB number is assigned after USPS Form 1583 verification. Inbound context from addresses the operator
  • get_usage read-onlyGet 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
  • list_inbound_forwarding_addresses read-onlyList 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 notic
  • list_inbound_mail read-onlyList 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
  • get_inbound_mail read-onlyGet 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 linka
  • list_postal_threads read-onlyList 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.
  • get_postal_thread read-onlyGet 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.
  • get_mailbox_md read-onlyReturns this agent's MAILBOX.md, the renter's document of mail-handling preferences: the full document text, version number, content hash, and last update timestamp. Its version number is the mailbox_md_version that outb
  • propose_mailbox_md_editPropose a change to the renter's MAILBOX.md, with a reason. The renter sees the suggestion in their dashboard and can accept, reject, or modify it.
  • send_facility_messageSend a message to the operator at your mailbox facility. 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 p
  • list_facility_conversations read-onlyList your conversation with your mailbox facility, including its unread message count and last message preview. Facility routing is automatic.
  • get_facility_messages read-onlyRead the message thread with your mailbox facility. Facility routing is automatic. Returns messages in reverse chronological order with sender role (member, facility, agent). Supports cursor-based pagination. Automatical
  • update_webhookConfigure 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. Can
  • send_outbound_mailSubmit 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 publi
  • list_outbound_mail read-onlyList 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 no
  • get_outbound_mail read-onlyGet 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 incl
  • cancel_outbound_mailCancel 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
  • create_test_outbound_mailCreate 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
  • advance_test_outbound_mailAdvance 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,
  • list_agent_inbox read-onlyDeprecated: superseded by the tool named in _meta.successor. Still served unchanged during the alias window. List/search current assigned postal mail using the same /v1/agent-inbox service. q is literal AND search of IDs
  • get_agent_inbox_context read-onlyDeprecated: superseded by the tool named in _meta.successor. Still served unchanged during the alias window. Versioned context/reporting reader through /v1/agent-inbox/:id/context, not all-source history. Member-sample c
  • get_agent_inbox_sources read-onlyDeprecated: superseded by the tool named in _meta.successor. Still served unchanged during the alias window. Read one assigned item's saved page OCR through GET /v1/agent-inbox/:id/sources: exterior, requested-content an
  • list_agent_inbox_scans read-onlyDeprecated: superseded by the tool named in _meta.successor. Still served unchanged during the alias window. List/search completed facility-captured scan jobs for this assigned member sample through /v1/agent-inbox/:id/s
  • get_agent_inbox_scan read-onlyDeprecated: superseded by the tool named in _meta.successor. Still served unchanged during the alias window. Read one exact completed facility capture and its saved page OCR through /v1/agent-inbox/:id/scans/:operationId
  • get_agent_inbox_activity read-onlyDeprecated: superseded by the tool named in _meta.successor. Still served unchanged during the alias window. Read current authorized inbox retrieval receipts and agent-reported outcomes through /v1/agent-inbox/activity.
  • report_agent_inbox_outcomeDeprecated: no successor; retired when the alias window closes. Still served unchanged until then. Report actual external-worker processing through /v1/agent-inbox/:id/acknowledgments. Takes the exact fetched context_ver
  • get_agent_inbox_handling read-onlyDeprecated: superseded by the tool named in _meta.successor. Still served unchanged during the alias window. Read /v1/agent-inbox/:id/handling capabilities, version and history. Gated private-mail Live and member-sample
  • propose_agent_inbox_handlingDeprecated: superseded by the tool named in _meta.successor. Still served unchanged during the alias window. Propose through /v1/agent-inbox/:id/handling with dedicated agent.inbox.propose and read scopes. Requests carry
  • seed_agent_inbox_sandboxDeprecated: no successor; retired when the alias window closes. Still served unchanged until then. Explicitly seed an isolated provider-free two_page_letter or needs_review fixture through /v1/agent-inbox/sandbox/seed. S
  • list_webhook_endpoints read-onlyList the member's webhooks (name, URL, events, keyword rules, status), without secrets. Legacy agent callback settings are separate. Requires webhook.manage. Uses the same bounded control plane and tenant/agent/Live-Sand
  • create_webhook_endpointCreate a webhook: name, public HTTPS URL, events (inbound.received, inbound.action.requested, inbound.action.completed, inbound.pages_ready, inbound.keywords_matched) and optional keyword rules (literal terms, any/all, e
  • update_webhook_endpointUpdate name, URL, events, keyword rules or active/paused status with expected_revision. Agent/environment scope cannot be changed. Requires webhook.manage. Uses the same bounded control plane and tenant/agent/Live-Sandbo
  • test_webhook_endpointQueue a synthetic webhook.test delivery (no item) to check the receiver and its signature verification. Queue admission is not HTTP delivery; the delivery log shows the result. Requires webhook.manage. Uses the same boun
  • test_webhook_endpoint_with_sampleRun the Sample test: opens and scans the member's Mojave sample letter if needed (free, fictional), delivers its real inbound.pages_ready / inbound.keywords_matched events to this webhook, and returns a verdict computed
  • rotate_webhook_endpoint_secretRotate the signing secret; requires confirm_rotation:true. Old signatures overlap for 24 hours while the receiver's secure secret configuration is updated. Requires webhook.manage. Uses the same bounded control plane and
  • list_webhook_deliveries read-onlyRead the latest 50 deliveries and their exact JSON payloads (identifiers, sender line, dates, matched terms; never page text) for one webhook. HTTP 2xx delivered means receipt, not external-agent processing. No signing s
  • replay_webhook_deliveryExplicitly retry a failed delivery after correcting the receiver. Preserves event_id for deduplication and rechecks the current endpoint revision. Does not replay successful deliveries or approve facility handling. Requi
  • list_inbound_items read-onlyDeprecated: superseded by the tool named in _meta.successor. Still served unchanged during the alias window. Search managed-renter physical mail through GET /v1/inbound-items?search_mode=documents. q uses literal AND ter
  • get_inbound_item_sources read-onlyDeprecated: superseded by the tool named in _meta.successor. Still served unchanged during the alias window. Read saved exterior and authorized completed inside-page evidence through GET /v1/inbound-items/:id/sources. Re
  • search_inbound_items read-onlyList and search inbound mail through GET /v1/inbound-items, the same list and search the dashboard shows: newest first, with public status, kind (letter | package), the sender line as read from the envelope, the envelope

…and 15 more.

Connect it

Claude Code
claude mcp add --transport http mailbox-bot https://mailbox.bot/api/mcp
Claude.ai / ChatGPT
Settings → Connectors → Add custom connector
URL: https://mailbox.bot/api/mcp
Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "mailbox-bot": {
      "url": "https://mailbox.bot/api/mcp"
    }
  }
}
VS Code (.vscode/mcp.json)
{
  "servers": {
    "mailbox-bot": {
      "type": "http",
      "url": "https://mailbox.bot/api/mcp"
    }
  }
}

Questions

What does mailbox.bot do?

Hosted mailbox.bot postal MCP. $15/mo mailboxes are live now. It exposes 55 tools to AI assistants.

What tools does mailbox.bot provide?

55 tools, including get_mailbox, get_usage, list_inbound_forwarding_addresses, list_inbound_mail, get_inbound_mail, list_postal_threads, get_postal_thread, get_mailbox_md, propose_mailbox_md_edit, send_facility_message, list_facility_conversations, get_facility_messages….

How do I connect mailbox.bot to Claude, ChatGPT or Cursor?

Add the remote MCP endpoint https://mailbox.bot/api/mcp as a custom connector or MCP server. Copy-paste setup is on this page.

Does mailbox.bot require an account or API key?

No sign-in was needed to list its tools. Individual tools may still need an account or API key.

Is mailbox.bot online?

As of 2026-11-19 our probe found it online. It answered 100% of our last 3 checks.

Who publishes mailbox.bot?

mailbox.bot. The official MCP Registry verified that the publisher controls this domain before accepting the listing.

Similar in Communication