eSIMfly MCP

resmi

Search wholesale eSIM data plans for 200+ countries, check balance and usage, diagnose eSIM connectivity from live network data, and (opt-in, with a confirmation step) order and top up eSIMs — the official MCP server for the eSIMfly Business API. Read-only by default. Install: npx -y @esimfly/mcp — source: github.com/eSimfly-Official/esimfly-mcp

Lihat di esimfly.netCoba MCP iniDisponsori

Apa yang bisa Anda lakukan dengan eSIMfly MCP?

Search eSIM packages — Ask your assistant to browse the wholesale catalog and compare data plans across 200 countries using get_all_packages.
Check account balance — Have your assistant query your current balance before placing orders via the balance_query endpoint.
Create eSIM orders — Instruct your assistant to provision new eSIMs and return QR codes/activation details through create_order.
Top up existing eSIMs — Ask your assistant to add data to active plans using the topup_packages_and_orders operation.
Manage eSIM lifecycle — Direct your assistant to check status, monitor usage, suspend, or cancel lines via esim_status and related endpoints.
Configure webhooks — Have your assistant register endpoints for real-time order and lifecycle event notifications through webhook_management.

Dokumentasi

eSIM API for Developers: Sell eSIMs in Your Own Product

Integrate wholesale eSIM data plans for 200 countries into your app, platform, or store through one REST API — catalog, ordering, top-ups, usage, and full lifecycle management.

Who Builds on the eSIM API

Companies use wholesale eSIM integration to add connectivity revenue to their existing product.

Travel Apps & OTAs

Offer an eSIM upsell at booking time. Your travelers land connected, and you keep the margin on every plan sold.

Resellers & MVNOs

Source eSIMs at wholesale rates and sell through your own channels, with your own pricing and packaging.

IoT & Fleet Platforms

Provision and monitor connectivity for devices and vehicles across borders from a single integration.

Superapps & Fintech

Add international data plans as a native feature next to payments, banking, or loyalty products.

API CAPABILITIES

Everything You Need to Run eSIMs Programmatically

The API covers the full journey from browsing wholesale packages to managing live eSIMs in the field.

Catalog & Pricing

Browse every available data package with wholesale pricing for 200 countries, and check your account balance before ordering.

Get All PackagesBalance Query

Orders & Top-ups

Provision new eSIMs instantly and top up existing ones. Orders return QR codes and activation details ready to deliver to your users.

Create OrderTopup Packages & Orders

eSIM Lifecycle

Manage every eSIM you have issued: check status and data usage, suspend or cancel lines, review network events, and send SMS.

List / Query eSIMseSIM StatusCancel / Suspend / ActivateUsage ReportNetwork EventsSend SMS

Webhooks

Webhook ManagementEvent Notifications

Wholesale eSIM Rates, Your Margin

API partners buy data packages at wholesale pricing and set their own retail prices. The catalog spans local, regional, and global plans across 200 countries and 450+ networks, so a single integration covers every destination your users travel to. Balance-based billing keeps settlement simple: fund your account, and each order draws from it at your wholesale rate.

If you want a complete storefront instead of building your own, our white-label eSIM platform ships a branded website, dashboard, and mobile apps on top of the same infrastructure.

Secure by Design: HMAC-Signed Requests

Every API call is authenticated with an HMAC-SHA256 signature over the request timestamp, a unique request ID, your access code, and the request body — providing integrity verification and replay-attack protection. Ready-made signing examples for Node.js, Python, and PHP are in the documentation.

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 }

Get API Access in Three Steps

1. Create a business account

2. Generate your API keys

Create and manage access credentials from the business dashboard, then fund your balance.

3. Integrate and launch

Follow the documentation to browse packages, place a test order, and optionally register a webhook for asynchronously provisioned eSIMs.

FAQ

eSIM API Questions, Answered

What is the eSIMfly eSIM API?+

The eSIMfly API is a REST API that lets you buy, provision, and manage eSIMs programmatically at wholesale rates. You can browse the package catalog, create orders, top up plans, monitor usage, and manage the full eSIM lifecycle (activate, suspend, cancel) from your own application, with coverage in 200 countries across 450+ networks.

Who is the eSIM API for?+

The API is built for companies that want to embed eSIM connectivity into their own product: travel apps and booking platforms, telecom resellers and MVNOs, IoT and fleet platforms, and any service that wants to offer international data to its users without building carrier relationships.

How does API authentication work?+

Requests are authenticated with HMAC-SHA256 signatures. Each request carries an access code, a unique request ID, a timestamp, and a signature computed with your secret key, which provides request integrity verification and prevents replay attacks. Code examples for Node.js, Python, and PHP are available in the documentation.

How do I get eSIM API access?+

Create an eSIMfly business account, then generate API keys from the business dashboard. Wholesale pricing tiers depend on volume — contact our sales team to discuss rates for your expected order volume.

Does the API support webhooks?+

Yes. Webhooks notify you when asynchronously provisioned eSIMs are ready - some carriers (like KDDI Japan) take a few minutes, and instead of polling you receive a signed POST with the eSIM details. Most providers provision synchronously in the order response, and status and usage are queried via the status and usage endpoints.

What are the API rate limits?+

The API allows 1,000 requests per hour per account. Requests older than 5 minutes are rejected as part of replay-attack protection. If you need higher limits for your integration, contact sales.

OFFICIAL SDK · NODE.JS / TYPESCRIPT

Skip the signing code — install the SDK

npm install @esimfly/sdk gives you typed access to the whole API — HMAC signing, fresh request IDs, idempotent orders, paced catalog sync and webhook signature verification are built in. Zero dependencies, Node.js 18+, MIT-licensed and open source. PHP and Python SDKs are next.

Using an AI agent? The official MCP server (npx -y @esimfly/mcp) lets Claude, Cursor or ChatGPT search plans, check usage and diagnose eSIMs against the live API — read-only by default, with a confirmation step before any order.

Integration Tutorials

Working Node.js code, from first request to production webhooks.

[

START HERE · ARCHITECTURE GUIDE

eSIM API Integration Guide

The four building blocks, signed authentication, sync vs webhook provisioning, a provider evaluation checklist, and the pitfalls that only show up in production.

Read the guide](https://esimfly.net/esim-api/integration-guide)

[

PART 1 · ~30 MIN

Sell eSIMs in Your App with Node.js

HMAC auth, package catalog, order creation and QR code delivery — a complete working storefront.

Start the tutorial](https://esimfly.net/esim-api/tutorials/sell-esims-nodejs)[

PART 2 · LIFECYCLE

Top-Ups, Usage Tracking & Webhooks

Live usage queries, top-up sales on existing eSIMs, and signed webhooks without polling.

Continue to part two](https://esimfly.net/esim-api/tutorials/topups-usage-webhooks)

Ready to integrate eSIMs into your product?

Start with the documentation, or talk to our team about wholesale rates for your volume.