MCP server for the eSIMfly Business API — let Claude, Cursor and other AI agents search eSIM plans, check usage, diagnose connectivity and (optionally) order
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add esimfly --env ESIMFLY_ACCESS_CODE='<ESIMFLY_ACCESS_CODE>' --env ESIMFLY_SECRET_KEY='<ESIMFLY_SECRET_KEY>' -- npx -y @esimfly/mcp~/.codex/config.toml
[mcp_servers.esimfly]
command = "npx"
args = ["-y", "@esimfly/mcp"]
env = { ESIMFLY_ACCESS_CODE = "<ESIMFLY_ACCESS_CODE>", ESIMFLY_SECRET_KEY = "<ESIMFLY_SECRET_KEY>" }
# codex mcp add esimfly --env ESIMFLY_ACCESS_CODE='<ESIMFLY_ACCESS_CODE>' --env ESIMFLY_SECRET_KEY='<ESIMFLY_SECRET_KEY>' -- npx -y @esimfly/mcp~/.cursor/mcp.json
{
"mcpServers": {
"esimfly": {
"command": "npx",
"args": [
"-y",
"@esimfly/mcp"
],
"env": {
"ESIMFLY_ACCESS_CODE": "<ESIMFLY_ACCESS_CODE>",
"ESIMFLY_SECRET_KEY": "<ESIMFLY_SECRET_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"esimfly": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@esimfly/mcp"
],
"env": {
"ESIMFLY_ACCESS_CODE": "<ESIMFLY_ACCESS_CODE>",
"ESIMFLY_SECRET_KEY": "<ESIMFLY_SECRET_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"esimfly": {
"command": "npx",
"args": [
"-y",
"@esimfly/mcp"
],
"env": {
"ESIMFLY_ACCESS_CODE": "<ESIMFLY_ACCESS_CODE>",
"ESIMFLY_SECRET_KEY": "<ESIMFLY_SECRET_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"esimfly": {
"command": "npx",
"args": [
"-y",
"@esimfly/mcp"
],
"env": {
"ESIMFLY_ACCESS_CODE": "<ESIMFLY_ACCESS_CODE>",
"ESIMFLY_SECRET_KEY": "<ESIMFLY_SECRET_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"esimfly": {
"command": "npx",
"args": [
"-y",
"@esimfly/mcp"
],
"env": {
"ESIMFLY_ACCESS_CODE": "<ESIMFLY_ACCESS_CODE>",
"ESIMFLY_SECRET_KEY": "<ESIMFLY_SECRET_KEY>"
}
}
}
}Remote
claude mcp add --transport http esimfly https://mcp.esimfly.net/mcp~/.codex/config.toml
[mcp_servers.esimfly]
url = "https://mcp.esimfly.net/mcp"
# codex mcp add esimfly --url https://mcp.esimfly.net/mcp~/.cursor/mcp.json
{
"mcpServers": {
"esimfly": {
"url": "https://mcp.esimfly.net/mcp"
}
}
}.vscode/mcp.json
{
"servers": {
"esimfly": {
"type": "http",
"url": "https://mcp.esimfly.net/mcp"
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"esimfly": {
"httpUrl": "https://mcp.esimfly.net/mcp"
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"esimfly": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.esimfly.net/mcp"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"esimfly": {
"url": "https://mcp.esimfly.net/mcp"
}
}
}Environment variables
ESIMFLY_ACCESS_CODEESIMFLY_SECRET_KEY
Replace the placeholders with your own credentials and keep them out of version control.