isabellaliebgott/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
Or paste into ~/Library/Application Support/Claude/claude_desktop_config.json:
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
| Tool | Purpose |
|---|---|
| esim_search_plans | Filter catalog by country / region / days / GB. Returns matching plans with their first 5 variations. |
| esim_get_plan | Fetch one plan by slug with all variations. |
| esim_create_order | Create a pending order. payment_method: "stripe" (default) returns a Stripe Checkout URL for the user to tap; payment_method: "btc" returns an on-chain btc block (address + amount + QR) to show the user directly. Both return an order_token for polling. |
| esim_check_order | Poll an order's status. Returns activation data (ICCID, QR URL) once payment clears. |
Example interaction
For Bitcoin, Claude calls esim_create_order({ ..., payment_method: "btc" }) and gets back a
btc block — { address, sats_amount, btc_amount, qr_data_uri, expires_at } — 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 btc_unavailable error and Claude offers card
instead. Either way, esim_check_order polls until status=completed.
Environment
- WCS_ESIM_API_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.