Esimfly MCP

Name: Esimfly MCP
Author: eSimfly-Official

by eSimfly-Officialversion 0.1.3i★ –iComputer or cloud

Registry nameio.github.eSimfly-Official/esimfly-mcp

Install

Overview

Description from the maker (original English)

eSIMfly Business API: search eSIM plans, check usage, diagnose eSIMs, optionally order (confirmed)

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi3 of 3 passedChecked from public information; code not scanned yet
UsageiVery new↓ 48/wk · ★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Computer or cloud
Transport: stdio, Streamable HTTP
Category: Travel, maps & weather
You need to fill in: ESIMFLY_ACCESS_CODE, ESIMFLY_SECRET_KEY

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 3 of 3 passed
Runs on the maker’s server: what you ask it goes through their server.
You fill in yourself: ESIMFLY_ACCESS_CODE, ESIMFLY_SECRET_KEY, ESIMFLY_MCP_ALLOW_WRITES

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

Runs in the cloudNothing to install; it connects over the internet
npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Works in Claude on the web, desktop and mobile:

Open Settings → Connectors
Press Add custom connector
Paste the address below and press Add
If it asks you to sign in, sign in with the maker

https://mcp.esimfly.net/mcp

Or run it on your computer

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "esimfly": {
      "command": "npx",
      "args": [
        "-y",
        "@esimfly/mcp"
      ],
      "env": {
        "ESIMFLY_ACCESS_CODE": "your-value",
        "ESIMFLY_SECRET_KEY": "your-value",
        "ESIMFLY_MCP_ALLOW_WRITES": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add --transport http esimfly https://mcp.esimfly.net/mcp

Or run it on your computer

claude mcp add esimfly --env ESIMFLY_ACCESS_CODE=your-value --env ESIMFLY_SECRET_KEY=your-value --env ESIMFLY_MCP_ALLOW_WRITES=your-value -- npx -y @esimfly/mcp

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "esimfly": {
      "url": "https://mcp.esimfly.net/mcp"
    }
  }
}

Or run it on your computer

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "esimfly": {
      "command": "npx",
      "args": [
        "-y",
        "@esimfly/mcp"
      ],
      "env": {
        "ESIMFLY_ACCESS_CODE": "your-value",
        "ESIMFLY_SECRET_KEY": "your-value",
        "ESIMFLY_MCP_ALLOW_WRITES": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "esimfly": {
      "type": "http",
      "url": "https://mcp.esimfly.net/mcp"
    }
  }
}

Or run it on your computer

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "esimfly": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@esimfly/mcp"
      ],
      "env": {
        "ESIMFLY_ACCESS_CODE": "your-value",
        "ESIMFLY_SECRET_KEY": "your-value",
        "ESIMFLY_MCP_ALLOW_WRITES": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

ChatGPT connects only to servers on the internet:

Open ChatGPT on the web → Settings → Connectors (Apps)
Press Create or Add (some plans need Developer mode under Advanced first)
Paste the address below, give it a name and save
If it asks you to sign in, sign in with the maker

https://mcp.esimfly.net/mcp

Menu names can differ slightly by plan and over time.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

ESIMFLY_ACCESS_CODE secret required env
eSIMfly API access code (esf_...)
ESIMFLY_SECRET_KEY secret required env
eSIMfly API secret key (sk_...)
ESIMFLY_MCP_ALLOW_WRITES env
Set to true to enable ordering, top-up, cancel, suspend, SMS and webhook tools

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

The server asks you to sign in before it lists its tools.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 9, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account eSimfly-Official, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
✓ Pass
Endpoint responds
Responded in 340 ms (HTTP 401)
✓ Pass
Sign-in with OAuth
Declares OAuth sign-in, so your AI app can take you to log in
… Not checked yet
No hidden instructions in tool descriptions
Not checked yet; we read the tool list when we check the endpoint

Compared with others in Travel, maps & weatheri

More stars than 0% of the other 1737 servers in this category
Published to the registry more recently than 34% of the other 1737 servers in this category
Basic checks equal to or better than 100% of the other 1737 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Esimfly MCP safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: ESIMFLY_ACCESS_CODE, ESIMFLY_SECRET_KEY

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.1.3) reached the registry 2 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: Park Graph, Open Transfer Times, Gogcli MCP Maps

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Park Graph

Find, price and book parking at Park Graph lots: search, quote, hold and session tools.

by parkgraph.comEarlyUpdated today

Runs in the cloud✓ parkgraph.com

Install

Open Transfer Times

Check if a flight connection is comfortable, tight or risky, with cited airport data.

by joelynli0110Early↓ 1.5K/wkUpdated today

Runs on your computer

Install

Gogcli MCP Maps

Google Places + trip maps via gogcli for Claude — places through gog maps, pins, shortlists, My Maps

by chrischallVery newUpdated today

Runs on your computer

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

@esimfly/mcp — 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, check balances and usage, diagnose "no data" problems from live network data — and, if you enable it, place orders and top-ups with an explicit confirmation step.

