Overview
Intégrations IA (MCP)
Connect the official esimoa MCP server so AI assistants can search and compare eSIMs and share purchase links.
Server URL#
Le serveur MCP officiel d’esimoa https://api.esimoa.com/mcp permet aux assistants IA de rechercher et comparer des eSIM et de partager des liens d’achat. Il utilise Streamable HTTP (JSON sans état) et fonctionne sans clé (120 requêtes/min par IP).
https://api.esimoa.com/mcpPourboire
Adding your partner key#
Pourboire
https://api.esimoa.com/mcp?key=esk_live_your_key_hereLes clients qui prennent en charge les en-têtes peuvent envoyer X-API-Key ou Authorization: Bearer à la place. Une clé incorrecte est rejetée avec une erreur 401 — pour utiliser le serveur sans clé, omettez-la complètement.
Available tools#
| Champ | Type | Description |
|---|---|---|
search_esims | tool | Rechercher des eSIM — country (code ISO ou nom dans n’importe quelle langue) ou countries (tous à la fois), days, data_gb / max_data_gb, unlimited, data_type (daily|total), local_number, network (local|roaming), multi_country, min_price_krw / max_price_krw, provider, hotspot / five_g, sort, limit (≤10), lang |
get_esim | tool | Détails de l’eSIM — id, lang |
list_countries | tool | Pays en vente — query, lang |
search / fetch | tool | Outils compatibles ChatGPT — search {query} (texte libre ; comprend illimité, quotidien, numéro local, réseau local, partage de connexion et 5G), fetch {id} |
Rate limits#
Remarque
L’API publique et le MCP authentifié partagent un quota horaire par partenaire (20 000 par défaut). Ajouter des clés ou les renouveler ne l’augmente pas.
La fenêtre de 3,600 secondes démarre à la première requête ; la limite par minute s’applique aussi. Les quotas comptent les appels, pas les MB transférés. Les paramètres d’exploitation peuvent modifier le quota.
Les lots MCP acceptent jusqu’à 100 messages et chaque message compte comme un appel. Un lot qui dépasse le quota disponible renvoie 429 avant exécution.
X-RateLimit-Hour-Limit · X-RateLimit-Hour-Remaining · X-RateLimit-Hour-Reset
Ces en-têtes indiquent la limite horaire, les appels restants et l’heure de réinitialisation (secondes Unix). Une fois la limite horaire atteinte, HTTP 429 est renvoyé avec Retry-After en secondes. Les appels rejetés par la limite par minute ne comptent pas dans le quota horaire.
Sans clé, la limite est de 120 requêtes par minute et par IP ; avec une clé partenaire, de 600 par minute et par clé. Au-delà, vous recevez une erreur JSON-RPC (-32002) avec HTTP 429.