EmptyInbox

emptyinbox-mcp

适用于 EmptyInbox 的 MCP 服务——为 AI Agent 创建一次性邮箱，并读取其中的邮件。

已列入官方 MCP 注册表，名称为 io.github.cnohall/emptyinbox。

设置

Claude Code：

claude mcp add emptyinbox -- npx -y emptyinbox-mcp@latest

其他任何 MCP 客户端——添加到其配置中：

{
  "mcpServers": {
    "emptyinbox": {
      "command": "npx",
      "args": ["-y", "emptyinbox-mcp@latest"]
    }
  }
}

无需设置：首次调用需要账户的工具时，会自动注册账户，并将密钥保存到 ~/.emptyinbox.json，供后续会话使用。单独启动服务（MCP 宿主会这样做以列出工具）不会创建任何内容。

使用自己的账户（可选——用于复用已有密钥）：

{
  "mcpServers": {
    "emptyinbox": {
      "command": "npx",
      "args": ["-y", "emptyinbox-mcp@latest"],
      "env": {
        "EMPTYINBOX_API_KEY": "your_api_key_here"
      }
    }
  }
}

在 https://emptyinbox.me/settings.html 获取 API 密钥

工具

工具	说明
create_inbox	创建新的电子邮件地址；除非保留，否则 30 天后过期
list_inboxes	列出账户中的所有收件箱
list_messages	列出收到的邮件，每封邮件包含提取出的验证码、操作链接和文本预览
get_message	获取解析后的单封邮件（验证码、链接、纯文本）；或使用 format="text" 获取纯文本呈现
wait_for_message	阻塞等待邮件到达——非常适合注册／OTP 工作流；返回邮件中提取出的验证码
get_quota	查看账户剩余点数
list_bundles	列出点数套餐和价格
buy_quota	获取比特币付款报价；返回供用户使用的 pay_url，以及地址、金额和 BIP21 URI
check_payment	检查付款是否到账，以及点数是否已入账
keep_inbox	将收件箱设为永久有效（30 点数），使其持续接收邮件，例如密码重置邮件
report_issue	向团队提交错误、付款问题、文档缺漏或功能请求；不会创建账户

Agent 工作流示例

1. create_inbox → "[email protected]"
2. [agent signs up to some service using that address]
3. wait_for_message(inbox="[email protected]", timeout_seconds=60)
4. → returns the verification email with code/link

付款

每个账户初始都包含免费收件箱。免费额度用完后，create_inbox 会返回价格，Agent 无需离开会话即可完成购买：

1. Agent 向用户展示套餐，由用户选择
2. buy_quota 返回 pay_url——一个显示二维码、准确金额和实时状态的页面——以及原始地址、金额和 BIP21 URI
3. 用户使用任意比特币钱包付款（也可以由拥有自己钱包的 Agent 支付 BIP21 URI）
4. 使用 wait_seconds 调用 check_payment 确认点数到账，通常在广播后几秒内完成

buy_quota 接受 list_bundles 返回的 bundle ID，或 1 至 100 美元之间的自定义整数金额 usd，适用于需要花完钱包中任意余额的 Agent。 自定义金额按其符合条件的最佳套餐费率定价。无论付款金额多少，付款方额外支付的网络手续费都相同，因此对于 1 美元额度的充值，手续费占比会大得多。

网络检测到付款后，点数会立即发放，无需等待确认。用户也可以在 https://emptyinbox.me/inboxes.html 购买