UnCorreoTemporal
This server enables AI agents to automate temporary email inbox management and email verification workflows for service signups.
Create temporary email inboxes (
create_signup_inbox): Generate a disposable email address for a target service (e.g., GitHub) with an optional time-to-live (TTL) in minutes.Wait for verification emails (
wait_for_verification_email): Poll an inbox until a verification email arrives or a timeout is reached, with optional filters for sender and subject.Retrieve the latest email (
get_latest_email): Fetch the full content and metadata of the most recent email in an inbox.Extract OTP codes (
extract_otp_code): Parse a numeric one-time password from an email body with configurable min/max code length.Extract verification links (
extract_verification_link): Identify and return the most likely verification URL from an email, with optional preferred domain filtering.Run a complete signup flow (
complete_signup_flow): Execute the full end-to-end workflow in a single call — creating an inbox, waiting for the verification email, and extracting both the verification link and OTP code.
Facilitates autonomous account creation and email verification for GitHub by managing temporary inboxes and extracting verification links or OTP codes from received emails.

uncorreotemporal-mcp
MCP server for UnCorreoTemporal, focused on autonomous signup and email verification workflows.
Architecture Demo
AI Agent
|
| MCP
v
Temporary Email MCP Server
|
v
UnCorreoTemporal APIRelated MCP server: identity-mcp
Remote Connection (No Installation)
Connect directly to the public endpoint — no local install needed:
{
"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
claude mcp add uncorreotemporal -e UCT_API_KEY=uct_your_key_here -- uvx uncorreotemporal-mcpClaude Desktop (claude_desktop_config.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)
uvx uncorreotemporal-mcpOr run local project version:
UCT_API_KEY=uct_your_key_here \
uv run uncorreotemporal-mcpMinimal Workflow Example
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_inboxwait_for_verification_emailget_latest_emailextract_otp_codeextract_verification_linkcomplete_signup_flow
New v1 tool: complete_signup_flow
Runs:
create inbox
wait verification email
extract verification link + OTP
Input:
{
"service_name": "github",
"timeout_seconds": 90,
"poll_interval_seconds": 3,
"subject_contains": "verify",
"from_contains": "noreply",
"preferred_domains": ["github.com"],
"ttl_minutes": 30
}Output:
{
"status": "success",
"inbox_id": "agent42@uncorreotemporal.com",
"email": "agent42@uncorreotemporal.com",
"verification_message": {
"message_id": "msg-1",
"subject": "Verify your email",
"from_address": "noreply@example.com",
"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:
{
"inbox_id": "agent42@uncorreotemporal.com",
"email": "agent42@uncorreotemporal.com",
"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:
{
"status": "received",
"message_id": "msg-1",
"received_at": "2026-03-08T11:30:00Z",
"subject": "Verify your account",
"from_address": "noreply@example.com",
"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:
{
"otp_code": "483920",
"candidates": ["483920"]
}extract_verification_link(message_text? | inbox_id+message_id, preferred_domains?)
Returns:
{
"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,stdioby default; also supportsstreamable-httpandsse)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.pyopenai_agent_signup.pylangchain_agent_signup.pyagent_creates_account.py
Run dry-run:
uv run python examples/simple_workflow.py --dry-runDocker
Build:
docker build -t uncorreotemporal-mcp .Run stdio mode:
docker run --rm -i \
-e UCT_API_KEY=uct_your_key_here \
uncorreotemporal-mcpRun streamable-http mode:
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-mcpBreaking Changes
Removed legacy low-level tools:
create_mailboxlist_mailboxesget_messagesread_messagedelete_mailbox
Migration map:
create_mailbox->create_signup_inboxget_messages+read_message->wait_for_verification_email+get_latest_emailmulti-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
uv run pytest
uv run uncorreotemporal-mcpAvailable Tools
6 toolscomplete_signup_flowB
End-to-end signup helper: create inbox, wait for email, extract link and OTP.
Inputs: service_name (required), timeout_seconds, poll_interval_seconds, subject_contains, +3 more. Returns: object
create_signup_inboxC
Create a temporary signup inbox for a target service.
Inputs: service_name (required), ttl_minutes. Returns: object
extract_otp_codeC
Extract a numeric OTP code from an email body or message reference.
Inputs: message_text, inbox_id, message_id, otp_length_min, +1 more. Returns: object
extract_verification_linkC
Extract the most likely verification link from an email.
Inputs: message_text, inbox_id, message_id, preferred_domains. Returns: object
get_latest_emailB
Read and return the latest full email in an inbox.
Inputs: inbox_id (required), mark_as_read. Returns: object
wait_for_verification_emailC
Wait until a verification email arrives or timeout is reached.
Inputs: inbox_id (required), timeout_seconds, poll_interval_seconds, subject_contains, +1 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clear function, but complete_signup_flow overlaps with the sequence of create/wait/extract, and wait_for_verification_email and get_latest_email could both be seen as email-fetching steps. Descriptions make the boundaries understandable.
All tool names use snake_case with a leading verb and descriptive noun, such as create_signup_inbox, extract_otp_code, and complete_signup_flow. The pattern is consistent and predictable.
Six tools is well-scoped for a temporary inbox and signup verification server. Each tool covers a distinct stage without unnecessary duplication.
The toolset covers the full signup verification lifecycle including inbox creation, email waiting, reading, extraction, and orchestration. Minor gaps like inbox cleanup or explicit no-email handling prevent a perfect score.
Maintenance
Related MCP Connectors
Disposable email inboxes for AI agents: create an address, wait for mail, read OTP codes and links.
Real email inboxes for AI agents: register, receive, read and send mail over MCP. Free to receive.
Disposable email inboxes for AI agents: create an address, wait for the OTP or verify link.
MCP server for e-mail testing: create disposable inboxes, wait for delivery, and extract e-mail content or links - all from your AI agent or test automation workflow. Get a free API key on https://app.zyntra.app/
Related MCP Servers
- AlicenseAqualityBmaintenanceMCP server for disposable email — create inboxes, receive emails, and extract OTP codes. Let your AI agent sign up for services, wait for verification emails, and extract codes autonomously.753 npm1MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that gives AI agents disposable email addresses and real phone numbers with automatic OTP extraction and self-destructing identities.MIT
- AlicenseAqualityBmaintenanceProvides disposable email inboxes for AI agents to automatically receive and extract OTPs and magic links, enabling seamless email verification during autonomous workflows.3262 npmMIT
- AlicenseNot gradedqualityBmaintenanceDisposable email for humans and AI agents. Enables AI agents to create mailboxes and receive verification emails through an MCP server.39MIT