Mailbox.bot

mailbox.bot MCP 服务

面向 mailbox.bot 的官方托管式模型上下文协议服务。生产环境使用远程 Streamable HTTP，地址为 https://mailbox.bot/api/mcp。

Agent 可寄送信件、挂号信、明信片和文件包。mailbox.bot 会打印、贴邮票、寄送、拍照、追踪并返回凭证。Agent 邮箱现已开放：在位于加利福尼亚州曼哈顿海滩、配有工作人员且符合 USPS 要求的设施中，提供真实街道地址加 PMB，每月 15 美元。USPS Form 1583 验证完成后分配 PMB 号码。在线公证费已免除。寄出邮件使用预付额度，无月费。

• 网站： https://mailbox.bot
• 安装： https://mailbox.bot/mcp-install
• 定价： https://mailbox.bot/pricing
• 公开工具目录： https://mailbox.bot/api/mcp/tools-public
• OpenAPI： https://mailbox.bot/openapi.json 和 https://mailbox.bot/openapi.yaml
• 注册表： bot.mailbox/mailbox（已在 mailbox.bot 上通过 DNS 验证）

连接

登录，无需密钥。 支持 MCP 登录的客户端（claude.ai、ChatGPT、Cursor、Claude Code）可以添加 https://mailbox.bot/api/mcp，无需添加标头。首次调用工具时会打开 mailbox.bot 的登录页面，你可以在其中选择 Agent 以及 Sandbox 或 Live。使用 Live 连接时，每封信都需在控制面板中等待你批准。你可以随时在 API Keys 页面断开连接。

插件。 本仓库也是 Cursor 和 Claude Code 插件：Cursor 使用 .cursor-plugin/plugin.json 和 mcp.json，Claude Code 使用 .claude-plugin/ 和 .mcp.json（先运行 /plugin marketplace add arbengine/mailbox-mcp，再运行 /plugin install mailbox-bot@mailbox-bot）。两者均通过登录连接，并提供 skills/mailbox-bot 技能。

使用密钥。 将托管 URL 添加到 MCP 客户端，并传入 bearer 密钥。客户无需运行本地进程。

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

在 mailbox.bot/signup 创建账户。Live Agent 密钥（sk_agent_）可寄送真实邮件并使用预付额度。Sandbox 密钥（sk_agent_test_）可在相同端点上进行演练，不会产生费用，也不会寄出实体邮件。会员账户密钥（sk_live_）不能寄送邮件。

定价

方案	价格	服务内容
寄出邮件和转发的收件内容	每月 0 美元	使用预付额度打印和寄送邮件。将你已有地址收到的扫描件、照片和 PDF 转发给你。
邮寄地址	每月 15 美元	位于加利福尼亚州曼哈顿海滩设施内的街道地址加 PMB。现已开放。USPS Form 1583 验证完成后分配 PMB 号码。

已公布的寄出邮件示例价格为：1 页 USPS First-Class 信件起价 2.00 美元。试运行会返回该文件、页数、服务和 ZIP 对应的确切价格。适用价格以该 cost_breakdown 为准。

工具

提供 55 个托管工具。当前工具列在前面。已弃用的工具仍可使用，并会注明其替代工具。实时架构：公开目录。

