Mailsink

io.github.heocoi由 GitHub 账号 heocoi 发布v0.1.5更新于 Oct 24, 2026

Disposable inboxes for AI agents and CI: catch the verification email, read the OTP or link.

已验证STDIO仅桌面开发者工具沟通与协作

概览

AI 生成的概览

MailSink MCP 为助手提供一次性邮箱，用于接收注册邮件、读取验证码或魔法链接，并在用完后清理。

可以做什么
创建和列出临时邮箱，每个邮箱返回地址、ID 和过期时间，并可在用完后删除邮箱。等待新邮件到达，超时时间最长 120 秒。从邮箱中提取最近的一次性验证码或魔法链接。列出邮箱中的邮件摘要，并按 ID 读取某封邮件的完整内容。
适用场景
适合助手或测试自动化需要完成依赖邮件验证的注册或登录流程时使用，例如获取验证码或确认链接，而无需配置 webhook、IMAP 凭据或解析 MIME。
运行要求
以 npm 包形式在本地运行（需要 Node.js），可全局安装或通过 npx 运行，并在 Claude Code、Claude Desktop、Cursor 或 Windsurf 等 MCP 客户端中配置。需要 MailSink 账户和 API 密钥，通过环境变量 MAILSINK_API_KEY 提供；MAILSINK_API_URL 可覆盖 API 基础地址。需要能访问 MailSink API 的网络。
安装前请注意
MailSink API 密钥（MAILSINK_API_KEY）属于机密，应存放在密码管理器或环境文件中，不要提交到代码库。免费套餐每月 50 个邮箱；付费的 Pro 和 Team 套餐提高上限。邮箱会在账户上创建和删除，收到的邮件内容从 MailSink 服务器获取。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mailsink，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@mailsink/mcp

Model Context Protocol server for MailSink — programmatic temporary email inboxes for AI agents and test automation.

Gives your agent eight typed tools for provisioning disposable addresses, waiting on signup emails, extracting OTP codes and magic links, and cleaning up after itself. Works in Claude Code, Claude Desktop, Cursor, Windsurf, and any other MCP-aware client.

Install

bash
npm install -g @mailsink/mcp

Or run via npx without installing:

bash
npx @mailsink/mcp

Get an API key

  1. Sign in at https://mailsink.dev/app with GitHub.

  2. Copy the key from the one-time reveal. Store it in your password manager or .env.

  3. Export it so the MCP server can read it:

    bash
    export MAILSINK_API_KEY="msk_..."

Free tier is 50 inboxes/month and includes MCP. Pro ($15/mo) and Team ($49/mo) lift the inbox cap, raise email size limits, extend TTL, and bump request rates. See pricing.

Configure your client

Claude Code

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

Claude Desktop / Cursor / Windsurf

Add to the mcpServers section of the client's config file:

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

Restart the client. You should see the mailsink server listed with its eight tools.

Tools

ToolPurpose
create_inboxProvision a throwaway address. Returns email, id, expires_at.
list_inboxesList active inboxes on the account.
wait_for_emailBlock up to timeout seconds (max 120) for any email to arrive.
get_verification_codeExtract the most recent OTP from the inbox (polls until found or timeout).
get_verification_linkExtract the most recent magic link.
list_messagesSummaries of all messages in an inbox.
get_messageFull content of a specific message by ID.
delete_inboxBurn an inbox immediately.

Example agent flow

> 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

No webhook plumbing. No IMAP credentials. No parsing MIME.

Environment variables

  • MAILSINK_API_KEY (required) — your account's API key.
  • MAILSINK_API_URL (optional, default https://api.mailsink.dev) — override for self-hosted or dev API.

Source

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

License

MIT — see LICENSE.

来源：README.md，提交 1df0da2

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.5最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分