smails

io.github.pexni由 GitHub 账号 pexni 发布v0.1.0更新于 Nov 5, 2026

Disposable email inboxes for AI agents: create an address, wait for the verification email.

已验证Streamable HTTP可网页运行开发者工具沟通与协作

概览

AI 生成的概览

为 AI 代理提供一次性邮箱：创建地址、等待验证邮件并读取验证码。

可以做什么
  • 创建和列出一次性邮箱，新邮箱会成为当前邮箱
  • 等待新邮件，可按发件人、主题、超时时间或起始时间筛选
  • 列出、读取和删除邮箱中的邮件
  • 使用 GitHub 登录，并查看账户与当日配额
适用场景
适合代理需要注册要求邮箱验证的服务，并要获取确认码或确认链接，而不想使用真实个人邮箱的场景。
运行要求
可通过 streamable HTTP 连接 smails.dev 远程端点，或使用 Node.js 22.18 及以上版本运行本地 npm 包 @smails/cli。必须使用 GitHub 登录，可通过 login 工具或 CLI 的 login 命令完成；会话保存在本地凭据文件中。声明使用 OAuth 认证。
安装前请注意
登录会关联 GitHub 账户并在本机保存会话凭据。邮箱为一次性，README 说明 0.1 升级后旧的已保存邮箱不再可用。邮件可被删除，邮件内容由 smails.dev 服务保存。

安装

在 SourceWeft 中

  1. 打开 控制台中的 smails，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.pexni%2Fsmails/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "smails": {
      "type": "http",
      "url": "https://smails.dev/mcp"
    }
  }
}

README

@smails/cli

[npm]

Disposable email for AI agents. Create an inbox, use the address to sign up somewhere, and wait for the verification code — from a terminal, a script, Claude Code or Codex.

→ smails.dev

Requires Node.js 22.18 or newer. No runtime dependencies.

Sign in (once)

bash
npx @smails/cli login

It prints a link and opens your browser: sign in with GitHub and confirm the code. The session is stored in ~/.config/smails/credentials.json and shared with the MCP server below.

Get a verification code

bash
npx @smails/cli create                    # → [email protected]npx @smails/cli wait --subject code       # blocks until it arrives, prints the messagenpx @smails/cli wait --json | jq -r .text # in scripts

wait exits with status 2 if nothing arrives before --timeout (default 120 s).

Commands

Command
login / logout / whoamiAccount and today's quota
createNew mailbox; becomes the current one
listYour active mailboxes
inbox [address]Messages (default: current mailbox)
read <id>One message (short id prefix works)
wait [address]Wait for new mail: --from, --subject, --timeout, --since
delete <id>Delete a message
mcpRun the MCP server over stdio

Add --json for machine-readable output. npm i -g @smails/cli to type smails instead of npx @smails/cli.

MCP server

Remote (recommended) — or just tell your agent: Set up smails for me by following https://smails.dev/setup.md

bash
claude mcp add --transport http --scope user smails https://smails.dev/mcp   # Claude Code, then /mcp to sign incodex mcp add smails --url https://smails.dev/mcp && codex mcp login smails  # Codex

Local (stdio):

bash
claude mcp add smails -- npx -y @smails/cli mcp   # Claude Codecodex mcp add smails -- npx -y @smails/cli mcp    # Codex

Sign in with npx @smails/cli login, or let the agent call the login tool, which returns a link for you to confirm. Tools: create_mailbox, wait_for_message, list_messages, read_message, list_mailboxes, delete_message, whoami.

Upgrading from 0.0.x

0.1 requires signing in; the anonymous API is gone and old saved mailboxes no longer work. Run npx @smails/cli login, then create.

Environment

SMAILS_URL — server to use (default https://smails.dev).

License

MIT

来源：cli/README.md，提交 815dbe0

工具

1

login

Sign in to smails

Sign in to smails with GitHub. The first call returns a link for the user to open and confirm; call login again after they confirm. Only needed once per machine.

无需输入参数。

版本历史

2
  1. v0.1.0最新Nov 5, 2026
  2. v0.0.12Sep 16, 2026

评分

已满足适用检查项的 100%

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

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分