Mailbox.bot

mailbox.bot — 面向 AI Agent 的邮政邮件 API 和 MCP 服务

此代码库是 mailbox.bot 的公开发现与集成套件。生产服务运行于 mailbox.bot。

MCP 服务让 AI Agent 能够寄送实体邮件。

现已上线：通过 API 和 MCP 寄送实体邮件、转发文档上下文，以及 Agent 邮箱：在加利福尼亚州曼哈顿海滩符合 USPS 规范且有工作人员值守的设施中，提供街道地址和 PMB，每月 15 美元。注册时即可申请，也可使用 POST /v1/mailing-address-requests 申请。PMB 编号将在 USPS Form 1583 验证完成后分配。

mailbox.bot 是面向 AI Agent 和软件工作流的邮政邮件 API。通过 POST /v1/mail 发送 PDF、DOCX 文件、信件、通知、挂号邮件、明信片和文档。对于收件，运营人员可以转发扫描件、照片、PDF、虚拟邮箱通知，以及来自现有地址的人工备注；Agent 可以读取这些上下文、起草关联回复，并在同一邮政邮件线程中寄出邮件。

forward scans/docs -> OCR-backed context + draft reply -> POST /v1/mail

Agent 可以做什么

1. 实体邮件寄送 API — 使用 POST /v1/mail 提交文档和收件人地址。
2. Agent 邮箱 — 使用 GET /v1/inbound-items?q= 搜索分配地址上的邮件，读取 OCR 页面，并通过 POST /v1/inbound-items/{id}/actions 提议 scan、forward 或 discard；所有提议均由所有者按报价批准。
3. 收件邮件上下文 API — 使用 GET /v1/inbound-forwarding-addresses、/v1/inbound* 和 /v1/postal-threads*，将转发邮件和文档上下文转化为关联的寄出回复。

默认的收件转发是数字收件渠道，不是实体地址。Agent 邮箱是实体收件服务：工作人员会登记每封信件和包裹，对扫描页面进行 OCR，并在用户批准后执行 Agent 提议的操作。

安装

MCP 服务

添加到 MCP 配置中：

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

完整的 MCP 安装指南：mailbox.bot/mcp-install

OpenClaw

clawhub install mailbox-bot
# or in OpenClaw:
openclaw skills install arbengine/mailbox-bot

Claude Code、Cursor、Codex 和其他 Agent

npx skills add arbengine/mailbox-bot-skill

REST API

curl -X POST https://mailbox.bot/api/v1/mail \
  -H "Authorization: Bearer sk_agent_..." \
  -H "X-Mailbox-MD-Version: 3" \
  -H "X-Max-Cost-Cents: 1500" \
  -F '[email protected]' \
  -F 'recipient_name=Acme Corp' \
  -F 'recipient_line1=123 Main St' \
  -F 'recipient_city=Los Angeles' \
  -F 'recipient_state=CA' \
  -F 'recipient_zip=90001' \
  -F 'mail_class=certified' \
  -F 'dry_run=true'

当前已上线

• 外寄邮件 — 提交 PDF 后，由设施打印、装封、贴邮票并寄出，同时提供照片凭证
• 收件文档上下文 — forward.mailbox.bot 上的专属转发别名，可从操作人员现有的地址接收扫描件、照片、PDF、服务提供商通知和人工备注
• OCR 支持的回复流程 — Agent 读取 /v1/inbound*，获取 draft_context，并通过 inbound_capture_id 和 postal_mail_thread_id 发送关联回复
• 邮政邮件会话 — /v1/postal-threads* 将收件上下文与外寄事件关联起来
• 文档审核 — requires_approval=true 会创建包含 document_preview_url 的仪表板审核项
• 认证邮件 — USPS Certified、Certified + Return Receipt、Priority、First Class
• FedEx 和 UPS — 按区域计算隔夜、2 天和地面运输费率
• 批量邮件 — 通过 /v1/batch-mail 使用一个 PDF 和一个 CSV（估价、草稿、确认），并提供沙盒
• 沙盒 — 测试密钥（sk_agent_test_）、试运行、生命周期模拟，费用为零
• Webhook 通知 — 每次状态转换都会触发经 HMAC 签名的 JSON 负载
• MAILBOX.md 常设说明 — 配置外寄邮件和 Agent 邮箱工作流规则
• 人工参与 — requires_approval=true 会暂停流程，等待人工批准
• 计费保障措施 — X-Max-Cost-Cents 标头、dry_run=true、每日支出上限

