E
eSimfly-Official/esimfly-mcp
Give your AI assistant hands on the eSIMfly Business API.
updated 2026-11-18
View on GitHub ↗Direct link · no redirect page
Install & config
Remote endpoint (mcpServers - Claude Desktop / Cursor / Windsurf)
{
"mcpServers": {
"esimfly-official-esimfly-mcp": {
"url": "https://mcp.esimfly.net/mcp"
}
}
}Paste this into the mcpServers config of Claude Desktop or Cursor. The endpoint comes from public evidence; we do not install or host it. Official Registry record: this endpoint lists no request headers. That is not the same as key-free - the project docs decide.
VS Code (.vscode/mcp.json - the key is servers, remote needs type: http)
{
"servers": {
"esimfly-official-esimfly-mcp": {
"type": "http",
"url": "https://mcp.esimfly.net/mcp"
}
}
}VS Code differs from the other three: the top-level key is <code>servers</code> and a remote endpoint also needs <code>"type": "http"</code>. Paste into .vscode/mcp.json.
Claude Code (command line)
claude mcp add --transport http esimfly-official-esimfly-mcp https://mcp.esimfly.net/mcp
Claude Code does not read a config file; add the server with this command.
Config file: macOS
~/Library/Application Support/Claude/claude_desktop_config.json, Windows %APPDATA%\Claude\claude_desktop_config.json, Linux ~/.config/Claude/claude_desktop_config.json. Key names differ by client: Clients & CLI- Star count
- 0 ★ · eSimfly-Official/esimfly-mcp · read from the GitHub search API · (checked 2026-11-19 20:00:48)
- Source
- collected from the punkpeye/awesome-mcp-servers list · type: MCP server
- Harvest history
- first seen 2026-11-18 · last seen 2026-11-20 · seen 3× · listed by 3 sources
- Score
- score 300 · 3 sources · mcp
FAQ (answers come from our records)
How do I install it?
We did not find an install command for this repository (our install coverage is only about 4%). Check its README or releases page.
Who is it for?
We filed it under these tags: MCP servers. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
eSimfly-Official/esimfly-mcp;first catalogued 2026-11-18;last seen 2026-11-20。There is no official certification or quality rating here — we record sources and dates only.README excerpt (English, untranslated) · Read the full README on GitHub →
# @esimfly/mcp — eSIMfly MCP server
Excerpted from the repository README (abridged)
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 — 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:
json
"mcpServers": {
"esimfly": {
"command": "npx",
"args": ["-y", "@esimfly/mcp"],
"env": {
"ESIMFLY_ACCESS_CODE": "esf_...",
"ESIMFLY_SECRET_KEY": "sk_..."
### Claude Code
bash
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):
json
"mcpServers": {
"esimfly": {
"command": "npx",
"args": ["-y", "@esimfly/mcp"],
"env": { "ESIMFLY_ACCESS_CODE": "esf_...", "ESIMFLY_SECRET_KEY": "sk_..." }
### Docker
bash
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 |
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 — 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:
json
"mcpServers": {
"esimfly": {
"command": "npx",
"args": ["-y", "@esimfly/mcp"],
"env": {
"ESIMFLY_ACCESS_CODE": "esf_...",
"ESIMFLY_SECRET_KEY": "sk_..."
### Claude Code
bash
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):
json
"mcpServers": {
"esimfly": {
"command": "npx",
"args": ["-y", "@esimfly/mcp"],
"env": { "ESIMFLY_ACCESS_CODE": "esf_...", "ESIMFLY_SECRET_KEY": "sk_..." }
### Docker
bash
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 |
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/esimfly-official-esimfly-mcp/)
- Source
- awesome · https://github.com/eSimfly-Official/esimfly-mcp
- Browse by field
- MCP servers
- Listed by
- 3 independent sources
- added
- today
More MCP servers
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.