Overview
Integraciones con IA (MCP)
Connect the official esimoa MCP server so AI assistants can search and compare eSIMs and share purchase links.
Server URL#
El servidor MCP oficial de esimoa https://api.esimoa.com/mcp permite a los asistentes de IA buscar y comparar eSIM y compartir enlaces de compra. Usa Streamable HTTP (JSON sin estado) y funciona sin clave (120 solicitudes/min por IP).
https://api.esimoa.com/mcpAdding your partner key#
Propina
https://api.esimoa.com/mcp?key=esk_live_your_key_hereLos clientes que admiten cabeceras pueden enviar X-API-Key o Authorization: Bearer en su lugar. Una clave incorrecta se rechaza con 401; para usar el servidor sin clave, omítela por completo.
Available tools#
| Campo | Tipo | Descripción |
|---|---|---|
search_esims | tool | Buscar eSIM: country (código ISO o nombre del país en cualquier idioma), days, data_gb, unlimited, sort, limit (≤10), lang |
get_esim | tool | Detalles de la eSIM — id, lang |
list_countries | tool | Países a la venta — query, lang |
search / fetch | tool | Herramientas compatibles con ChatGPT — search {query}, fetch {id} |
Rate limits#
Nota
La API pública y el MCP autenticado comparten una cuota por hora para cada socio (20.000 por defecto). Añadir o rotar claves no la aumenta.
La ventana de 3,600 segundos empieza con la primera solicitud; el límite por minuto también se aplica. Las cuotas cuentan llamadas, no MB transferidos. La configuración operativa puede cambiar la cuota.
Los lotes de MCP admiten hasta 100 mensajes y cada mensaje cuenta como una llamada. Un lote que supere la cuota disponible devuelve 429 antes de ejecutarse.
X-RateLimit-Hour-Limit · X-RateLimit-Hour-Remaining · X-RateLimit-Hour-Reset
Estas cabeceras indican el límite por hora, las llamadas restantes y la hora de restablecimiento (segundos Unix). Al agotar el límite por hora se devuelve HTTP 429 y Retry-After en segundos. Las llamadas rechazadas por el límite por minuto no cuentan para la cuota por hora.
Sin clave, el límite es de 120 solicitudes por minuto por IP; con una clave de partner, 600 por minuto por clave. Si lo superas, recibirás un error JSON-RPC (-32002) con HTTP 429.