Skip to content
MCP server

Esim MCP

Compare travel eSIM plans by country, and regional vs local pricing for multi-country…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.1
Listing updated
4 days ago

About Esim MCP

Esim MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Compare travel eSIM plans by country, and regional vs local pricing for multi-country trips.

Install

Run in a terminal

claude mcp add esim-mcp --env CHEAPERESIM_API_TOKEN='<CHEAPERESIM_API_TOKEN>' -- npx -y esim-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "esim-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "esim-mcp"
      ],
      "env": {
        "CHEAPERESIM_API_TOKEN": "<CHEAPERESIM_API_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "esim-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "esim-mcp"
      ],
      "env": {
        "CHEAPERESIM_API_TOKEN": "<CHEAPERESIM_API_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "esim-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "esim-mcp"
      ],
      "env": {
        "CHEAPERESIM_API_TOKEN": "<CHEAPERESIM_API_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "esim-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "esim-mcp"
      ],
      "env": {
        "CHEAPERESIM_API_TOKEN": "<CHEAPERESIM_API_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "esim-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "esim-mcp"
      ],
      "env": {
        "CHEAPERESIM_API_TOKEN": "<CHEAPERESIM_API_TOKEN>"
      }
    }
  }
}

Configuration

  • CHEAPERESIM_API_TOKENOptional read-only CheapereSIM API token. Without it the five plan-search tools work normally. With it, two extra tools can list the eSIMs on your account and their remaining data. Create one at https://cheaperesim.com/dashboard/api-tokens
  • CHEAPERESIM_API_BASEOverride the API base URL. Defaults to https://cheaperesim.com and only needs changing for local development.
  • CHEAPERESIM_TIMEOUT_MSPer-request timeout in milliseconds. Defaults to 10000.

Pricing

Open source

Prices change. Check cheaperesim.com before you buy.

Esim MCP FAQ

Is Esim MCP free?

Yes. Esim MCP is open source, so you can use and self-host it for free.

How do I add Esim MCP to Claude Code?

Run this command in your terminal: claude mcp add esim-mcp --env CHEAPERESIM_API_TOKEN='<CHEAPERESIM_API_TOKEN>' -- npx -y esim-mcp