esimfly

Official MCP server for the eSIMfly Business API.

CommunityOnlineNo sign-inGlobalFreeRead-only

What it can do

Search Packages: Find eSIM data packages you can sell, with your wholesale price. Filter by destination name (search), type (local / regional / global) and page. Returns compact rows; use limit up to
Get Balance: Current prepaid balance (or enterprise balance) and currency.
List Esims: eSIMs on the account with status, data left and validity. Search by ICCID, package name or code; filter by status.

What data it sees

Do you need an account

No: the server works without sign-in

Official MCP server for the eSIMfly Business API. Lets Claude, ChatGPT, Cursor and other AI agents search eSIM plans, order eSIMs, check usage and manage webhooks. Hosted (OAuth) at mcp.esimfly.net/mcp or local via npx @esimfly/mcp.

Website field:

https://esimfly.net/esim-api

Topics to add in the same panel:

mcp, mcp-server, model-context-protocol, esim, esim-api, ai-agents, claude, chatgpt, travel, telecom, typescript

Server tool list (18)

Raw names from tools/list. Only developers need these.

search_packages	Find eSIM data packages you can sell, with your wholesale price. Filter by destination name (search), type (local / regional / global) and page. Returns compact rows; use limit up to 100.
get_balance	Current prepaid balance (or enterprise balance) and currency.
list_esims	eSIMs on the account with status, data left and validity. Search by ICCID, package name or code; filter by status.
get_esim_usage	Stored data usage and validity for one eSIM (cheap; fresh as of the last sync). Identify by ICCID or order reference.
get_esim_live_status	LIVE status straight from the mobile network: lifecycle status, profile install state, last network (operator, country, MCC/MNC, 4G/5G), device model and IMEI, activation and last-usage dates, data used. Expensive — use for diagnosis ("no data", "is it installed?"), not routinely.
get_network_events	Attach and data-session events for one eSIM, newest first, each flagged is_allowed. wrong_network_count > 0 means the device latched onto a network outside the plan — the usual cause of "connected but no data" (fix: airplane-mode toggle or manual network selection).
get_usage_report	Daily data usage for one eSIM over the last N days (default 7, max 90) with per-country and per-operator breakdown.
list_orders	Order history with filters (status, date range ISO 8601, search by reference / package) and a revenue summary.
get_order	One order by reference, including its eSIM (ICCID, install links, pending state).
get_topup_packages	Top-up options for ONE eSIM (they depend on its provider and location), with your price. Returns ESIM_NOT_TOPPABLE when the eSIM state does not allow top-ups.
get_webhook_settings	Configured webhook URL, subscribed events, available events and the last deliveries.
create_order	Buy one or more eSIMs of a package from the account balance. Two-step: first call returns a preview with the current balance and a generated idempotency_key; call again with confirm: true AND that idempotency_key to execute. Tell the user the cost before confirming.
topup_esim	Add a package to an existing eSIM. Two-step: without confirm returns the package name, cost and current balance; with confirm: true executes.
cancel_esim	Cancel an eSIM that has never been installed / activated and refund it to the balance. Cancels EVERY eligible eSIM in the same order. Two-step: confirm: true to execute.
suspend_esim	Block network access for an eSIMfly-network eSIM (reversible with activate_esim). Two-step: confirm: true to execute.
activate_esim	Restore network access after suspend_esim. Two-step: confirm: true to execute.
send_sms	Send a text (max 500 characters) to the device holding the eSIM. Two-step: confirm: true to send.
set_webhook	Configure (or rotate) the webhook URL and subscribed events. The response contains the signing secret — shown once. Two-step: confirm: true to apply.