Esimfly-mcp Server

Give your AI assistant hands on the eSIMfly Business API. With this Model Context Protocol server, Claude, Cursor, ChatGPT and other MCP clients can search eSIM plans with your wholesale prices…

Local + remotestreamable-httpstdioMIT

What is the Esimfly-mcp Server?

eSIMfly MCP is an MCP project maintained in the esimfly-official/esimfly-mcp repository. The maintainer describes its purpose as “Give your AI assistant hands on the eSIMfly Business API. With this Model Context Protocol server, Claude, Cursor, ChatGPT and other MCP clients can search…”. Read the project documentation for the complete scope.

Installation

The documented npm package is @esimfly/mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares ESIMFLY_ACCESS_CODE, ESIMFLY_SECRET_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
search_packagesCatalogue search by destination / type with your cost price
get_balanceAccount (or enterprise) balance
list_esimsYour eSIMs with status, data left, validity
get_esim_usageStored usage for one eSIM (cheap)
get_esim_live_statusLive status from the network: install state, last network, device, usage
get_network_eventsLast 7 days of attach / data-session events, wrong-network flag
get_usage_reportDaily usage by country and operator (up to 90 days)
get_topup_packagesTop-up options for one eSIM
get_webhook_settingsWebhook URL, events, recent deliveries
create_orderBuy eSIMs — preview → confirm: true + idempotency key
topup_esimAdd data to an eSIM — preview shows package and cost
cancel_esimCancel an unused eSIM and refund to balance
send_smsText the device holding the eSIM
set_webhookConfigure webhook URL and events

How to install the Esimfly-mcp Server

{
  "mcpServers": {
    "esimfly": {
      "command": "npx",
      "args": [
        "-y",
        "@esimfly/mcp"
      ],
      "env": {
        "ESIMFLY_ACCESS_CODE": "esf_...",
        "ESIMFLY_SECRET_KEY": "YOUR_ESIMFLY_SECRET_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
ESIMFLY_ACCESS_CODEDeclared in the maintainer’s client configuration.Check documentation
ESIMFLY_SECRET_KEYDeclared in the maintainer’s client configuration.Check documentation