Overview
Integrazioni IA (MCP)
Connect the official esimoa MCP server so AI assistants can search and compare eSIMs and share purchase links.
Server URL#
Il server MCP ufficiale di esimoa https://api.esimoa.com/mcp consente agli assistenti IA di cercare e confrontare eSIM e di condividere link d’acquisto. Usa Streamable HTTP (JSON stateless) e funziona senza chiave (120 richieste/min per IP).
https://api.esimoa.com/mcpMancia
Adding your partner key#
Mancia
https://api.esimoa.com/mcp?key=esk_live_your_key_hereI client che supportano gli header possono inviare invece X-API-Key o Authorization: Bearer. Una chiave errata viene rifiutata con 401: per usare il server senza chiave, omettila del tutto.
Available tools#
| Campo | Tipo | Descrizione |
|---|---|---|
search_esims | tool | Cerca eSIM — country (codice ISO o nome in qualsiasi lingua) o countries (tutti insieme), 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 | Dettagli eSIM — id, lang |
list_countries | tool | Paesi in vendita — query, lang |
search / fetch | tool | Strumenti compatibili con ChatGPT — search {query} (testo libero; comprende illimitato, giornaliero, numero locale, rete locale, hotspot e 5G), fetch {id} |
Rate limits#
Nota
L’API pubblica e l’MCP autenticato condividono una quota oraria per partner (20.000 predefinite). Aggiungere o ruotare le chiavi non la aumenta.
La finestra di 3,600 secondi parte dalla prima richiesta; si applica anche il limite al minuto. Le quote contano le chiamate, non i MB trasferiti. Le impostazioni operative possono modificare la quota.
I batch MCP accettano fino a 100 messaggi e ogni messaggio conta come una chiamata. Un batch che supera la quota disponibile restituisce 429 prima dell’esecuzione.
X-RateLimit-Hour-Limit · X-RateLimit-Hour-Remaining · X-RateLimit-Hour-Reset
Questi header indicano il limite orario, le chiamate rimanenti e l’ora di reset (secondi Unix). Esaurito il limite orario, viene restituito HTTP 429 con Retry-After in secondi. Le chiamate rifiutate dal limite al minuto non vengono conteggiate nella quota oraria.
Senza chiave il limite è di 120 richieste al minuto per IP; con una chiave partner è di 600 al minuto per chiave. Oltre questo limite ricevi un errore JSON-RPC (-32002) con HTTP 429.