# mailbox.bot - send postal mail letters thru your ai agent 

mailbox.bot lets AI agents send real postal mail through an API. Upload PDFs, DOCX files, or generated pages, provide sender/recipient addresses and postage options, and mailbox.bot prints, stuffs, s…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add reportinganddata/mailbox-bot

# Browse available tools
npx -y smithery tool list reportinganddata/mailbox-bot

# Get full schema for a tool
npx -y smithery tool get reportinganddata/mailbox-bot get_mailbox

# Call a tool
npx -y smithery tool call reportinganddata/mailbox-bot get_mailbox '{}'
```

## Direct MCP Connection

Endpoint: `https://mailbox-bot.run.tools`

**Required config:**
- `api_key` (header) — Send postal mail, letters, and documents from AI agents with postage and tracking.

## Tools (22)

- `get_mailbox` — Get your agent's physical mailing address, suite number, facility details, and current mailbox status. Returns the full…
- `list_packages` — List inbound packages at your mailbox with optional filters by status, carrier, and date. Returns tracking number, carr…
- `get_package` — Get full package details including photos, tracking events, shipping label data (carrier, addresses, weight), forwardin…
- `get_package_photos` — Get photos for a package with OCR-extracted text and confidence scores. Filter by photo type to get only exterior shots…
- `request_action` — Request a physical action on a package at the facility. Actions include forwarding to another address, shredding, scann…
- `request_scan` — Request document scanning (OCR + structured data extraction) for a package. The facility will scan the document and ext…
- `get_scan_results` — Get document scan results including raw OCR text, structured data fields (addresses, dates, amounts), and confidence sc…
- `add_tag` — Add a tag/label to a package for categorization and filtering. Tags are free-form strings. Adding the same tag twice is…
- `add_note` — Add an observation or context note to a package. Notes are visible to the facility operator and the renter. Use for rec…
- `create_rule` — Create a standing instruction that auto-triggers actions when incoming packages match conditions. Rules run on every ne…
- `register_expected` — Pre-register an expected inbound shipment so it is auto-matched when it arrives at the facility. Optionally specify an …
- `get_usage` — Get usage summary and billing events for a time period. Returns itemized events (scans, forwards, mail sends) with cost…
- `update_action` — Push notes, structured data, or a clarification response to an existing action request. Use this to add agent reasoning…
- `get_mailbox_md` — Get the renter's MAILBOX.md standing instructions for this agent. Returns the full instruction text, version number, co…
- `propose_mailbox_md_edit` — Propose changes to the renter's MAILBOX.md instructions with reasoning. The renter will see your suggestion in their da…
- `send_facility_message` — Send a message to the facility operator managing your mailbox. Messages appear in the shared conversation visible to yo…
- `list_facility_conversations` — List your active facility conversations with unread message counts and last message preview. Each conversation correspo…
- `get_facility_messages` — Read the message thread with a specific facility. Returns messages in reverse chronological order with sender role (mem…
- `update_webhook` — Configure webhook endpoint URL and event subscriptions for real-time notifications. Events include package.received, pa…
- `send_outbound_mail` — Submit a document for printing and physical mailing by the facility. Supported formats: PDF, DOCX, JPG, PNG, TXT, CSV. …
- `list_outbound_mail` — List outbound mail jobs with status tracking. Returns mail ID, recipient, mail class, status, cost, and timestamps. Fil…
- `get_outbound_mail` — Get full details of an outbound mail job including recipient address, mail class, page count, cost breakdown, current s…

```bash
# Get full input/output schema for a tool
npx -y smithery tool get reportinganddata/mailbox-bot <tool-name>
```