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

How to connect

How to connect esimfly to Claude

The server address to paste into Claude settings:

https://esimfly--akam19901205.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect esimfly to ChatGPT

The server address to paste into ChatGPT settings:

https://esimfly--akam19901205.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect esimfly to Cursor

The server address to paste into Cursor settings:

https://esimfly--akam19901205.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (18)

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

search_packagesFind 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_balanceCurrent prepaid balance (or enterprise balance) and currency.
list_esimseSIMs on the account with status, data left and validity. Search by ICCID, package name or code; filter by status.
get_esim_usageStored data usage and validity for one eSIM (cheap; fresh as of the last sync). Identify by ICCID or order reference.
get_esim_live_statusLIVE 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_eventsAttach 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_reportDaily data usage for one eSIM over the last N days (default 7, max 90) with per-country and per-operator breakdown.
list_ordersOrder history with filters (status, date range ISO 8601, search by reference / package) and a revenue summary.
get_orderOne order by reference, including its eSIM (ICCID, install links, pending state).
get_topup_packagesTop-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_settingsConfigured webhook URL, subscribed events, available events and the last deliveries.
create_orderBuy 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_esimAdd a package to an existing eSIM. Two-step: without confirm returns the package name, cost and current balance; with confirm: true executes.
cancel_esimCancel 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_esimBlock network access for an eSIMfly-network eSIM (reversible with activate_esim). Two-step: confirm: true to execute.
activate_esimRestore network access after suspend_esim. Two-step: confirm: true to execute.
send_smsSend a text (max 500 characters) to the device holding the eSIM. Two-step: confirm: true to send.
set_webhookConfigure (or rotate) the webhook URL and subscribed events. The response contains the signing secret — shown once. Two-step: confirm: true to apply.