Tmailor temporary email

tmailor-mcp

适用于 Tmailor Open API 的 MCP 服务。它为 AI Agent（Claude、Cursor、 VS Code Copilot 和其他任何 MCP 客户端）提供真实的、仅用于接收邮件的临时邮箱地址：在某处注册，等待邮件， 然后获取一次性验证码或验证链接。

You:   Sign up on example.com with a temporary email and confirm the account.
Agent: create_mailbox -> [email protected]
       (fills in the sign-up form)
       wait_for_message -> otp "482913", links ["https://example.com/confirm?t=..."]

计费按邮箱数量计算，而不是按请求数量计算：创建一个地址会使用 1 个配额单位，而等待和读取邮件免费。地址永不过期。

要求

• Tmailor API 密钥：登录 https://platform.tmailor.com，并在 API keys 下创建密钥。
• uv（用于 uvx）或 Python 3.10+。
• Free plan 下，API 只接受来自 IP 允许名单的调用：请在 IP allowlist 下添加运行 MCP 服务的计算机的公网 IP。付费方案接受来自任何 IP 的调用。

安装

服务在本地通过 stdio 运行。API 密钥从 TMAILOR_API_KEY 环境变量读取。

Claude Code

claude mcp add tmailor -e TMAILOR_API_KEY=tmk_live_... -- uvx tmailor-mcp

Claude Desktop

编辑 claude_desktop_config.json（Settings > Developer > Edit Config）：

{
  "mcpServers": {
    "tmailor": {
      "command": "uvx",
      "args": ["tmailor-mcp"],
      "env": { "TMAILOR_API_KEY": "tmk_live_..." }
    }
  }
}

Cursor

~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）使用与上文相同的 mcpServers 配置块。

VS Code

.vscode/mcp.json。密钥只需输入一次，由 VS Code 保存，而不会写入文件：

{
  "inputs": [
    { "type": "promptString", "id": "tmailor-key", "description": "Tmailor API key", "password": true }
  ],
  "servers": {
    "tmailor": {
      "type": "stdio",
      "command": "uvx",
      "args": ["tmailor-mcp"],
      "env": { "TMAILOR_API_KEY": "${input:tmailor-key}" }
    }
  }
}

其他 MCP 客户端

tmailor-mcp 已列入 MCP Registry，条目为 io.github.tmailor-com/tmailor-mcp，因此可浏览该注册表的客户端可以直接安装。

不使用 uv

pip install tmailor-mcp
TMAILOR_API_KEY=tmk_live_... tmailor-mcp

工具

工具	功能
create_mailbox	创建地址（在共享域名上随机生成，或在你自己的已验证域名上使用指定名称）。使用 1 个配额单位。
wait_for_message	返回符合可选发件人／主题筛选条件的最新未读邮件，或等待邮件到达（最长 300 s）。包含 otp、codes、links 和正文（body_format）。
list_messages	列出某个地址的邮件（最近 24 小时），不含正文。
read_message	返回一封邮件，包含 otp、codes、links 和正文（body_format）。

wait_for_message 和 read_message 的 body_format：text（纯文本，默认值，截断至 max_chars）、html （收到的原始 HTML，保持原样，截断至 max_html_chars，默认 100000）或 both。has_html 表示邮件是否包含 HTML 部分；对于不含 HTML 部分的邮件，html 会返回文本。 | delete_mailbox | 永久删除一个地址。不会退还配额。 | | list_mailboxes | 列出你的地址，按新旧顺序排列（最新的在前）。 | | list_domains | 列出你的域名，以及共享域名是否可用。 | | account_status | 查看剩余配额、方案和请求速率。 |

工具只接收和返回电子邮件地址。API 的地址令牌保留在服务进程内部，不会出现在对话中。

安全说明

• 邮件内容不可信。 任何人都可以向某个地址发送邮件。服务默认返回纯文本，并为每封邮件标记 untrusted_content_notice。使用 body_format="html" 或 "both" 时，你会收到保持原样的原始 HTML（包括脚本、跟踪像素和隐藏文本）：请仅以你选择的安全方式渲染或解析。Agent 应将邮件用作数据（验证码、链接），切勿遵循其中的指令。
• 不要将密钥放入共享文件。 建议使用 VS Code 的 inputs 提示，或使用不会提交到代码仓库的用户级配置文件。在 https://platform.tmailor.com/keys 撤销泄露的密钥。
• 付费方案接受来自任何 IP 的 API 调用，因此泄露的密钥在撤销前可从任何地方使用。
• 在同一个服务进程中，wait_for_message 不会重复返回同一封邮件。两个 MCP 服务同时等待同一个地址时（例如，两个 Agent 共用一个密钥），两者都可能收到同一封邮件。

配置

变量	含义
TMAILOR_API_KEY	你的 API 密钥（必填）。
TMAILOR_BASE_URL	仅用于针对其他 API 主机进行测试。

链接

• API 参考文档：https://platform.tmailor.com/docs
• 此服务使用的 Python SDK：tmailor-sdk
• 方案：https://platform.tmailor.com/plans

许可证

MIT