UnCorreoTemporal /Documentación/MCP Server

MCP Email Server

Servidor MCP nativo que expone 5 herramientas de email para agentes de IA. Compatible con Claude Desktop, Cursor, Continue y cualquier cliente que implemente el Model Context Protocol .

¿Qué es MCP?

El Model Context Protocol (MCP) es un estándar abierto creado por Anthropic que permite a los agentes de IA acceder a herramientas externas de forma nativa. En lugar de escribir prompts para simular acciones, el agente llama directamente a funciones tipadas con parámetros y respuestas estructuradas.

Nativo, no simulado

El agente llama funciones reales con parámetros tipados. No depende de que el LLM interprete texto libre.

Sin estado compartido

Cada llamada es independiente. El servidor MCP gestiona la autenticación una sola vez al arrancar.

Compatible con cualquier LLM

Claude, GPT-4, Gemini — cualquier modelo con soporte MCP puede usar estas herramientas.

Instalación

1 Obtener una API Key

El servidor MCP requiere un plan Builder o superior. Crea un buzón en la homepage y activa tu plan para obtener una API key con prefijo uct_ .

2 Instalar el paquete Python

pip install uncorreotemporal-mcp

3 Configurar Claude Desktop

Agrega la siguiente entrada a claude_desktop_config.json (ubicado en ~/Library/Application Support/Claude/ en macOS):

claude_desktop_config.json

{
  "mcpServers": {
    "uncorreotemporal": {
      "command": "python",
      "args": ["-m", "uncorreotemporal_mcp"],
      "env": {
        "UCT_API_KEY": "uct_xxxxx"
      }
    }
  }
}

Reinicia Claude Desktop tras guardar. Las 5 herramientas aparecerán automáticamente en el menú de herramientas del chat.

create_mailboxtool

Crea un nuevo buzón temporal. El agente obtiene una dirección de email única para usarla en registros o verificaciones.

Parámetros

ttl_minutes opcional · integer ≥ 1

Retorna

{
  address: "slug@domain.com",
  expires_at: "ISO8601",
  ttl_minutes: 60
}

list_mailboxestool

Lista todos los buzones activos asociados a la API key del agente.

Retorna

{ mailboxes: [
  { address, expires_at, message_count }
]}

get_messagestool

Lista los mensajes de un buzón (sin body). Ideal para detectar si llegó un email de verificación antes de leerlo completo.

Parámetros

address requerido · string

limit opcional · 1-100, default 20

Retorna (por mensaje)

id, from_address, subject
received_at, is_read
has_attachments

read_messagetool

Retorna el contenido completo de un mensaje (text y HTML). Marca el mensaje como leído. El agente extrae el código de verificación o link directamente del body_text.

Parámetros

address requerido · string

message_id requerido · UUID string

Retorna

id, from_address, to_address
subject, body_text, body_html
attachments[], received_at

delete_mailboxtool

Elimina el buzón cuando ya no es necesario. Buena práctica para mantener dentro de los límites del plan en flujos de larga duración.

Parámetros

address requerido · string

Flujo completo — Registro autónomo

El siguiente ejemplo muestra cómo un agente Claude usa las 5 herramientas para registrarse en un servicio web sin intervención humana:

Prompt al agente Claude

"Regístrate en example.com con un email temporal, confirma la cuenta y dime el nombre de usuario generado."

create_mailbox(ttl_minutes=60) → obtiene agent42@uncorreotemporal.com

[browser action] → se registra en example.com con ese email

get_messages(address=agent42@...) → detecta 1 mensaje nuevo de noreply@example.com

read_message(address=agent42@..., message_id=...) → extrae el código de verificación "847291" del body_text

[browser action] → ingresa el código → cuenta confirmada

delete_mailbox(address=agent42@...) → limpia el buzón

Límites por plan

Plan	MCP	Llamadas/mes	Concurrencia
Free	—	—	—
Builder	✓ Incluido	500/mes	1 agente
Pro	✓ Incluido	5,000/mes	5 agentes
Team	✓ Incluido	20,000/mes	20 agentes
Enterprise	✓ Incluido	Custom	Custom

Al superar el límite de llamadas, la herramienta retorna {"error": "quota_exceeded"}. El agente debe manejar este caso y notificar al usuario.

API REST Crear buzón gratis →