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.

概览

AI 生成的概览

让助手搜索 WorldCitiSim 旅行 eSIM 套餐并创建订单,支持银行卡或比特币付款,并返回激活二维码数据。

可以做什么
封装 WorldCitiSim eSIM 商店 API,助手可按国家、地区、天数或流量筛选套餐,并获取单个套餐的全部规格。它可以创建待付款订单,返回 Stripe 结账链接,或返回包含地址、金额和二维码的链上比特币付款信息。轮询工具可查询订单状态,付款完成后返回 ICCID、二维码链接等激活数据。
适用场景
适合让助手在对话中比较旅行 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 分