Overview
KI-Integrationen (MCP)
Connect the official esimoa MCP server so AI assistants can search and compare eSIMs and share purchase links.
Server URL#
Der offizielle esimoa-MCP-Server https://api.esimoa.com/mcp ermöglicht KI-Assistenten, eSIMs zu suchen, zu vergleichen und Kauflinks zu teilen. Er nutzt Streamable HTTP (zustandsloses JSON) und funktioniert ohne Schlüssel (120 Anfragen/Min. pro IP).
https://api.esimoa.com/mcpTrinkgeld
Adding your partner key#
Trinkgeld
https://api.esimoa.com/mcp?key=esk_live_your_key_hereClients, die Header unterstützen, können stattdessen X-API-Key oder Authorization: Bearer senden. Ein falscher Schlüssel wird mit 401 abgelehnt — um den Server ohne Schlüssel zu nutzen, lass ihn komplett weg.
Available tools#
| Feld | Typ | Beschreibung |
|---|---|---|
search_esims | tool | eSIMs suchen — country (ISO-Code oder Name in beliebiger Sprache) oder countries (alle gleichzeitig), 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 | eSIM-Details — id, lang |
list_countries | tool | Länder im Verkauf — query, lang |
search / fetch | tool | ChatGPT-kompatible Tools — search {query} (Freitext; versteht unbegrenzt, täglich, lokale Telefonnummer, lokales Netz, Hotspot und 5G), fetch {id} |
Rate limits#
Hinweis
Öffentliche API und authentifiziertes MCP teilen sich ein stündliches Kontingent pro Partner (standardmäßig 20.000). Zusätzliche oder rotierte Schlüssel erhöhen es nicht.
Das 3,600-Sekunden-Fenster beginnt mit der ersten Anfrage; das Minutenlimit gilt zusätzlich. Kontingente zählen Aufrufe, nicht übertragene MB. Betriebliche Einstellungen können das Kontingent ändern.
MCP-Batches akzeptieren bis zu 100 Nachrichten, jede Nachricht zählt als ein Aufruf. Ein Batch, der das verfügbare Kontingent überschreitet, liefert vor der Ausführung 429.
X-RateLimit-Hour-Limit · X-RateLimit-Hour-Remaining · X-RateLimit-Hour-Reset
Diese Header melden das Stundenlimit, die verbleibenden Aufrufe und die Rücksetzzeit (Unix-Sekunden). Ist das Stundenlimit erschöpft, wird HTTP 429 mit Retry-After in Sekunden zurückgegeben. Vom Minutenlimit abgelehnte Aufrufe zählen nicht zum Stundenkontingent.
Ohne Schlüssel liegt das Limit bei 120 Anfragen pro Minute und IP, mit Partner-Schlüssel bei 600 pro Minute und Schlüssel. Darüber hinaus erhältst du einen JSON-RPC-Fehler (-32002) mit HTTP 429.