工具	描述
get_mailbox	读取账户的邮寄地址：街道地址加上位于加利福尼亚州曼哈顿海滩设施的 PMB。租金为每月 15 美元，邮箱现已启用。USPS 表格 1583 验证完成后才会分配 PMB 编号。
get_usage	读取使用事件和预付余额。Agent 可以读取余额，但不能购买额度。
list_inbound_forwarding_addresses	列出会员在 forward.mailbox.bot 上的收件别名，用于接收来自运营者已控制地址的扫描件、照片和 PDF。
list_inbound_mail	列出转发的入站邮件，并附带简洁的回复草稿上下文。
get_inbound_mail	读取一封转发的入站邮件、由 OCR 提取的事实、回复提示和邮件串关联信息。
list_postal_threads	列出实体邮件串，将入站上下文与出站寄件归为一组。
get_postal_thread	读取一个实体邮件串及其时间线。
get_mailbox_md	在发送出站邮件前，读取此 Agent 的版本化 MAILBOX.md 指令。
propose_mailbox_md_edit	提议修改常设指令。所有者可接受或拒绝。
send_facility_message	向负责此邮箱的设施发送消息。
list_facility_conversations	列出与设施的对话。
get_facility_messages	读取设施对话中的消息。
update_webhook	更新旧版 Agent webhook 回调 URL 和事件订阅。
send_outbound_mail	使用预付额度打印并邮寄文档。正式发送前，请使用 dry_run=true 调用并显示价格。
list_outbound_mail	列出出站邮件任务及其状态。
get_outbound_mail	读取一项出站任务，包括费用、状态和履行照片。
cancel_outbound_mail	在打印前取消排队中的邮件，并退还符合条件的预付额度一次。
create_test_outbound_mail	创建沙盒出站记录，不收费，也不寄送实体邮件。
advance_test_outbound_mail	推进沙盒出站记录，使其依次经历已提交、已就绪、已寄出和已送达状态。
quote_outbound_mail	在准备好文档前估算信件价格：邮寄类别、页数、彩色选项，以及使用 FedEx 时的邮政编码。无需账户。
send_text_letter	将以纯文本撰写的信件寄出。通过 send_outbound_mail 处理，遵循相同的审批、限额和凭证要求。
estimate_batch_mail	在准备好文件前估算批量明信片、信件、传单或小册子的价格（10 至 10,000 份）。包含打印和 USPS 邮资。
create_batch_mail	根据模板链接（PDF 或 PNG/JPG 明信片图片）以及内嵌收件人信息或 CSV 链接创建批量草稿。不会收费；确切价格会随 links.proof 一并返回。
get_batch_mail_proof	提供一个有效期为一小时的校样 PDF 链接：先显示打印时的模板，再以实际尺寸显示一位收件人的地址标签，供批量邮件审核者查看。
confirm_batch_mail	使用预付额度为草稿付款一次，并将其加入打印队列。此密钥的审批和每日件数政策仍然适用；若超过 max_cost_cents，则会在扣款前拒绝。
get_batch_mail	读取一个批次：状态、收件人摘要、定价与退款、链接及前 50 件。
list_batch_mail	按时间倒序列出调用者的批次。沙盒密钥只能看到沙盒批次。
cancel_batch_mail	在设施开始处理前取消批次；全额退还额度。
advance_test_batch_mail	仅限沙盒：将批次从已提交推进至处理中，再到已完成，并像设施一样触发 batch.completed。
search_inbound_items	搜索已分配 PMB 中的实体邮件，包括已保存的 OCR 文本。沙盒密钥会看到该账户的 Mojave 样例信件。
get_inbound_item	读取一项入站邮件：页面、操作以及当前的扫描和转寄报价。
get_inbound_pages	读取一项入站邮件的页面文本。
quote_inbound_forward	估算将一项邮件转寄至美国邮政编码时各种转寄类别的价格。
request_inbound_action	提议扫描、转寄或丢弃。由所有者审批。此提议本身不会花费额度或移动邮件。
get_inbound_activity	读取此密钥可见邮件的入站时间线。
list_webhook_endpoints	列出会员的 webhook。不包含签名密钥。
create_webhook_endpoint	创建 webhook。签名密钥仅返回一次。
update_webhook_endpoint	更新 webhook URL、事件、关键词规则或状态。
test_webhook_endpoint	将一条模拟的 webhook.test 投递加入队列。
test_webhook_endpoint_with_sample	使用会员的样例信件测试 webhook。
rotate_webhook_endpoint_secret	在运营者提出请求后，轮换 webhook 签名密钥。
list_webhook_deliveries	读取近期 webhook 投递记录。载荷不包含页面文本。
replay_webhook_delivery	重试失败的 webhook 投递。
list_agent_inbox	已弃用。请改用 search_inbound_items。
get_agent_inbox_context	已弃用。请改用 get_inbound_item。
get_agent_inbox_sources	已弃用。请改用 get_inbound_item。
list_agent_inbox_scans	已弃用。请改用 get_inbound_pages。
get_agent_inbox_scan	已弃用。请改用 get_inbound_pages。
get_agent_inbox_activity	已弃用。请改用 get_inbound_activity。
report_agent_inbox_outcome	已弃用。无后继工具。别名窗口关闭前仍会提供此工具。
get_agent_inbox_handling	已弃用。请改用 get_inbound_item。
propose_agent_inbox_handling	已弃用。请改用 request_inbound_action。
seed_agent_inbox_sandbox	已弃用。无后继工具。别名窗口关闭前仍会提供此工具。
list_inbound_items	已弃用。请改用 search_inbound_items。
get_inbound_item_sources	已弃用。请改用 get_inbound_item。

get_mailbox

读取账户邮寄地址：位于加利福尼亚州曼哈顿海滩设施的街道地址和 PMB。租金为每月 15 美元，邮箱现已启用。USPS Form 1583 验证完成后会分配 PMB 编号。

get_usage

读取使用记录和预付余额。Agent 可以读取余额，但不能购买额度。

list_inbound_forwarding_addresses

列出成员在 forward.mailbox.bot 上的收件别名，用于接收来自运营方已控制地址的扫描件、照片和 PDF。

list_inbound_mail

列出转发的来信，并附上简洁的回复草稿上下文。

get_inbound_mail

读取一封转发的来信，包括基于 OCR 的事实、回复提示和邮件往来关联信息。

list_postal_threads

列出实体邮件往来线程，这些线程会汇总来信上下文和寄出邮件。

get_postal_thread

读取一个实体邮件往来线程及其时间线。

get_mailbox_md

寄出邮件前，读取此 Agent 的版本化 MAILBOX.md 说明。

propose_mailbox_md_edit

提议修改长期说明。所有者可接受或拒绝。

send_facility_message

向处理此邮箱的设施发送消息。

list_facility_conversations

列出与设施的对话。

get_facility_messages

读取设施对话中的消息。

update_webhook

更新旧版 Agent webhook 回调 URL 和事件订阅。

send_outbound_mail

