English Français العربية

Worldcitisim eSIM

Registre officiel Productivité

Travel eSIMs for 193 countries. Stripe + Bitcoin checkout. QR by email in 30s. No API key.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @worldcitisim/mcp-esim
Claude Code 
claude mcp add worldcitisim-esim -- npx -y @worldcitisim/mcp-esim@0.2.2
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "worldcitisim-esim": {
            "command": "npx",
            "args": [
                "-y",
                "@worldcitisim/mcp-esim@0.2.2"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. @worldcitisim/mcp-esim
  2. Install
  3. Tools exposed
  4. Example interaction
  5. Environment
  6. Runtime
  7. Development
  8. Related
  9. License

@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-esim

Or paste into ~/Library/Application Support/Claude/claude_desktop_config.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

ToolPurpose
esim_search_plansFilter catalog by country / region / days / GB. Returns matching plans with their first 5 variations.
esim_get_planFetch one plan by slug with all variations.
esim_create_orderCreate 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_orderPoll an order's status. Returns activation data (ICCID, QR URL) once payment clears.

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 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.

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"

License

MIT

Questions fréquentes

Qu'est-ce que Worldcitisim eSIM ?

Travel eSIMs for 193 countries. Stripe + Bitcoin checkout. QR by email in 30s. No API key.

Comment installer Worldcitisim eSIM ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add worldcitisim-esim -- npx -y @worldcitisim/mcp-esim@0.2.2. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Worldcitisim eSIM ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

Worldcitisim eSIM est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Worldcitisim eSIM ?

Il est publié par isabellaliebgott. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.