UnCorreoTemporal

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

Temporary email for AI agents: create inboxes, wait for emails, extract OTPs, verify signups.

已验证STDIO仅桌面效率与工作流沟通与协作

概览

AI 生成的概览

面向 AI 代理的临时邮箱服务器：创建收件箱、等待验证邮件，并提取验证码或验证链接。

可以做什么
  • 按服务名和可选有效期创建临时注册收件箱
  • 等待并获取验证邮件，可按主题和发件人过滤
  • 从邮件正文或指定收件箱邮件中提取验证码或验证链接
  • 一次调用完成整个注册流程：建箱、等邮件、提取链接与验证码
适用场景
适合助手需要完成某个服务的邮箱验证注册，并希望自动获取验证码或验证链接，而不是由人工查看邮箱的场景。
运行要求
以 Python 包形式通过 uvx（或 Docker）在本机运行，也可连接公开的远程端点。本地安装需要 UCT_API_KEY 中的 UnCorreoTemporal API 密钥；UCT_API_BASE 可覆盖 API 基础地址。需要能访问 UnCorreoTemporal API 的网络。
安装前请注意
UCT_API_KEY 是密钥，文档中的配置方式以明文环境变量传入。收件箱地址和收到的邮件内容由 UnCorreoTemporal 服务处理，验证邮件及其中的验证码会经过该第三方。在第三方服务上自动注册可能违反其条款，且该服务器可将邮件标记为已读。

安装

在 SourceWeft 中

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

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

其他 MCP 客户端

参照 仓库 中的启动说明。

README

[UCT Demo]

uncorreotemporal-mcp

[MCP Badge]

MCP server for UnCorreoTemporal, focused on autonomous signup and email verification workflows.

[Glama]

Architecture Demo

text
AI Agent   |   | MCP   vTemporary Email MCP Server   |   vUnCorreoTemporal API

Remote Connection (No Installation)

Connect directly to the public endpoint — no local install needed:

json
{  "mcpServers": {    "uncorreotemporal-mcp": {      "url": "https://uncorreotemporal.com/mcp"    }  }}

The public endpoint is free to use for testing. For production workloads, set your own UCT_API_KEY via local install.

Installation

Claude Code

bash
claude mcp add uncorreotemporal -e UCT_API_KEY=uct_your_key_here -- uvx uncorreotemporal-mcp

Claude Desktop (claude_desktop_config.json)

json
{  "mcpServers": {    "uncorreotemporal": {      "command": "uvx",      "args": ["uncorreotemporal-mcp"],      "env": {        "UCT_API_KEY": "uct_your_key_here"      }    }  }}

Get your API key at uncorreotemporal.com.

Quickstart (30 seconds)

bash
uvx uncorreotemporal-mcp

Or run local project version:

bash
UCT_API_KEY=uct_your_key_here \uv run uncorreotemporal-mcp

Minimal Workflow Example

python
inbox = await create_signup_inbox("github")email = await wait_for_verification_email(inbox["inbox_id"])link = await extract_verification_link(    inbox_id=inbox["inbox_id"],    message_id=email["message_id"],)

Public Tools

  • create_signup_inbox
  • wait_for_verification_email
  • get_latest_email
  • extract_otp_code
  • extract_verification_link
  • complete_signup_flow

New v1 tool: complete_signup_flow

Runs:

  1. create inbox
  2. wait verification email
  3. extract verification link + OTP

Input:

json
{  "service_name": "github",  "timeout_seconds": 90,  "poll_interval_seconds": 3,  "subject_contains": "verify",  "from_contains": "noreply",  "preferred_domains": ["github.com"],  "ttl_minutes": 30}

Output:

json
{  "status": "success",  "inbox_id": "[email protected]",  "email": "[email protected]",  "verification_message": {    "message_id": "msg-1",    "subject": "Verify your email",    "from_address": "[email protected]",    "received_at": "2026-03-08T11:30:00Z"  },  "verification_link": "https://example.com/confirm?t=abc",  "otp_code": "483920",  "link_candidates": ["https://example.com/confirm?t=abc"],  "otp_candidates": ["483920"]}

status can be success, partial_success, or timeout.

Tool I/O summary

create_signup_inbox(service_name, ttl_minutes?)

Returns:

json
{  "inbox_id": "[email protected]",  "email": "[email protected]",  "expires_at": "2026-03-08T12:00:00Z",  "service_name": "github"}

wait_for_verification_email(inbox_id, timeout_seconds?, poll_interval_seconds?, subject_contains?, from_contains?)

Returns:

json
{  "status": "received",  "message_id": "msg-1",  "received_at": "2026-03-08T11:30:00Z",  "subject": "Verify your account",  "from_address": "[email protected]",  "timeout_seconds": 90}

get_latest_email(inbox_id, mark_as_read?)

Returns full message body and metadata.

extract_otp_code(message_text? | inbox_id+message_id, otp_length_min?, otp_length_max?)

Returns:

json
{  "otp_code": "483920",  "candidates": ["483920"]}

extract_verification_link(message_text? | inbox_id+message_id, preferred_domains?)

Returns:

json
{  "verification_link": "https://example.com/confirm?t=abc",  "candidates": ["https://example.com/confirm?t=abc"]}

Configuration

Environment variables:

  • UCT_API_KEY (required)
  • UCT_API_BASE (optional, default: https://uncorreotemporal.com)
  • UCT_HTTP_TIMEOUT_SECONDS (optional, default: 20)
  • UCT_MCP_TRANSPORT (optional, stdio by default; also supports streamable-http and sse)
  • UCT_MCP_HOST (optional, default: 0.0.0.0)
  • UCT_MCP_PORT (optional, default: 8000)
  • UCT_MCP_PATH (optional, default: /mcp)

Important: inbox_id == email address.

Examples

See /examples:

  • simple_workflow.py
  • openai_agent_signup.py
  • langchain_agent_signup.py
  • agent_creates_account.py

Run dry-run:

bash
uv run python examples/simple_workflow.py --dry-run

Docker

Build:

bash
docker build -t uncorreotemporal-mcp .

Run stdio mode:

bash
docker run --rm -i \  -e UCT_API_KEY=uct_your_key_here \  uncorreotemporal-mcp

Run streamable-http mode:

bash
docker run --rm -p 8000:8000 \  -e UCT_API_KEY=uct_your_key_here \  -e UCT_MCP_TRANSPORT=streamable-http \  -e UCT_MCP_PATH=/mcp \  uncorreotemporal-mcp

Breaking Changes

Removed legacy low-level tools:

  • create_mailbox
  • list_mailboxes
  • get_messages
  • read_message
  • delete_mailbox

Migration map:

  • create_mailbox -> create_signup_inbox
  • get_messages + read_message -> wait_for_verification_email + get_latest_email
  • multi-step signup orchestration -> complete_signup_flow

Directory listing assets

Prepared listing payloads are in /directory-listings for:

  • modelcontextprotocol/servers
  • mcp.so
  • awesome-mcp

Public endpoint deployment

Deployment templates for https://uncorreotemporal.com/mcp are in /deploy.

Development

bash
uv run pytestuv run uncorreotemporal-mcp

来源：README.md，提交 8f10a68

工具

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

版本历史

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

评分

已满足适用检查项的 50%

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

  • 近 30 天内可连通25 分

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

  • 已声明认证方式10 分

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

  • 已列出工具15 分

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

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