uncorreotemporal-mcp

MCP-сервер для UnCorreoTemporal, ориентированный на автономные рабочие процессы регистрации и подтверждения электронной почты.

Демонстрация архитектуры

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

Related MCP server: courier-mcp

Удаленное подключение (без установки)

Подключайтесь напрямую к общедоступной конечной точке — локальная установка не требуется:

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

Общедоступная конечная точка бесплатна для тестирования. Для рабочих нагрузок установите свой собственный UCT_API_KEY через локальную установку.

Установка

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

Получите свой API-ключ на сайте uncorreotemporal.com.

Быстрый старт (30 секунд)

uvx uncorreotemporal-mcp

Или запустите локальную версию проекта:

UCT_API_KEY=uct_your_key_here \
uv run uncorreotemporal-mcp

Пример минимального рабочего процесса

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"],
)

Публичные инструменты

• create_signup_inbox

• wait_for_verification_email

• get_latest_email

• extract_otp_code

• extract_verification_link

• complete_signup_flow

Новый инструмент v1: complete_signup_flow

Выполняет:

1. создание почтового ящика

2. ожидание письма с подтверждением

3. извлечение ссылки для подтверждения + OTP

Входные данные:

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

Выходные данные:

{
  "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 может принимать значения success, partial_success или timeout.

Сводка ввода/вывода инструментов

create_signup_inbox(service_name, ttl_minutes?)

Возвращает:

{
  "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?)

Возвращает:

{
  "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?)

Возвращает полное тело сообщения и метаданные.

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

Возвращает:

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

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

Возвращает:

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

Конфигурация

Переменные окружения:

• UCT_API_KEY (обязательно)

• UCT_API_BASE (опционально, по умолчанию: https://uncorreotemporal.com)

• UCT_HTTP_TIMEOUT_SECONDS (опционально, по умолчанию: 20)

• UCT_MCP_TRANSPORT (опционально, по умолчанию stdio; также поддерживает streamable-http и sse)

• UCT_MCP_HOST (опционально, по умолчанию: 0.0.0.0)

• UCT_MCP_PORT (опционально, по умолчанию: 8000)

• UCT_MCP_PATH (опционально, по умолчанию: /mcp)

Важно: inbox_id == адрес электронной почты.

Примеры

См. /examples:

• simple_workflow.py

• openai_agent_signup.py

• langchain_agent_signup.py

• agent_creates_account.py

Запуск пробного прогона:

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

Docker

Сборка:

docker build -t uncorreotemporal-mcp .

Запуск в режиме stdio:

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

Запуск в режиме streamable-http:

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

Критические изменения

Удалены устаревшие низкоуровневые инструменты:

• create_mailbox

• list_mailboxes

• get_messages

• read_message

• delete_mailbox

Карта миграции:

• create_mailbox -> create_signup_inbox

• get_messages + read_message -> wait_for_verification_email + get_latest_email

• многошаговая оркестрация регистрации -> complete_signup_flow

Активы для листинга в каталогах

Подготовленные полезные нагрузки для листинга находятся в /directory-listings для:

• modelcontextprotocol/servers

• mcp.so

• awesome-mcp

Развертывание общедоступной конечной точки

Шаблоны развертывания для https://uncorreotemporal.com/mcp находятся в /deploy.

Разработка

uv run pytest
uv run uncorreotemporal-mcp