Docs
EntwicklerbereichDashboardesimoa.com
    • Einführung
    • Schnellstart
    • Authentifizierung
    • Overview
    • eSIMs auflisten
    • eSIM holen
    • Länder
    • OpenAPI
    • Tracking & Provision
    • Ratenlimits & Fehler
    • Overview
    • MCP-Einträge
    • Claude
    • ChatGPT
    • Gemini
    • Andere MCP-Clients
    • Overview
    • Authentifizierung
    • Produkte
    • Produktdetails
    • Länder
    • Errors & rate limits
  1. Docs
  2. KI-Integrationen (MCP)
  3. Overview

Overview

KI-Integrationen (MCP)

Connect the official esimoa MCP server so AI assistants can search and compare eSIMs and share purchase links.

On this page
  • Server URL
  • Adding your partner key
  • Available tools
  • Rate limits
  • Connect a client

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).

url
https://api.esimoa.com/mcp

Trinkgeld

Neu bei MCP? Fang mit Claude an – eine URL einfügen, ohne Anmeldung, und in etwa einer Minute bist du verbunden. So verbindest du Claude

Adding your partner key#

Trinkgeld

Partner: Gib deinen Schlüssel mit, damit die von der KI geteilten Links deinen Partnercode enthalten und Provision bringen. In Connector-Ansichten von Claude oder ChatGPT, in denen keine Header gesetzt werden können, hänge ?key= an die URL an:
url
https://api.esimoa.com/mcp?key=esk_live_your_key_here

Clients, 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#

FeldTypBeschreibung
search_esimstooleSIMs 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_esimtooleSIM-Details — id, lang
compare_esimstoolVergleicht 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_countriestoolLänder im Verkauf — query, lang
search / fetchtoolChatGPT-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.

Connect a client#

MCP-Einträge

Claudeclaude.ai-Connector · Claude CodeChatGPTConnector im EntwicklermodusGeminiGemini CLI · ~/.gemini/settings.jsonAndere MCP-ClientsJSON-RPC 2.0 · POST

Zuletzt aktualisiert: 2. Oktober 2026

PreviousRatenlimits & FehlerWeiterMCP-Einträge

On this page

  • Server URL
  • Adding your partner key
  • Available tools
  • Rate limits
  • Connect a client

APIs and MCP for bringing esimoa eSIMs to your product

Resources

  • Docs
  • API reference
  • Partner-API (B2B)
  • MCP server
  • OpenAPI spec

esimoa

  • Startseite
  • eSIM Tarife
  • Entwicklerbereich
  • Dashboard
  • Partnerportal

Company

  • Über uns
  • Partnerschaft
  • Nutzungsbedingungen
  • Datenschutzerklärung
  • Liefer- und Erstattungsbedingungen

Hilfe

  • support@esimoa.com
  • Support-Chat

NBase Korea Co., Ltd.

902, Bldg A, 767 Sinsu-ro, Suji-gu, Yongin-si, Gyeonggi-do (Dongcheon-dong, Bundang Suji U-TOWER)

US-Hauptsitz: NBASE CORP. · Corporate Park, Irvine, CA 92606, USA

© 2026 esimoa. Alle Rechte vorbehalten.