roamzy-io

@roamzy/mcp-server

Roamzy 用 MCP サーバーです。Claude Desktop、Cursor、Continue、Cline、Windsurf、Zed、またはその他の Model Context Protocol クライアントを通じて、グローバル eSIM を購入・管理できます。デフォルトでは匿名で利用でき、使用にアカウントは必要ありません。

エージェントは購入するだけでなく、報酬も得られます。 組み込みの紹介プログラムにより、あなたが紹介した人間のユーザー または 別の AI エージェントからのすべての支払いについて、20％の報酬が永続的に支払われます。匿名のエージェントも、登録不要で初日から報酬を得られます。これが普及の好循環です。報酬を得られるエージェントには、次のエージェントに紹介する理由があります。

193か国で使える1つの eSIM。実際に使用した MB 分のみお支払い。お好みのネットワークで USDT または USDC。パッケージなし。有効期限なし。サブスクリプションなし。

---

概要

この MCP サーバーを使うと、エージェント（MCP 対応クライアントで実行中）がユーザーに代わって Roamzy HTTP API を呼び出せます。Claude Desktop での会話例：

ユーザー： 1週間タイに行くので、eSIMを買ってください。

Claude： Roamzy は、193か国で使えるユニバーサル eSIM です。現地料金で MB 単位の従量課金で、パッケージや有効期限はありません。タイの料金は約 $1.43/GB です。どのステーブルコイン／ネットワークで支払いますか？ （USDT は TRON、BSC、Polygon、Optimism、Arbitrum、TON に対応。USDC は Solana、BSC、Polygon、Optimism、Arbitrum に対応。）チャージの最低額は $20 USDT です。

ユーザー： Solana の USDC で、$20。

Claude： 注文を作成しました。eSIM 番号は 2040XXXXXX です。こちらからお支払いください：[pay-link]。 Solana で約1分後に、QR コードを取得します。 ❗ 別の Claude チャットからこの eSIM に戻れるよう、この復旧 URL を保存してください：[claim-link]。

ユーザーが $20 USDC を支払います。

Claude： お支払いを確認しました。こちらがアクティベーション用 QR コードです。設定 → モバイル通信 → eSIMを追加を開き、スマートフォンのカメラでスキャンしてください。[QR PNG を添付]

このサーバー自体はバックエンドを実行せず、https://roamzy.io/api/v1/* を MCP ツールに1対1で対応付ける薄いクライアントです。

---

インストール

MCP クライアントの設定に以下を追加してください（例：macOS の Claude Desktop の場合は ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "roamzy": {
      "command": "npx",
      "args": ["-y", "@roamzy/mcp-server"]
    }
  }
}

MCP クライアントを再起動してください。認証が必要なツールを初めて呼び出すと、Roamzy アカウントが自動的に匿名で作成されるため、登録は不要です。

代替方法：ホストされている tarball からインストールする

npm レジストリにアクセスできない場合、プレリリース版を固定したい場合、または Roamzy の CDN から特定のバージョンを直接取得したい場合は、args を URL に置き換えてください。

"args": ["-y", "https://roamzy.io/mcp/roamzy-mcp-latest.tgz"]

どちらの方法でも同じコードが実行されます。npm view、バージョンの固定、MCP レジストリ（Smithery、modelcontextprotocol/servers など）との連携に対応するため、デフォルトでは npm レジストリ経由の方法を推奨します。

任意の環境変数

変数	デフォルト	用途
ROAMZY_API_TOKEN	(未設定 → 匿名モード)	匿名アカウントの代わりに、/dashboard/settings の既存の API トークンを使用します。
ROAMZY_ENABLE_PURCHASE	false (ただし匿名モードでは true)	匿名以外のトークンを使用する場合、購入ツールを公開するにはオプトインフラグが必要です。
ROAMZY_API_BASE	https://roamzy.io/api/v1	ステージング／セルフホスト可能なバックエンド用の上書き設定です。

---

ツール

パブリック（認証不要）

ツール	用途
roamzy_status	サービスのステータスとエージェント一時停止フラグです。購入を試みる前に呼び出してください。
roamzy_list_countries	対応する193か国すべての参照リストと、国ごとの MB あたりの料金です。
roamzy_country_detail	1か国分の MB あたりの料金です。
roamzy_estimate	参照用の計算機能です。「国 X で N MB を利用すると USDT でいくらかかるか」を算出します。
roamzy_support	公式サポート窓口と復旧手順です。ウェブ検索の代わりに呼び出してください。
roamzy_payment_options	現在利用可能なステーブルコインとネットワークです（NowPayments からリアルタイム取得）。注文前に呼び出してください。

