eSIMfly MCP

offiziell

Durchsuchen Sie Großhandels-eSIM-Datentarife für über 200 Länder, prüfen Sie Guthaben und Nutzung, diagnostizieren Sie eSIM-Konnektivität anhand von Live-Netzwerkdaten, und (optional, mit einem Bestätigungsschritt) bestellen und laden Sie eSIMs auf – der offizielle MCP-Server für die eSIMfly Business API. Standardmäßig schreibgeschützt. Installation: npx -y @esimfly/mcp — Quelle: github.com/eSimfly-Official/esimfly-mcp

Was kann man mit eSIMfly MCP machen?

  • Wholesale-eSIM-Katalog durchsuchen — Fragen Sie nach verfügbaren Datenpaketen und Großhandelspreisen für 200 Länder sowie nach Ihrem Kontostand.
  • eSIMs bestellen und bereitstellen — Fordern Sie neue eSIM-Bestellungen mit QR-Codes und Aktivierungsdetails an oder laden Sie bestehende Tarife auf.
  • eSIM-Lebenszyklus verwalten — Prüfen Sie Status und Datennutzung, setzen Sie Leitungen aus, kündigen Sie sie oder aktivieren Sie sie, und überprüfen Sie Netzwerkereignisse oder senden Sie SMS.
  • Über Webhooks überwachen — Richten Sie Endpunkte ein, um Echtzeitbenachrichtigungen für Bestell- und Lebenszyklusereignisse ohne Polling zu erhalten.

Dokumentation

eSIM-API für Entwickler: Verkaufen Sie eSIMs in Ihrem eigenen Produkt

Integrieren Sie eSIM-Datentarife im Großhandel für 200 Länder über eine einzige REST-API in Ihre App, Plattform oder Ihren Shop – Katalog, Bestellung, Aufladungen, Nutzung und vollständiges Lifecycle-Management.

Wer auf der eSIM-API aufbaut

Unternehmen nutzen die Großhandels-eSIM-Integration, um mit ihrem bestehenden Produkt Umsätze aus Konnektivität zu erzielen.

Reise-Apps & OTAs

Bieten Sie zum Buchungszeitpunkt einen eSIM-Upsell an. Ihre Reisenden landen vernetzt, und Sie behalten die Marge bei jedem verkauften Tarif.

Reseller & MVNOs

Beziehen Sie eSIMs zu Großhandelspreisen und verkaufen Sie sie über Ihre eigenen Kanäle – mit Ihrer eigenen Preisgestaltung und Verpackung.

IoT- & Flottenplattformen

Stellen Sie Konnektivität für Geräte und Fahrzeuge über Grenzen hinweg bereit und überwachen Sie sie aus einer einzigen Integration.

Superapps & Fintech

Fügen Sie internationale Datentarife als native Funktion neben Zahlungs-, Banking- oder Loyalty-Produkten hinzu.

API-FUNKTIONEN

Alles, was Sie für den programmatischen Betrieb von eSIMs benötigen

Die API deckt die gesamte Reise vom Durchsuchen der Großhandelspakete bis zur Verwaltung aktiver eSIMs im Feld ab.

Katalog & Preise

Durchsuchen Sie jedes verfügbare Datenpaket mit Großhandelspreisen für 200 Länder und prüfen Sie Ihr Kontoguthaben vor der Bestellung.

Alle Pakete abrufenGuthaben abfragen

Bestellungen & Aufladungen

Stellen Sie neue eSIMs sofort bereit und laden Sie bestehende auf. Bestellungen liefern QR-Codes und Aktivierungsdetails, die bereit zur Auslieferung an Ihre Nutzer sind.

Bestellung erstellenAufladepakete & Bestellungen

eSIM-Lifecycle

Verwalten Sie jede von Ihnen ausgegebene eSIM: Status und Datennutzung prüfen, Leitungen sperren oder kündigen, Netzwerkereignisse einsehen und SMS versenden.

eSIMs auflisten / abfrageneSIM-StatusKündigen / Sperren / AktivierenNutzungsberichtNetzwerkereignisseSMS senden