Read-only by default. Nothing can spend your balance unless you opt in.
Two-step writes. Every write tool returns a preview (what, cost, balance) until called with confirm: true.
Built on the official [`@esimfly/sdk`](https://www.npmjs.com/package/@esimfly/sdk) — signing, retries and error codes handled.
Ships two prompts: the complete integration guide and an eSIM diagnosis workflow.

Docs: https://docs.esimfly.net · Credentials: Business Dashboard → Settings → API Keys.

Hosted server (no install)

Prefer not to run anything locally? eSIMfly hosts this same server at `https://mcp.esimfly.net/mcp`. Add it as a remote MCP server in Claude.ai, ChatGPT, Claude Code (claude mcp add --transport http esimfly https://mcp.esimfly.net/mcp), Cursor or VS Code and sign in with your eSIMfly business account — OAuth 2.1, no keys to paste, write tools opt-in on the consent screen. Details: https://docs.esimfly.net/docs/mcp-server

Local install

The server runs locally over stdio; your API key never leaves your machine.

Claude Desktop

claude_desktop_config.json → mcpServers:

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

Claude Code

claude mcp add esimfly -e ESIMFLY_ACCESS_CODE=esf_... -e ESIMFLY_SECRET_KEY=sk_... -- npx -y @esimfly/mcp

Cursor / Windsurf / other MCP clients

.cursor/mcp.json (or the client's equivalent):

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

Docker

docker build -t esimfly-mcp .

docker run -i --rm -e ESIMFLY_ACCESS_CODE=esf_... -e ESIMFLY_SECRET_KEY=sk_... esimfly-mcp

Enable write tools

Add "ESIMFLY_MCP_ALLOW_WRITES": "true" to env. Without it the ordering, top-up, cancel, suspend, SMS and webhook tools are not even registered.

Try it

"Find the cheapest 5 GB plan for Turkey and tell me my margin at €9.99."
"Which of my eSIMs are active and below 200 MB?"
"ICCID 8948010010036785060 says no data — diagnose it." *(uses the diagnose_esim prompt)*
"Set up webhooks for installed / status / low-data events at https://my.app/hooks." *(write tool, previews first)*
"Build me a Node.js integration." *(uses the esimfly_integration_guide prompt)*

Tools

Tool	What it does	Mode
`search_packages`	Catalogue search by destination / type with your cost price	read
`get_balance`	Account (or enterprise) balance	read
`list_esims`	Your eSIMs with status, data left, validity	read
`get_esim_usage`	Stored usage for one eSIM (cheap)	read
`get_esim_live_status`	Live status from the network: install state, last network, device, usage	read (expensive)
`get_network_events`	Last 7 days of attach / data-session events, wrong-network flag	read
`get_usage_report`	Daily usage by country and operator (up to 90 days)	read
`list_orders` / `get_order`	Order history and one order with its eSIM	read
`get_topup_packages`	Top-up options for one eSIM	read
`get_webhook_settings`	Webhook URL, events, recent deliveries	read
`create_order`	Buy eSIMs — preview → `confirm: true` + idempotency key	write
`topup_esim`	Add data to an eSIM — preview shows package and cost	write
`cancel_esim`	Cancel an unused eSIM and refund to balance	write (destructive)
`suspend_esim` / `activate_esim`	Block / restore network access	write
`send_sms`	Text the device holding the eSIM	write
`set_webhook`	Configure webhook URL and events	write

Prompts: esimfly_integration_guide (optional stack), diagnose_esim (iccid).

Safety model

Read-only unless ESIMFLY_MCP_ALLOW_WRITES=true.
Write tools are two-step: a call without confirm returns a preview and makes no mutable API call; create_order additionally requires the idempotency_key from its own preview, so an agent cannot place the same order twice.
Tool annotations mark reads as readOnlyHint and cancel/suspend as destructiveHint, so hosts that ask for user approval on risky tools do so.
The server never logs credentials and never writes to stdout except the MCP protocol.
Give the agent a dedicated API key with the smallest rate limits you are comfortable with, and rotate it from the dashboard if in doubt.

Configuration

Variable	Required	Description
`ESIMFLY_ACCESS_CODE`	yes	API access code (`esf_…`)
`ESIMFLY_SECRET_KEY`	yes	API secret key (`sk_…`)
`ESIMFLY_MCP_ALLOW_WRITES`	no	`true` to register write tools
`ESIMFLY_BASE_URL`	no	Override the API base URL

Embedding

import { createEsimflyMcpServer } from '@esimfly/mcp';

const server = createEsimflyMcpServer({ config: { accessCode, secretKey }, allowWrites: false }); // connect it to any MCP transport

Releasing (maintainers)

Bump version in package.json, server.json and MCP_VERSION in src/server.ts, add a CHANGELOG entry, push, then publish a GitHub Release tagged vX.Y.Z — the workflow publishes to npm with Trusted Publishing (OIDC), and the MCP Registry entry is republished automatically afterwards (GitHub OIDC, no tokens).

Support

support@esimfly.net · https://docs.esimfly.net

Esimfly MCP

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Or run it on your computer

Or run it on your computer

Or run it on your computer

Or run it on your computer

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Travel, maps & weatheri

Common questions

Alternatives

Park Graph

Open Transfer Times

Gogcli MCP Maps

README from the maker

@esimfly/mcp — eSIMfly MCP server

Hosted server (no install)

Local install

Claude Desktop

Claude Code

Cursor / Windsurf / other MCP clients

Docker

Enable write tools

Try it

Tools

Safety model

Configuration

Embedding

Releasing (maintainers)

Support