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 分