Worldcitisim eSIM MCP server
com.worldcitisim/mcp-esim·v0.2.2Travel eSIMs for 193 countries. Stripe + Bitcoin checkout. QR by email in 30s. No API key.
0 stars36 downloads/wk
Reviews
Write oneNobody has reviewed Worldcitisim eSIM yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Worldcitisim eSIM tools (4, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
esim_check_orderwrite actionPoll an order's status. Returns `status: pending` while waiting for payment, `status: processing` or `completed` once paid, with `activation` data (ICCID, QR URL, install instructions).
esim_create_orderwrite actionCreate a pending order. With `payment_method: "stripe"` (default) you get back a `payment_link_url` — present it to the user to tap and pay on Stripe's hosted page. With `payment_method: "btc"` you get back a `btc` block (on-chain address + amount + QR data URI + expiry) — present the address and amount to the user to pay from any Bitcoin wallet; no redirect. If the user hasn't said how they want
esim_get_planFetch the full detail of one plan by slug, including all variations (every days × GB permutation with its price).
esim_search_plansSearch the Worldcitisim eSIM catalog. Returns plans matching the given filters (country ISO code, region, desired days, desired GB). Plans have variations — each variation is one specific (days × GB × price) combo. The user picks one variation_id to buy.
Public scan report
scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it
- Code scan3 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 110 days ago8/15
- Maintainer identitynamespace and repository owner differ; website matches verified namespace5/10
How Worldcitisim eSIM compares
Against every graded E-commerce MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 77/100
- higher than 55% of 2,174 E-commerce servers
- Tools
- 4
- the typical E-commerce server has 6
- Tools that change things
- 50%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 36
- more than 33% of 411 E-commerce servers with a package
What its tools let an agent do: 2 read · 2 change
Install Worldcitisim eSIM in Claude Code, Cursor or VS Code
Runs npx -y @worldcitisim/mcp-esim on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add mcp-esim -- npx -y @worldcitisim/mcp-esim
What the publisher says
From the Worldcitisim eSIM repository's README, as published. We do not edit it. Read it on GitHub
@worldcitisim/mcp-esim
MCP server that lets Claude and other MCP-compatible agents search and buy WorldCitiSim eSIM plans. Wraps https://shop.worldcitisim.com/wp-json/esim/v1/*.
Install
Claude Desktop / Claude Code
claude mcp add --scope user wcs-esim npx -y @worldcitisim/mcp-esimOr paste into ~/Library/Application Support/Claude/claudedesktopconfig.json:
{
"mcpServers": {
"worldcitisim-esim": {
"command": "npx",
"args": ["-y", "@worldcitisim/mcp-esim"]
}
}
}Cursor / Windsurf / other MCP clients
Same shape — command: "npx", args: ["-y", "@worldcitisim/mcp-esim"].
ChatGPT Developer Mode
Settings → Developer Mode → Add MCP server → same npx command.
Tools exposed
Example interaction
User: I'm going to Japan for 10 days, what eSIM should I get?
Claude calls: esim_search_plans({ country: "japan", min_days: 7, max_days: 15 })
→ returns matching plans with variations priced and in stock.
Claude picks the best match, presents 2–3 options to the user.
User: the 10GB one
Claude: "Pay by card or Bitcoin?"
User: card
Claude calls: esim_create_order({ email: "user@example.com", variation_id: 44941 })
→ returns { order_id, order_token, payment_link_url }.
Claude: "Tap this link to pay: <Stripe URL>. You'll get the eSIM QR in your email within ~30 seconds."
User pays. Claude optionally polls esim_check_order until status=completed.For Bitcoin, Claude calls esimcreateorder({ ..., paymentmethod: "btc" }) and gets back a btc block — { address, satsamount, btcamount, qrdatauri, expiresat } — which it shows the user to pay from any on-chain wallet. No redirect. If BTC is declined for a small order during a network-fee spike, the call returns a btcunavailable error and Claude offers card instead. Either way, esimcheck_order polls until status=completed.
Environment
- WCSESIMAPI_BASE — override the API base URL. Default: https://shop.worldcitisim.com/wp-json/esim/v1.
Runtime
- Node 20.11+ (for native fetch + ESM).
- No secrets. No Stripe credentials touch this process. Payment happens on Stripe's hosted checkout page; the MCP just hands the agent the URL.
- Catalog is client-side cached 5 minutes + ETag-aware; multiple search calls within a minute don't hit the network.
Development
npm install
npm run dev # stdio MCP server on this terminal
npm run build # compile to dist/Point a Claude Code session at the local dev build:
claude mcp add wcs-esim-dev node "$(pwd)/dist/index.js"Related
- WorldCitiSim — eSIM travel service for 193 countries.
- WorldCitiSim eSIM API — OpenAPI 3.1 spec the server wraps.
License
MIT
Nothing above is checked by us. What we check is on the safety report.
Worldcitisim eSIM: common questions
- Is Worldcitisim eSIM MCP server safe?
- Mostly: it is graded B (77/100). Read the Worldcitisim eSIM safety report
- How do I install Worldcitisim eSIM?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Worldcitisim eSIM need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Worldcitisim eSIM maintained?
- The last commit was 150 days ago (2026-06-07). The latest release is v0.2.2.
- What can I use instead of Worldcitisim eSIM?
- Servers from other publishers that do the same job: Stripe Acp MCP server, Stripe MCP server and Ecommerce Trends MCP server.
- How does Worldcitisim eSIM compare with other E-commerce MCP servers?
- safety score 77/100 (higher than 55% of 2,174 E-commerce servers); tools 4 (the typical E-commerce server has 6); tools that change things 50% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Worldcitisim eSIM
Same job from other publishers: the closest match first, then the best rated.
- Stripe AcpStripe ACP — AI agent checkout, payment delegation, products, invoicesnot reviewedGrowingB
- StripeMCP server integrating with Stripe - tools for customers, products, payments, and more.not reviewedEstablishedA
Ecommerce Trends MCPProduct and category demand trend volume over time, with growth signals. Free key at trendsmcp.ainot reviewedGrowingA- EsimflyeSIMfly Business API: search eSIM plans, check usage, diagnose eSIMs, optionally order (confirmed)not reviewedGrowingA
- Steam MCP ServerSteam store/game data (no key) plus player profiles, libraries and achievements (Steam Web API).not reviewedGrowingB