Inbin agent email

@inbin/mcp

面向 Inbin 的模型上下文协议接口的精简 stdio-to-HTTP 代理。让仅支持 stdio 的 MCP 客户端（Claude Desktop、某些 Cursor 版本、Zed、Cline）能够连接 Inbin 的远程端点 https://api.inbin.dev/mcp。

安装和运行

无需全局安装。MCP 客户端会通过 npx 调用它：

{
  "mcpServers": {
    "inbin": {
      "command": "npx",
      "args": ["-y", "@inbin/mcp"],
      "env": {
        "INBIN_API_KEY": "ink_live_..."
      }
    }
  }
}

从 https://inbin.dev/dashboard 获取 API 密钥。

还没有账户？

通过下方的远程端点，五个工具无需密钥。Agent 可以创建收件箱、使用其地址并等待验证码：

1. create_trial_inbox 会立即返回一个 inbox_address（14 天后过期）。
2. 在任何需要发送确认信息的地方使用该地址。
3. 使用准确的 inbox_address 调用 await_trial_inbox，最多等待 60 秒以获取验证码或链接。如果返回 expired，请再次调用。
4. claim_trial_inbox 会返回一个链接，供用户保留该地址；await_trial_inbox_claim 和 claim_connection_status 会跟踪认领状态。

此 stdio 包装器始终会发送密钥，因此适用于需要密钥的工具。对于无需账户的工具，请直接连接到 https://api.inbin.dev/mcp，不带任何标头。可运行的操作指南： https://inbin.dev/guides/ai-agent-email-address-verification-codes

功能

• 将每条 stdin JSON-RPC 消息作为带有你的 Bearer 密钥的 HTTPS POST 转发到 https://api.inbin.dev/mcp。
• 将响应流式传回 stdout。
• 根据 JSON-RPC 规范，通知（不带 id 的消息）不会收到回复。
• 支持并发处理进行中的请求。

提供的工具

每个 Inbin 应用都是一个 MCP 服务。使用密钥后，工具包括（调用 tools/list 查看完整列表）：

• list_inboxes：列出应用中的收件箱
• list_events：按收件箱 / 状态 / 起始时间筛选；支持分页
• search_events：按 id / subject / from / to 进行子字符串搜索
• get_event：获取单个事件的解析后 JSON 和投递历史
• query_events：对提取的记录进行筛选、排序、分组和汇总（将收件箱视为表格）
• describe_schema：查看当前提取架构

环境变量

变量	必需	说明
INBIN_API_KEY	是	你的 Inbin API 密钥
INBIN_MCP_URL	否	覆盖端点（默认为生产环境）
INBIN_MCP_DEBUG	否	设置为 1，将日志输出到 stderr

远程连接（推荐）

如果 MCP 客户端支持 Streamable HTTP 传输，则无需使用此包装器，直接连接即可。不带标头时可使用五个无需账户的工具；带密钥时可使用所有工具：

{
  "mcpServers": {
    "inbin": {
      "url": "https://api.inbin.dev/mcp",
      "headers": {
        "Authorization": "Bearer ink_live_..."
      }
    }
  }
}

许可证

MIT。