Worldcitisim eSIM

com.worldcitisim由 worldcitisim.com 發布v0.2.2更新於 Oct 24, 2026

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

已驗證STDIO僅桌面位置與生活金融商業與電商

概覽

AI 產生的概覽

讓助理搜尋 WorldCitiSim 旅遊 eSIM 方案並建立訂單，可用信用卡或比特幣付款，並回傳開通 QR 資料。

可以做什麼
包裝 WorldCitiSim eSIM 商店 API，助理可依國家、地區、天數或流量篩選方案，並取得單一方案的所有規格。它能建立待付款訂單，回傳 Stripe 結帳連結，或回傳包含地址、金額與 QR 的鏈上比特幣付款資訊。輪詢工具可查詢訂單狀態，付款完成後回傳 ICCID、QR 連結等開通資料。
適用情境
適合讓助理在對話中比較旅遊 eSIM 方案並直接完成購買。適用於行程規劃與出國上網卡選購，前提是目的地在该目錄涵蓋範圍內。
執行需求
透過 npx 以 stdio 在本機執行，需要 Node.js 20.11 或更新版本。未宣告 API 金鑰或憑證；選用變數 WCS_ESIM_API_BASE 可覆寫 API 基礎網址。需要能連線 WorldCitiSim 商店 API 的網路，建立訂單時需提供買家電子郵件地址。
安裝前請注意
此伺服器會建立真實訂單並提供付款連結或比特幣付款資訊，可能產生實際支出。它會把買家電子郵件與訂單資訊傳送給 WorldCitiSim API。比特幣為鏈上付款且不可撤銷；信用卡付款在 Stripe 代管頁面完成。確認訂單前請核對方案、價格與目的地。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Worldcitisim eSIM，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@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

bash
claude mcp add --scope user wcs-esim npx -y @worldcitisim/mcp-esim

Or paste into ~/Library/Application Support/Claude/claude_desktop_config.json:

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: "[email protected]", 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

bash
npm installnpm run dev                 # stdio MCP server on this terminalnpm run build               # compile to dist/

Point a Claude Code session at the local dev build:

bash
claude mcp add wcs-esim-dev node "$(pwd)/dist/index.js"

Related

License

MIT

來源：README.md，提交 f04faf1

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分