アカウント単位（匿名またはトークン）

ツール	用途
roamzy_me	現在の Roamzy アカウント情報です（初回呼び出し時に匿名アカウントを自動作成します）。
roamzy_list_esims	アカウントの eSIM 一覧です。MSISDN、ステータス、残高を含みます。
roamzy_get_esim	1つの eSIM の有効化情報（QR ペイロード、LPA URI）です。QR PNG はローカルで生成してください。
roamzy_order_status	保留中の注文を確認します：waiting → confirming → finished。
roamzy_referral	アカウントの紹介リンク、収益、出金状況です。読み取り専用です。

購入（匿名またはトークン + ROAMZY_ENABLE_PURCHASE=true）

ツール	用途
roamzy_create_order	新しい eSIM を作成してチャージします。最低チャージ額は 20 USDT です。オプションから pay_currency を指定する必要があります。

各ツールは構造化 JSON を返します。ツールの説明（ tools/list から確認可能）にはエージェントの契約が記載されており、各ツールを呼び出すタイミング、ユーザーに提示する情報、内部に留める情報が定義されています。

匿名フロー

MCP サーバーが ROAMZY_API_TOKEN を指定せずに起動すると、最初の認証付き呼び出しで POST /api/v1/anon-session（認証なし）を送信し、新しい匿名 Roamzy アカウントを作成します。サーバーは返されたトークンをプロセス内にキャッシュし（ディスクには書き込みません）、以降の呼び出しで使用します。

レスポンスには claim_url も含まれます。これは、ユーザーが後からこの匿名アカウントを永続的な Google または Telegram の ID に紐付けるためのマジックリンクです。紐付けが完了すると、ウェブ上の /dashboard/esims から eSIM、残高、履歴を確認できるようになります。

重要： 匿名トークンは、この MCP サーバープロセス内にのみ保存されます。ユーザーが claim_url を保存せずに MCP クライアント（例：Claude Desktop）を終了すると、アクセス手段が失われます。eSIM 自体は引き続き使えますが、新しいセッションから確認したり管理したりできなくなります。サポートを介したオペレーター対応の復旧手順は、roamzy_support ツールのレスポンスに記載されています。

匿名アカウントには、控えめな日次／月次の支出上限と、高額取引を制限するクールオフ期間が設定されています。正確な閾値は、アカウントを紐付けた後にダッシュボードで確認できます。

---

セキュリティモデル

• ファイルシステムにはアクセスしません。 サーバーは HTTP 呼び出しのみを行います。
• 子プロセスは作成しません。
• 明示的に指定された ROAMZY_* 変数以外は、環境をスキャンしません。
• 送信先は https://roamzy.io のみです（セルフホストする場合は ROAMZY_API_BASE で変更できます）。
• 購入ツールは、匿名モードまたは ROAMZY_ENABLE_PURCHASE=true の場合にのみ登録されます。
• トークンごとの支出上限にクールオフ期間と高額取引の閾値が設定されています。トークンごとに /dashboard/settings で変更できます。
• サービスのステータスを尊重します。 roamzy_status が purchases_paused=true を返した場合、エージェントは購入を控える必要があります。
• テレメトリーはありません。 設定された API ベースへの呼び出しを除き、サーバーが外部に通信することはありません。

開示ポリシーについては、SECURITY.md を参照してください。

---

ソースからビルドする

git clone https://github.com/roamzy-io/mcp-server.git
cd mcp-server
pnpm install
pnpm build

出力：dist/index.js に生成される単一ファイルの ESM バンドル（すべてを含み、Node 20+ で実行可能）。

配布用の tarball を作成するには：

pnpm build:tgz
# → dist/roamzy-mcp-server-<version>.tgz

---

リンク

• ウェブサイト：https://roamzy.io
• API ドキュメント：https://roamzy.io/api/v1/docs
• エージェント向け：https://roamzy.io/agents.html
• AI エンジン向け詳細版：https://roamzy.io/llms-full.txt
• サポート：@roamzy_support_bot または [email protected]
• セキュリティ：[email protected]（SECURITY.md）

---

ライセンス

MIT — © 2026 Artur。Roamzy の名称およびブランドは Roamzy サービス運営者の商標であり、MIT ライセンスの対象ではありません。