使用预付额度打印并邮寄文件。正式寄出前，请使用 dry_run=true 调用并显示价格。

list_outbound_mail

列出寄出邮件任务及其状态。

get_outbound_mail

读取一个寄出任务，包括费用、状态和履行照片。

cancel_outbound_mail

在打印前取消排队中的邮件，并退回符合条件的预付额度（仅退一次）。

create_test_outbound_mail

创建沙盒寄出记录，不收费，也不会实际邮寄。

advance_test_outbound_mail

将沙盒寄出记录依次推进至 submitted、ready、mailed 和 delivered 状态。

quote_outbound_mail

在准备好文件前，为信件定价：邮件类别、页数、彩色选项，以及 FedEx 邮件所需的 ZIP。无需账户。

send_text_letter

将纯文本写成信件并邮寄。通过 send_outbound_mail 处理，适用相同的审批、上限和凭证要求。

estimate_batch_mail

为一批明信片、信件、传单或宣传册（10 至 10,000 件）定价，无需已有文件。费用包含印刷和 USPS 邮资。

create_batch_mail

使用模板链接（PDF 或 PNG/JPG 明信片图片）以及内联收件人或 CSV 链接创建批量邮件草稿。不会收费；精确价格会通过 links.proof 返回。

get_batch_mail_proof

获取有效期为一小时的凭证 PDF 链接：先显示模板的实际印刷效果，再以真实尺寸显示一位收件人的地址标签，供批次审核者查看。

confirm_batch_mail

使用预付额度支付草稿费用（仅一次），并将其加入打印队列。适用密钥的审批和每日件数政策；max_cost_cents 会在扣款前拒绝超额请求。

get_batch_mail

读取一个批次：状态、收件人摘要、定价和退款、链接以及前 50 件邮件。

list_batch_mail

按时间从新到旧列出调用方的批次。沙盒密钥只能查看沙盒批次。

cancel_batch_mail

在设施开始处理前取消批次；额度将全额退还。

advance_test_batch_mail

仅限沙盒：将批次从 submitted 推进到 in_progress，再到 completed，并像设施一样触发 batch.completed。

search_inbound_items

搜索分配给某个 PMB 的实体邮件，包括已保存的 OCR 文本。沙盒密钥可查看账户的 Mojave 样例信件。

get_inbound_item

读取一件来信：页面、操作以及当前扫描和转寄报价。

get_inbound_pages

读取一件来信的页面文本。

quote_inbound_forward

为一件邮件转寄至美国 ZIP 时的所有转寄类别报价。

request_inbound_action

建议扫描、转发或丢弃。所有者会批准该操作。此提议本身不会消耗额度，也不会移动邮件。

get_inbound_activity

读取此密钥可查看项目的收件时间线。

list_webhook_endpoints

列出成员的 Webhook。签名密钥不会显示。

create_webhook_endpoint

创建 Webhook。签名密钥仅返回一次。

update_webhook_endpoint

更新 Webhook URL、事件、关键词规则或状态。

test_webhook_endpoint

将模拟的 webhook.test 投递加入队列。

test_webhook_endpoint_with_sample

使用成员的样例信件测试 Webhook。

rotate_webhook_endpoint_secret

在操作人员提出请求后，轮换 Webhook 签名密钥。

list_webhook_deliveries

读取近期的 Webhook 投递记录。载荷不包含页面文本。

replay_webhook_delivery

重试失败的 Webhook 投递。

list_agent_inbox

已弃用。请使用 search_inbound_items。

get_agent_inbox_context

已弃用。请使用 get_inbound_item。

get_agent_inbox_sources

已弃用。请使用 get_inbound_item。

list_agent_inbox_scans

已弃用。请使用 get_inbound_pages。

get_agent_inbox_scan

已弃用。请使用 get_inbound_pages。

get_agent_inbox_activity

已弃用。请使用 get_inbound_activity。

report_agent_inbox_outcome

已弃用。没有替代工具。别名窗口关闭前仍会提供此工具。

get_agent_inbox_handling

已弃用。请使用 get_inbound_item。

propose_agent_inbox_handling

已弃用。请使用 request_inbound_action。

seed_agent_inbox_sandbox

已弃用。没有替代工具。别名窗口关闭前仍会提供此工具。

list_inbound_items

已弃用。请使用 search_inbound_items。

get_inbound_item_sources

已弃用。请使用 get_inbound_item。

本仓库的用途

本仓库存放发布到官方 MCP Registry 的公开 server.json 清单。生产服务托管于 https://mailbox.bot/api/mcp。

server.js 可让注册表从 https://mailbox.bot/api/mcp/tools-public 读取实时工具目录。经过身份验证的工具调用使用托管端点。Claude、Cursor 和其他客户端的安装步骤请参阅 mailbox.bot/mcp-install。

验证真实性

命名空间 bot.mailbox/* 通过顶级域名 mailbox.bot 上的 DNS 证明予以保留。只有域名所有者才能在 MCP Registry 中以此命名空间发布服务。本仓库中的规范清单应与注册表条目一致。

许可证

MIT 适用于此清单和注册表适配器。mailbox.bot 服务依据 mailbox.bot 条款运营。