Agent 邮箱 — 当前已上线

在美国加利福尼亚州曼哈顿海滩一处有工作人员值守且符合 USPS 规定的设施，为你的 Agent 提供真实街道地址和 PMB，每月 15 美元。邮箱现已开放：注册时即可申请，或使用 POST /v1/mailing-address-requests 申请。通过 USPS Form 1583 验证后分配 PMB 号码。USPS Form 1583 将经过验证的真人与每个 Agent 邮箱关联：参加一次在线公证会话，提供两份身份证件，免收费用。

• 收件 — 工作人员为每封信件和每个包裹登记，并拍摄信封照片；Webhook 事件 inbound.received、inbound.keywords_matched 和 inbound.pages_ready
• 读取 — GET /v1/inbound-items?q= 可搜索发件人、参考信息和 OCR 文本；GET /v1/inbound-items/{id}/pages 可返回逐页 OCR 结果
• 处理 — POST /v1/inbound-items/{id}/actions 可提交 scan、forward 或 discard 操作建议；所有者按报价批准
• 套餐 — 每月 15 美元，包含每月 30 件邮件和 5 个包裹，以及两次 Open & scan 请求；GET /v1/inbound-plan 可返回所有费率
• 沙盒 — sk_agent_test_ 密钥可在账户的示例信件上使用相同路由，不产生任何费用

还没有邮箱？使用 POST /v1/mailing-address-requests 申请邮寄地址；真人在线完成 USPS Form 1583。

协议

协议	端点	详情
REST API	https://mailbox.bot/api/v1	外寄邮件、Agent 邮箱读取与操作，以及收件转发上下文
MCP	https://mailbox.bot/api/mcp	45 个工具，涵盖外寄邮件、Agent 邮箱搜索与操作、收件上下文、设施消息、Webhook 和沙盒生命周期模拟
A2A	https://mailbox.bot/api/a2a	10 项技能，用于 Agent 间任务执行
OpenClaw	https://mailbox.bot/.well-known/agent.json	多协议 Agent 卡片

计划

计划	价格	状态	服务内容
收件上下文 + 外发邮件	$0/mo	现已上线	包含专属收件转发别名。可通过控制面板、API 或 MCP 发送外发邮件。
Agent 邮箱	$15/mo	现已上线	位于加利福尼亚州曼哈顿海滩的设施提供街道地址 + PMB；每月包含 30 件邮件和 5 个包裹；经所有者批准后可扫描、转寄或丢弃。

外发邮件价格：USPS First-Class 邮件（1 页）起价 $2.00；打印费用为黑白 $0.40/页或彩色总计 $0.70/页（含 $0.30/页彩色升级费用）。USPS 公布的 1 页最低价格为：Priority Mail $15.00、Certified Mail $20.00，以及 Certified + Electronic Return Receipt $24.00。FedEx 2Day 在承运商基准价格上固定减免 $8.00，FedEx Overnight 则固定调整 $18.00。外发邮件使用预付额度；使用 dry_run=true 和 cost_breakdown 获取权威报价。

完整价格：mailbox.bot/pricing

框架集成

无需 SDK — 所有集成都通过标准 HTTP 库使用 REST API。

• LangChain（Python）
• CrewAI（Python）
• LlamaIndex（Python）
• Vercel AI SDK（TypeScript）
• OpenAI Agents SDK（Python）

链接

• 网站
• API 文档
• 完整 API 参考（适合大模型）
• MCP 安装指南
• MCP 服务卡片
• 公开 MCP 工具目录
• 官方 MCP 注册表名称 — bot.mailbox/mailbox
• 沙盒与测试密钥
• OpenAPI 规范
• Agent 发现
• 价格
• 联系

发布到 ClawHub（维护者须知）

npm install -g clawhub
clawhub login
clawhub publish . \
  --slug mailbox-bot \
  --name "mailbox.bot" \
  --version 5.3.1 \
  --changelog 'v5.3.1 — agent mailbox rental is $15/mo (was $10/mo); nothing else changed.'
clawhub inspect mailbox-bot

---

有疑问？mailbox.bot/contact