Webhooks

Registrieren Sie Endpunkte, um Echtzeitbenachrichtigungen für Bestell- und eSIM-Lifecycle-Ereignisse zu erhalten – kein Polling erforderlich.

Webhook-VerwaltungEreignisbenachrichtigungen

eSIM-Großhandelstarife, Ihre Marge

API-Partner kaufen Datenpakete zu Großhandelspreisen und legen ihre eigenen Endkundenpreise fest. Der Katalog umfasst lokale, regionale und globale Tarife in 200 Ländern und über 450 Netzen, sodass eine einzige Integration jedes Reiseziel Ihrer Nutzer abdeckt. Die guthabenbasierte Abrechnung hält die Abwicklung einfach: Zahlen Sie Ihr Konto auf, und jede Bestellung wird zu Ihrem Großhandelstarif davon abgebucht.

Wenn Sie statt eines Eigenbaus einen kompletten Storefront wünschen, liefert unsere White-Label-eSIM-Reseller-Plattform eine gebrandete Website, ein Dashboard und mobile Apps auf derselben Infrastruktur.

Sicherheit von Grund auf: HMAC-signierte Anfragen

Jeder API-Aufruf wird mit einer HMAC-SHA256-Signatur über den Anfrage-Zeitstempel, eine eindeutige Anfrage-ID, Ihren Zugangscode und den Anfrage-Body authentifiziert – das bietet Integritätsprüfung und Schutz vor Replay-Angriffen. Fertige Signierungsbeispiele für Node.js, Python und PHP finden Sie in der Dokumentation.

POST /api/v1/business/orders HTTP/1.1
Host: esimfly.net
Content-Type: application/json
RT-AccessCode: your-access-code
RT-RequestID: 6f1c2e4a-...        # unique UUID v4
RT-Timestamp: 1752403200000       # ms since epoch
RT-Signature: A3F0...             # HMAC-SHA256, see docs

{ "package_code": "...", "quantity": 1 }

API-Zugang in drei Schritten

1. Geschäftskonto erstellen

Registrieren Sie sich für ein eSIMfly-Geschäftskonto und erzählen Sie uns von Ihrem Anwendungsfall und erwarteten Volumen.

2. API-Schlüssel generieren

Erstellen und verwalten Sie Zugangsdaten im Geschäfts-Dashboard und zahlen Sie anschließend Ihr Guthaben auf.

3. Integrieren und starten

Folgen Sie der Dokumentation, um Pakete zu durchsuchen, eine Testbestellung aufzugeben und optional einen Webhook für asynchron bereitgestellte eSIMs zu registrieren.

FAQ

Fragen zur eSIM-API, beantwortet

Was ist die eSIMfly eSIM-API?+

Die eSIMfly-API ist eine REST-API, mit der Sie eSIMs programmatisch zu Großhandelspreisen kaufen, bereitstellen und verwalten können. Sie können den Paketkatalog durchsuchen, Bestellungen erstellen, Tarife aufladen, die Nutzung überwachen und den vollständigen eSIM-Lifecycle (aktivieren, sperren, kündigen) aus Ihrer eigenen Anwendung heraus verwalten – mit Abdeckung in 200 Ländern über mehr als 450 Netze.

Für wen ist die eSIM-API gedacht?+

Die API richtet sich an Unternehmen, die eSIM-Konnektivität in ihr eigenes Produkt einbetten möchten: Reise-Apps und Buchungsplattformen, Telekom-Reseller und MVNOs, IoT- und Flottenplattformen sowie jeden Dienst, der seinen Nutzern internationale Daten anbieten möchte, ohne selbst Carrier-Beziehungen aufzubauen.

Wie funktioniert die API-Authentifizierung?+

Anfragen werden mit HMAC-SHA256-Signaturen authentifiziert. Jede Anfrage enthält einen Zugangscode, eine eindeutige Anfrage-ID, einen Zeitstempel und eine mit Ihrem geheimen Schlüssel berechnete Signatur, was die Integrität der Anfrage verifiziert und Replay-Angriffe verhindert. Codebeispiele für Node.js, Python und PHP sind in der Dokumentation verfügbar.

