Skip to main content
Glama

UCT Demo

uncorreotemporal-mcp

MCP Badge

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

Glama

Architecture Demo

AI Agent
   |
   | MCP
   v
Temporary Email MCP Server
   |
   v
UnCorreoTemporal API

Related 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-mcp

Claude 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-mcp

Or run local project version:

UCT_API_KEY=uct_your_key_here \
uv run uncorreotemporal-mcp

Minimal 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_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:

{
  "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"]
}

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, 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:

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

Docker

Build:

docker build -t uncorreotemporal-mcp .

Run stdio mode:

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

Run 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-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

uv run pytest
uv run uncorreotemporal-mcp

Available Tools

6 tools
complete_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

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

    B3.2/5.0

    Scored across 6 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    Six tools is well-scoped for a temporary inbox and signup verification server. Each tool covers a distinct stage without unnecessary duplication.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      MCP 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.
      7
      53 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that gives AI agents disposable email addresses and real phone numbers with automatic OTP extraction and self-destructing identities.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Provides disposable email inboxes for AI agents to automatically receive and extract OTPs and magic links, enabling seamless email verification during autonomous workflows.
      3
      262 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Disposable email for humans and AI agents. Enables AI agents to create mailboxes and receive verification emails through an MCP server.
      39
      MIT

    Appeared in Searches