esim-mcp
This server provides tools to search and compare travel eSIM plans from CheapereSIM across 190+ destinations. You can: search destinations by name; list plans for a country sorted cheapest-first with optional duration, data, and limit filters; plan multi-country trips by comparing a regional eSIM to local plans per country; check plan coverage by group ID; and browse popular destinations. All tools are read-only (plans include buy links). No API key is required for these five tools. With an optional API token, you can also list your purchased eSIMs and check remaining data usage; without a token, only the five lookup tools are available.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@esim-mcp What is the cheapest eSIM for two weeks in Japan and South Korea?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
esim-mcp
An MCP server for travel eSIM plans. It lets Claude, Cursor, and any other Model Context Protocol client search travel eSIM data plans by country, compare prices, and work out the cheapest way to stay connected across a multi-country trip.
Ask "what is the cheapest eSIM for two weeks in Japan and South Korea?" and get real plans with real prices, not a guess.
esim-mcp is built and maintained by CheapereSIM, and returns CheapereSIM pricing. It covers 190+ destinations across 8 regions.
What you can ask
Once installed, these all work in plain language:
"What is the cheapest eSIM for Japan?"
"I am travelling to Japan, South Korea and Taiwan for three weeks. What should I buy?"
"Is there a single eSIM that covers all of Southeast Asia?"
"Which countries does that regional plan actually cover?"
"Show me unlimited data eSIM plans for Turkey."
"How much data is left on my eSIM?" (needs a token)
The interesting one is the multi-country case. A regional eSIM that covers your whole trip is sometimes cheaper than buying a local eSIM in each country, and sometimes it is not. plan_trip prices both and tells you which wins.
Related MCP server: ConnectMeGuru
Setup
Add this to your MCP client configuration:
{
"mcpServers": {
"esim": {
"command": "npx",
"args": ["-y", "esim-mcp"]
}
}
}No API key, no account, and no configuration are required to search destinations and compare plans. Set CHEAPERESIM_API_TOKEN only if you also want the two account tools.
Example: planning a multi-country trip
Asking plan_trip for three weeks across Japan, South Korea and Taiwan, with at least 10GB:
Option 1 - one plan covering everything, $34.58:
Asia (12 areas) 10GB 30Days: 10 GB for 30 days - $34.58 - covers 12 countries
https://cheaperesim.com/multi-country-esim?package=2488&utm_source=mcp&utm_medium=ai&utm_campaign=esim-mcp
Option 2 - one local plan per country, $17.52 total:
Japan 10GB 30Days: 10 GB for 30 days - $8.76
https://cheaperesim.com/esim/japan?package=339&utm_source=mcp&utm_medium=ai&utm_campaign=esim-mcp
South Korea 10GB 30Days: 10 GB for 30 days - $8.76
https://cheaperesim.com/esim/south-korea?package=345&utm_source=mcp&utm_medium=ai&utm_campaign=esim-mcp
No local plan available for: TW.
Recommended: option 1, since option 2 does not cover: TW.That is real output against live pricing, not an illustration. It is also the case worth understanding: buying local is half the price, and it is still the wrong answer, because Taiwan is sold only inside regional plans. A price comparison that stopped at the cheaper number would leave you without service for a third of the trip.
The server prints each buy_url exactly as the API returns it, so the links above are the ones you would get.
Tools
Tool | Description | Requires token |
| Find countries CheapereSIM sells eSIM plans for, by full or partial name. | No |
| List eSIM plans for one country, cheapest first. | No |
| Work out the cheapest way to stay connected across several countries. | No |
| List every country a regional or global plan covers. | No |
| List the destinations travellers buy eSIMs for most often. | No |
| List the eSIMs on the configured CheapereSIM account. | Yes |
| Show how much data is left on one eSIM. | Yes |
list_my_esims and get_esim_usage are only registered when CHEAPERESIM_API_TOKEN is set. Without a token, the server exposes the first five tools only, so a model never sees a tool it cannot call.
Environment variables
Variable | Default | Purpose |
|
| Base URL of the CheapereSIM API |
| unset | API token for the two account tools; omit to run in read-only lookup mode |
|
| Request timeout in milliseconds |
Keep CHEAPERESIM_API_BASE on https. The token is sent as a bearer header, so an http override would put it on the wire in cleartext.
Getting a token
Create a token at cheaperesim.com/dashboard/api-tokens. Tokens are read-only: they can list your eSIMs and their usage, but they cannot buy a plan, change your profile, or delete your account. Treat one like a password and revoke it if it leaks.
FAQ
What is an eSIM? A digital SIM your phone downloads instead of a plastic card you swap in. Most phones sold since about 2018 support one, so you can buy mobile data for a country before you land and skip roaming charges.
Which countries can I search?
190+ destinations across Europe, Asia, North and South America, Africa, Oceania and the Middle East, plus regional and global plans that span many countries at once. Use search_destinations to check a specific one.
Does this cost anything to install? No. The server and the five lookup tools are free and need no account. You only pay if you decide to buy a plan on cheaperesim.com.
Is a regional eSIM cheaper than buying one per country?
It depends on the trip, which is the whole reason plan_trip exists. For two neighbouring countries a pair of local plans often wins; across four or five, a regional plan usually does. The tool prices both and shows the difference.
Does it work with anything other than Claude? Yes. It speaks the Model Context Protocol over stdio, so any MCP client can run it, including Cursor and custom agents built on the MCP SDKs.
Can it buy a plan for me? No, by design. Every tool is read-only. Plans come back with a link, and the purchase happens in your browser on cheaperesim.com.
Development
npm install
npm test
npm run buildnpm run typecheck type-checks the tests as well as the source. CI runs the build, the typecheck, and the suite on Node 20 and 22.
License
MIT. See LICENSE.
Available Tools
5 toolsget_plan_coverageA
List every country a regional or global plan covers. Takes the group_id from a plan returned by plan_trip or list_plans. Local plans have a null group_id and cover only their own country.
Inputs: group_id (required).
list_plansA
List eSIM plans for one country, cheapest first. Use plan_trip instead when the user is visiting more than one country.
Inputs: country (required), days, limit, min_data_gb.
list_popular_destinationsA
List the destinations travellers buy eSIMs for most often, with a starting price for each. Use this only when the user has not named a destination and wants ideas. If they already named one country use list_plans, and if they named several use plan_trip.
Inputs: no named parameters.
plan_tripA
Work out the cheapest way to stay connected across several countries. Compares one regional plan covering the whole trip against buying a local plan per country, and says which is cheaper. Use this whenever the user names more than one destination.
Inputs: countries (required), days, min_data_gb.
search_destinationsA
Find countries CheapereSIM sells eSIM plans for, by full or partial name. Use this when the user names a place and you need its country code before looking up plans. Do not use it to compare prices or list plans: use list_plans for a single country, or plan_trip for several.
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose with explicit usage guidance in descriptions. search_destinations is for country codes, list_plans for single-country plans, list_popular_destinations for suggestions without a destination, get_plan_coverage for plan coverage details, and plan_trip for multi-country comparisons. No two tools overlap in a way that would cause confusion.
All tool names follow a consistent verb_noun pattern in snake_case: search_, list_, list_, get_, plan_. The verbs are imperative and the objects are clear, making the naming uniform and predictable.
With 5 tools, the server is well-scoped for its domain. Each tool covers a distinct aspect of eSIM planning: destination lookup, plan listing, popular suggestions, coverage details, and multi-country trip optimization. The count is neither sparse nor overwhelming.
The tool surface covers the full discovery-to-decision workflow: finding destinations, listing plans, considering popular options, understanding coverage, and comparing multi-country scenarios. There are no obvious dead ends—every user query about eSIM plans can be addressed with these tools.
Maintenance
Related MCP Connectors
Official ConnectMeGuru MCP server: search 190+ travel eSIM data plans and buy in-chat.
Official PuraSIM MCP server for travel eSIMs. Search and compare prepaid eSIM data plans for 187 countries, check 4G/5G network coverage, get personalized travel recommendations and generate direct purchase links. Free, read-only and no API key required. Compatible with Claude, ChatGPT, Cursor and other MCP clients.
Skiplagged MCP Server for flight search, hotel booking, and travel planning
Find travel eSIM plans, compare prices and create an order the user pays by link.
Related MCP Servers
- FlicenseAqualityDmaintenanceAn AI-powered travel planner MCP server enabling flight and hotel search, weather forecasts, point-of-interest discovery, itinerary generation, and budget management.8-
- AlicenseAqualityDmaintenanceAn official MCP server for ConnectMeGuru to search active travel eSIM packages, apply discount coupons, check wallet balance, and purchase eSIM plans directly within AI chats.141MIT
- FlicenseAqualityDmaintenanceMCP server that lets a chatbot browse eSIM plans, sign in, prepare quotes, and execute wallet or card purchases on an existing eSIM platform, with safe typed tools.19-
- FlicenseNot gradedqualityDmaintenanceMCP server offering travel planning tools such as destination search, weather lookup, attraction discovery, and budget estimation.-