Wie erhalte ich Zugang zur eSIM-API?+

Erstellen Sie ein eSIMfly-Geschäftskonto und generieren Sie anschließend API-Schlüssel im Geschäfts-Dashboard. Die Großhandelspreisstufen hängen vom Volumen ab – kontaktieren Sie unser Vertriebsteam, um die Tarife für Ihr erwartetes Bestellvolumen zu besprechen.

Unterstützt die API Webhooks?+

Ja. Webhooks benachrichtigen Sie, wenn asynchron bereitgestellte eSIMs bereit sind – einige Carrier (wie KDDI Japan) benötigen einige Minuten, und statt Polling erhalten Sie einen signierten POST mit den eSIM-Details. Die meisten Anbieter stellen synchron in der Bestellantwort bereit, und Status und Nutzung werden über die Status- und Nutzungs-Endpunkte abgefragt.

Wie hoch sind die API-Rate-Limits?+

Die API erlaubt 1.000 Anfragen pro Stunde pro Konto. Anfragen, die älter als 5 Minuten sind, werden im Rahmen des Schutzes vor Replay-Angriffen abgelehnt. Wenn Sie für Ihre Integration höhere Limits benötigen, kontaktieren Sie den Vertrieb.

OFFIZIELLES SDK · NODE.JS / TYPESCRIPT

Überspringen Sie den Signierungscode – installieren Sie das SDK

npm install @esimfly/sdk bietet Ihnen typisierten Zugriff auf die gesamte API – HMAC-Signierung, frische Anfrage-IDs, idempotente Bestellungen, getaktete Katalogsynchronisierung und Webhook-Signaturprüfung sind integriert. Keine Abhängigkeiten, Node.js 18+, MIT-lizenziert und Open Source. PHP- und Python-SDKs folgen als Nächstes.

Sie nutzen einen KI-Agenten? Fügen Sie den gehosteten MCP-Server https://mcp.esimfly.net/mcp zu Claude, ChatGPT oder Cursor hinzu und melden Sie sich mit Ihrem Geschäftskonto an – keine Schlüssel zum Einfügen. Durchsuchen Sie Tarife, prüfen Sie die Nutzung und diagnostizieren Sie eSIMs gegen die Live-API; standardmäßig schreibgeschützt, mit einem Bestätigungsschritt vor jeder Bestellung. Lieber lokal? npx -y @esimfly/mcp.

Integrations-Tutorials

Funktionierender Node.js-Code, von der ersten Anfrage bis zu Produktions-Webhooks.

[

HIER STARTEN · ARCHITEKTURLEITFADEN

eSIM-API-Integrationsleitfaden

Die vier Bausteine, signierte Authentifizierung, synchrone vs. Webhook-Bereitstellung, eine Checkliste zur Anbieterbewertung und die Fallstricke, die erst in der Produktion auftauchen.

Leitfaden lesen](https://esimfly.net/esim-api/integration-guide)

[

TEIL 1 · ~30 MIN

Verkaufen Sie eSIMs in Ihrer App mit Node.js

HMAC-Authentifizierung, Paketkatalog, Bestellerstellung und QR-Code-Auslieferung – ein kompletter funktionierender Storefront.

Tutorial starten](https://esimfly.net/esim-api/tutorials/sell-esims-nodejs)[

TEIL 2 · LIFECYCLE

Aufladungen, Nutzungsverfolgung & Webhooks

Live-Nutzungsabfragen, Aufladeverkäufe für bestehende eSIMs und signierte Webhooks ohne Polling.

Weiter zu Teil zwei](https://esimfly.net/esim-api/tutorials/topups-usage-webhooks)

Bereit, eSIMs in Ihr Produkt zu integrieren?

Beginnen Sie mit der Dokumentation oder sprechen Sie mit unserem Team über Großhandelstarife für Ihr Volumen.