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 |
compare_esims | tool | Vergleicht 2–5 Tarife nebeneinander — ids (aus search_esims), lang. Zeigt, welcher den niedrigsten Preis, die meisten Daten, die längste Gültigkeit und den niedrigsten Preis pro GB hat |
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} |
In Apps mit MCP-Apps-Unterstützung (z. B. Claude, ChatGPT und VS Code) erscheinen die Ergebnisse von search_esims, get_esim und compare_esims als Tarifkarten. Tarif ansehen öffnet die Tarifseite auf esimoa.com – über die Karten wird nie bezahlt.
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 Partnerschlüssel bei 600 pro Minute und Schlüssel. Aufrufe, die Claude und ChatGPT von ihren eigenen Servern senden, werden pro Plattform statt pro IP gezählt. Darüber hinaus erhalten Sie einen JSON-RPC-Fehler (-32002) mit HTTP 429.
