# mailbox.bot

> mailbox.bot is a paid MCP server for communication. Give an agent a real street address and let it print, mail and track physical letters. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Starting price:** $15 a month
- **Platforms:** Web, API
- **Website:** https://mailbox.bot/mcp-install
- **Repository:** https://github.com/arbengine/mailbox-mcp
- **MCP Registry name:** bot.mailbox/mailbox
- **Categories:** communication
- **Listing updated:** 2026-11-15

## About

mailbox.bot bridges AI agents and physical post. Outbound, the agent submits a document and the service prints, stamps and mails it to a US address by USPS or FedEx, with photo proof at each step. Published one-page examples start at 2.00 USD for USPS First-Class and run to 15 USD for Priority and 20 USD for Certified; a send_outbound_mail dry run returns the exact cost_breakdown before any credits are spent. Postcards and batch campaign mail are also priced.

Inbound, a mailbox with a street address and PMB at a Manhattan Beach, CA facility rents for 15 USD a month, once USPS Form 1583 verification assigns the number. Agents can search OCR text of incoming items and propose scan, forward or discard actions, but proposals always wait for the owner and never charge or act on their own.

The server is hosted over Streamable HTTP with 55 tools for keys and 33 for sign-in connections. Sandbox keys rehearse for free on a sample letter; live keys spend prepaid credits, and live letters wait for dashboard approval when connected by sign-in.

## Features

- **Print and mail:** Send letters, certified mail, postcards and document packets to US addresses.
- **Dry-run pricing:** Get a full cost breakdown before spending credits.
- **Inbound mail search:** Search forwarded and received mail, including OCR text.
- **Owner-approved actions:** Scan, forward or discard proposals wait for the owner.
- **Sandbox keys:** Test on a sample letter with no charge and no physical mail.
- **Batch campaigns:** Mail postcards or letters from one design and one list.

## Good for

- Let an agent mail a certified letter with proof of delivery
- Give an agent a street address for packages and mail
- Run a small postcard campaign with per-piece QR codes
- Have an agent read scanned incoming mail

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mailbox https://mailbox.bot/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mailbox.bot/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mailbox": {
      "url": "https://mailbox.bot/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mailbox": {
      "type": "http",
      "url": "https://mailbox.bot/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mailbox": {
      "serverUrl": "https://mailbox.bot/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mailbox": {
      "type": "http",
      "url": "https://mailbox.bot/api/mcp"
    }
  }
}
```

## Tools

- `get_mailbox`: Read the account mailing address.
- `get_usage`: Read usage events and the prepaid credit balance.
- `list_inbound_forwarding_addresses`: List intake aliases on forward.mailbox.bot.
- `list_inbound_mail`: List forwarded inbound mail with draft context.
- `get_inbound_mail`: Read one forwarded inbound item and its OCR-backed facts.
- `list_postal_threads`: List physical-mail threads grouping inbound and outbound items.
- `send_outbound_mail`: Print and mail a document; dry_run returns the cost breakdown.
- `search_inbound_items`: List and search inbound items including OCR text.
- `get_inbound_item`: Read an item's pages, actions and quotes.
- `get_inbound_pages`: Read page text of an inbound item.
- `quote_inbound_forward`: Price every forwarding class.
- `request_inbound_action`: Propose scan, forward or discard for owner approval.
- `get_inbound_activity`: Follow the timeline of inbound activity.

## FAQ

### How much does a letter cost?

Estimates start at $2.00 for a one-page USPS First-Class letter; a dry run returns the exact price.

### Can I test without sending real mail?

Yes. Sandbox keys (sk_agent_test_) run the same tools with no credits and no printing.

### Can the agent forward or discard my mail on its own?

No. Inbound actions are proposals that always wait for the owner.

### What does the mailbox cost?

The README lists 15 dollars a month for the street address with PMB.

### Is mailbox.bot free?

No. mailbox.bot is a paid product. Paid plans start at $15 a month.

### How do I add mailbox.bot to Claude Code?

Run this command in your terminal: claude mcp add --transport http mailbox https://mailbox.bot/api/mcp

### What are the best alternatives to mailbox.bot?

The closest alternatives to mailbox.bot are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

## Alternatives

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/mailbox-bot
