Mailbuttons

Mailbuttons MCP 服务

通过 Model Context Protocol 为 AI Agent 提供受治理的电子邮件服务。 为 Agent 提供一个受限邮箱，由服务端而非提示词执行防护措施：默认采用沙箱收件箱、每次发送都经过策略门控，并提供防篡改审计日志。向外部发送邮件和更改权限范围都必须经人工批准，Agent 本身无法获得这些权限。

• 注册表：com.mailbuttons/mcp-server
• npm：@mailbuttons/mcp-server
• 平台：mailbuttons.com · Agent 入口：mbag.ai

使用方法

托管（推荐） — 平台提供的可流式传输 HTTP 端点：

https://mailbuttons.com/api/v1/mcp/rpc
Authorization: Bearer <your Mailbuttons MCP token>   # mb_sandbox_... (or mb_prod_...)

本地（stdio） — 运行 npm 包，让 Agent 启动它：

{
  "mcpServers": {
    "mailbuttons": {
      "command": "npx",
      "args": ["-y", "@mailbuttons/mcp-server"],
      "env": { "MAILBUTTONS_API_KEY": "mb_sandbox_..." }
    }
  }
}

从控制面板或 POST /api/v1/mcp/sandbox-inboxes 获取受限令牌。 沙箱令牌无法向外部发送邮件，除非经人工授权升级。

服务端执行的策略

• 入站 — 每个邮箱都有发送方策略，默认拒绝：陌生人发送的邮件默认会被退回，因此没人能仅凭发邮件就对你的 Agent 进行提示注入。
• 出站 — Agent 可以读取收件人阻止列表，但无法更改；向被阻止的收件人发送邮件会返回正常的 {"status":"blocked"} 结果，而非错误。
• 限额 + 审计 — 每个账户均有发送限额，并配有哈希链式审计日志，拒绝操作也会记录在内。
• 升级权限 — 向外部发送邮件或扩大权限范围只能提出申请；需由指定人员批准。Agent 不能批准自己的申请。

安装为 Agent 技能

本仓库在根目录提供 SKILL.md，任何支持技能的 Agent 都可以添加它：

npx skills add mailbuttons/mcp-server

文档

• Agent 注册（面向 Agent）：https://mbag.ai/docs/agent-signup.md
• 信任模型：https://mbag.ai/docs/trust-model.md
• OpenAPI：https://mbag.ai/api/openapi.json
• 框架用法示例：references/（Claude Agent SDK、LangChain、纯 SDK）

Mailbuttons 是 Code Cutter Limited（英国公司，编号 08453060）的商业名称。采用 MIT 许可证。