Developers

Desarrolla con la API de ChatTempMail

Correo temporal con superpoderes de IA — API REST, especificación OpenAPI 3.1, servidor MCP, agent skill y webhooks. Clave API y bandeja desechable en menos de un minuto.

Inicio rápido

Tres llamadas hasta tu primer código de verificación. URL base: https://chat-tempmail.com. Todos los endpoints aceptan X-API-Key o Authorization: Bearer.

1) List available domains

curl https://chat-tempmail.com/api/email/domains \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY"

2) Create a disposable address (1 hour)

curl -X POST https://chat-tempmail.com/api/emails/generate \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "test", "expiryTime": 3600000, "domain": "chat-tempmail.com"}'

3) Poll for messages

curl https://chat-tempmail.com/api/emails/{emailId} \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY"

Recursos legibles por máquinas

URLs predecibles que los agentes pueden descubrir por su nombre:

Especificación OpenAPI 3.1

Esquema completo de la API REST con operationIds, parámetros tipados y esquemas de respuesta. También en /api/openapi.json y /.well-known/openapi.json.

llms.txt

Resumen del sitio y de la API en markdown, con una sección when-to-use para agentes. Se sirve como text/markdown al enviar Accept: text/markdown.

Servidor MCP

Acceso nativo a herramientas para Claude, Cursor y VS Code. Se ejecuta en local vía npm: mcp-server-tempmail.

Agent skill

Skill instalable que enseña a los agentes de código el flujo completo: crear bandeja, sondear, procesar con IA.

CLI y paquete MCP

npx mcp-server-tempmail funciona por sí solo como herramienta tipo CLI; paquete npm oficial.

Autenticación

Sin bailes de OAuth: crea una clave API en tu página de Perfil y envíala como cabecera. Las claves tienen los mismos permisos que tu cuenta — regenera de inmediato si se filtra.

1Inicia sesión y abre tu página de Perfil
2Crea una clave API (se muestra una sola vez — guárdala con seguridad)
3Envía X-API-Key: YOUR_API_KEY (o Authorization: Bearer YOUR_API_KEY) en cada petición

X-API-Key: YOUR_API_KEY

Webhooks

En vez de sondear, configura un webhook (POST /api/webhook) y ChatTempMail hará POST de cada mensaje entrante a tu URL con la cabecera X-Webhook-Event: new_message. Responde 2xx rápido; las entregas fallidas se reintentan, así que mantén el endpoint idempotente.

Configure a webhook

curl -X POST https://chat-tempmail.com/api/webhook \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://your-server.com/webhook", "enabled": true}'

Sandbox y límites de tasa

No hay sandbox separado: cualquier cuenta puede crear direcciones temporales gratis. Los planes de pago desbloquean operaciones de IA (resumir/traducir/QA/extraer), direcciones permanentes y adjuntos. Los endpoints de listado devuelven 20 elementos por página; la paginación es por cursor. Los endpoints de IA tienen límites diarios por rol visibles en las cabeceras de respuesta X-AI-Remaining.

Soporte

Preguntas, errores, peticiones de funciones:

GitHub Correo electrónico