Mailsink

@mailsink/mcp

适用于 MailSink 的模型上下文协议服务 — 为 AI Agent 和测试自动化提供可编程的临时电子邮箱收件箱。

为你的 Agent 提供八个类型化工具，用于配置一次性地址、等待注册邮件、提取 OTP 验证码和魔法链接，以及在完成后清理。可在 Claude Code、Claude Desktop、Cursor、Windsurf 和任何其他支持 MCP 的客户端中使用。

安装

npm install -g @mailsink/mcp

也可以通过 npx 运行，无需安装：

npx @mailsink/mcp

获取 API 密钥

1. 使用 GitHub 登录 https://mailsink.dev/app。

2. 复制一次性显示的密钥。将其存入密码管理器或 .env 文件。

3. 导出密钥，以便 MCP 服务读取：

   export MAILSINK_API_KEY="msk_..."
   

免费套餐每月提供 50 个收件箱，并包含 MCP。Pro（$15/mo）和 Team（$49/mo）套餐可提高收件箱数量上限、提升邮件大小限制、延长 TTL，并提高请求速率。请参阅定价。

配置客户端

Claude Code

claude mcp add mailsink -- npx -y @mailsink/mcp

Claude Desktop / Cursor / Windsurf

将以下内容添加到客户端配置文件的 mcpServers 部分：

{
  "mcpServers": {
    "mailsink": {
      "command": "npx",
      "args": ["-y", "@mailsink/mcp"],
      "env": {
        "MAILSINK_API_KEY": "msk_..."
      }
    }
  }
}

重启客户端。你应该会看到列有八个工具的 mailsink 服务。

工具

工具	用途
create_inbox	配置一个一次性地址。返回 email、id、expires_at。
list_inboxes	列出账户中的活跃收件箱。
wait_for_email	最多等待 timeout 秒（上限为 120），直到收到任意邮件。
get_verification_code	从收件箱中提取最新的 OTP 验证码（持续轮询，直到找到验证码或超时）。
get_verification_link	提取最新的魔法链接。
list_messages	列出收件箱中所有邮件的摘要。
get_message	根据 ID 获取特定邮件的完整内容。
delete_inbox	立即销毁收件箱。

Agent 工作流示例

> Sign me up for Figma, capture the verification code, confirm, and
> tell me the plan once you're in.

[agent invokes]
  create_inbox()                                → [email protected]
  [agent fills the Figma signup form with that address]
  wait_for_email(inbox_id)                      → blocks 30s…
                                                → returns email + OTP
  [agent types the OTP into the Figma form]
  delete_inbox(inbox_id)                        → cleanup

无需配置 Webhook。无需 IMAP 凭据。无需解析 MIME。

环境变量

• MAILSINK_API_KEY （必填） — 你的账户 API 密钥。
• MAILSINK_API_URL （可选，默认值为 https://api.mailsink.dev） — 用于可自托管或开发环境的 API 地址覆盖项。

源码

https://github.com/heocoi/mailsink/tree/main/mcp

许可证

MIT — 详见 LICENSE。