Llama al servidor MCP de correo
directamente desde curl o un script
Sin cliente, sin SDK. Un único endpoint Streamable HTTP que habla JSON-RPC 2.0, autenticado con una clave bearer de permisos limitados que puedes revocar con un clic.
Haz un POST de JSON-RPC 2.0 a https://mcpemails.com/api/mcp con un encabezado Authorization Bearer que lleve una clave de API de tu panel. Los métodos admitidos son initialize, tools/list, tools/call, prompts/list y prompts/get.
Cómo se conecta un script o un cliente HTTP directo: una clave de API con permisos limitados
Un script o un cliente HTTP directo no ejecuta el flujo OAuth en el navegador contra un servidor MCP remoto, así que se autentica con un token bearer. Crea una clave de API en tu panel, marca solo los permisos que necesita el agente y ponla en el script o cliente HTTP como encabezado Authorization: Bearer. Las conexiones con clave y las conexiones OAuth llegan al mismo endpoint y reciben el mismo catálogo de herramientas; la única diferencia es cómo se obtiene el token.
El único valor que necesitas
Todo en esta página es una forma de llevar esta URL a curl and the raw API.
| Campo | Valor |
|---|---|
| URL del servidor MCP | https://mcpemails.com/api/mcp |
| Transporte | Streamable HTTP (MCP 2025-06-18) |
| Autenticación | Authorization: Bearer, con una clave de API de permisos limitados de tu panel. |
Cómo conectar curl and the raw API a tu bandeja
Cuatro pasos. Los dos primeros son iguales para todos los clientes, el resto son propios de este.
Crea una cuenta gratis y conecta un buzón
Regístrate en mcpemails.com, sin tarjeta, y luego ve a Dashboard, Inboxes, Connect Inbox. Outlook y Microsoft 365 se conectan con el inicio de sesión de Microsoft; Gmail, iCloud, Fastmail, Yahoo, Zoho y Yandex requieren una contraseña de aplicación; cualquier otro se conecta por IMAP y SMTP estándar. El plan gratuito incluye una bandeja, para siempre.
Crea una clave de API con permisos limitados
En Dashboard, API Keys, haz clic en Create key. Ponle un nombre y marca solo los permisos que necesita este agente: read:email, search:email, send:email, manage:folders, delete:email, manage:drafts, manage:contacts, schedule:email y manage:automations. La clave tiene la forma mcpe_ seguida de 64 caracteres hexadecimales y solo se muestra una vez, así que cópiala antes de cerrar el diálogo.
Llama al endpoint
Haz un POST con un cuerpo JSON-RPC 2.0 a https://mcpemails.com/api/mcp con la clave en el encabezado Authorization. Empieza con tools/list para ver el catálogo y luego inbox_list para descubrir los ids de tus buzones.
Procesa la respuesta
Los resultados llegan como JSON-RPC 2.0. Los resultados correctos incluyen además un objeto tipado structuredContent, así que un script no tiene que analizar prosa.
curl -X POST https://mcpemails.com/api/mcp \
-H "Authorization: Bearer mcpe_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'¿No sabes qué buzón conectar primero? Consulta la tabla de compatibilidad de proveedores
En qué suele tropezar la gente con curl
Envía la clave en el encabezado, no en la query string
Una clave en ?key= o ?api_key= todavía se acepta para integraciones anteriores al encabezado, pero no debería usarse en nada nuevo. Las credenciales en la URL quedan en el historial del navegador, en los logs de proxies, en los encabezados referrer y en los sistemas de monitorización, y nada de eso lo controlas tú. El encabezado Authorization es la vía admitida.
Las llamadas salientes aceptan una clave de idempotencia, y reintentar sin ella es un riesgo real
Send, reply, forward, el envío de borradores y el envío programado aceptan una clave de idempotencia opcional, respetada durante 24 horas. Un timeout de red en un envío es ambiguo por naturaleza: puede que el correo sí haya salido. Con una clave de idempotencia, el reintento es seguro. Sin ella, un reintento es un segundo correo.
Las operaciones largas son largas de verdad
Se ha observado en producción que un search-and-move sobre un buzón grande tarda unos 152 segundos, y el proxy permite hasta 270 segundos antes de rendirse por su cuenta. Configura un timeout de cliente acorde, en lugar de los pocos segundos habituales, o cancelarás operaciones que estaban a punto de terminar bien.
No hay push, en ninguna dirección
Sin webhooks, sin eventos iniciados por el servidor, sin URL de callback que registrar. Reaccionar al correo nuevo significa consultar periódicamente, por ejemplo email_read con action: "list" y solo no leídos, con el intervalo que necesite tu flujo de trabajo. Los límites son 100 por minuto, 1.000 por hora y 10.000 al día por clave.
Límites que conviene conocer
- Las solicitudes están limitadas a 100 por minuto, 1.000 por hora y 10.000 al día por clave, además del tope de acciones facturables de tu plan.
- El servidor funciona solo por petición y respuesta. No hay webhooks ni eventos iniciados por el servidor, así que el correo nuevo nunca despierta a tu agente por sí solo. Para reaccionar al correo entrante, consulta periódicamente según un horario.
- El correo se obtiene en vivo de tu proveedor en cada llamada y nunca se almacena. Solo se guarda el token OAuth o la contraseña de aplicación cifrados, así que un token revocado o un cambio de contraseña del buzón corta el acceso de inmediato.
curl and the raw API y el correo: preguntas resueltas
¿Puedo usarlo sin un cliente MCP?
Sí. Es un endpoint HTTPS normal que habla JSON-RPC 2.0, así que curl, un cron, un servicio backend o cualquier librería HTTP pueden llamarlo. Autentícate con una clave de API bearer de Dashboard, API Keys. El catálogo de herramientas es idéntico al que ve un cliente MCP.
¿Qué métodos JSON-RPC se admiten?
initialize, tools/list, tools/call, prompts/list y prompts/get. Los resultados correctos llevan un objeto tipado structuredContent junto al contenido legible, y eso es lo que debería leer un script.
¿Cómo hago que los reintentos sean seguros?
Pasa una clave de idempotencia en las operaciones salientes. Send, reply, forward, el envío de borradores y el envío programado la aceptan y la respetan durante 24 horas, así que reintentar la misma solicitud tras un timeout no puede generar un segundo correo. Las lecturas se pueden reintentar sin riesgo por naturaleza.
¿Cuáles son los límites de uso?
100 solicitudes por minuto, 1.000 por hora y 10.000 al día por clave, además del tope de acciones facturables de tu plan. Las llamadas fallidas e inbox_list no se facturan.
¿Se guarda mi correo en los servidores de MCPEmails?
No. Cada mensaje se obtiene en vivo de tu proveedor para la solicitud que lo pidió y se entrega directamente a tu cliente. Solo se guarda el token OAuth o la contraseña de aplicación cifrados, para que las llamadas futuras puedan autenticarse. Eliminar la bandeja en el panel, o revocar el acceso en tu proveedor, corta la conexión al instante.
Automatiza tu bandeja con scripts
Un endpoint, una clave con permisos limitados. Una bandeja gratis para siempre, sin tarjeta.