XGR.Network MCP

XGR MCP Gateway

XGR MCP Gateway は、Model Context Protocol を通じて、XGR.Network スタックへの AI ネイティブなアクセスを提供します。Claude、ChatGPT、IDE アシスタント、カスタムホストなどの MCP 対応エージェントを、XGRChain、XDaLa セッション、Explorer データ、XRC 標準、オーナーがレビューするオンチェーンアクションの準備につなぎます。

このゲートウェイは、エージェントを活用したワークフローの作成を目的に設計されています。エージェントは、最新のチェーン上の証拠を調べ、XDaLa プロセスの状態を推論し、XRC 成果物を作成し、ユーザーがローカルでレビューして署名する引き継ぎを準備できます。

このゲートウェイがユーザーまたは第三者の秘密鍵を要求、受領、保存、管理することはなく、ユーザーに代わって署名することもできません。ユーザーの書き込み意図は引き継ぎとして準備され、ローカルで署名されます。オプションのスターターガスサービスでは、サービスウォレットから固定量の XGR ガスを付与する目的に限り、専用のサーバー管理下の資金供給鍵を使用することがあります。

公開 MCP エンドポイント

メインネット：

https://mcp.xgr.network/mcp

テストネット：

https://mcp.testnet.xgr.network/mcp

実際の XGRChain および XDaLa のアクティビティを調べるには、メインネットを使用します。本番環境で使用する前に、エージェント主導のワークフローを安全に作成、検証、試行するには、テストネットを使用します。

MCP クライアントの設定

{
  "mcpServers": {
    "xgr-mainnet": {
      "type": "streamable-http",
      "url": "https://mcp.xgr.network/mcp"
    },
    "xgr-testnet": {
      "type": "streamable-http",
      "url": "https://mcp.testnet.xgr.network/mcp"
    }
  }
}

streamable-http ではなく http を引き続き想定するクライアントでは、同じエンドポイント URL を使用し、クライアントが提供する HTTP／リモート MCP トランスポートを選択してください。

エージェントにできること

• チェーンの状態を読み取る：XGRChain の最新の状態、ブロック、アカウント状態、トランザクションの証拠を調べます。
• 公式 XGR リソースを見つける：get_xgr_network_info を使用して、正規の XGR.Network、XGRChain、XDaLa、RPC、Explorer、MCP、ドキュメント、エコシステムのメタデータを取得します。
• XDaLa セッションを調べる：セッション、プロセスステップ、ペイロード、レシート、実行結果を検索、一覧表示し、内容を確認します。
• Explorer データを検索する：アカウント履歴、価値の移転、ブロック履歴、トランザクション統計、セッション分析を照会します。
• XRC 標準を扱う：XRC-137 のルール、XRC-729 オーケストレーション、プロセスグラフ、再利用パターン、失敗分析を確認します。
• プロセス成果物を作成する：組み込みのスキーマと検証ルールに基づいて、XRC-137／XRC-729 の成果物とバンドルを準備します。
• オーナー署名が必要なアクションを準備する：秘密鍵を公開せずに、デプロイやセッション開始のレビュー・署名用の引き継ぎを作成します。
• 利用可能な場合にスターターガスをリクエストする：デプロイ、セッション開始、コントラクト呼び出し、その他のオンチェーンアクションの前に、残高の少ない対象アドレスへ固定量の 1 XGR を付与します。

公式ネットワークメタデータ

get_xgr_network_info は、XGR.Network とそのエコシステムの、バージョン管理された機械可読メタデータを返します。ユーザーが公式プロジェクト情報、ネットワーク設定、RPC または Explorer のエンドポイント、MCP 接続情報、ドキュメント、XRC 標準のコンテキスト、ソースリポジトリを求めた場合、エージェントはこのツールを使用してください。

get_chain_status は、引き続きライブ JSON-RPC ステータスツールとして機能し、接続先の XGRChain メインネットの公式なエントリーポイントも簡潔に返します。

XGR.Network MCP を選ぶ理由

XGR.Network MCP は、汎用的なチャット自動化ではなく、決定論的なプロセス基盤を中心に構築されています。ユーザーの署名、ユーザーの資産管理、最終承認をゲートウェイの外部に保ちながら、エージェントに XGR スタックへの構造化されたアクセスを提供します。

そのため、次の用途に適しています。

• AI を活用した Web3 ワークフローの設計
• XDaLa プロセスの準備と確認
• コンプライアンスを重視したプロセス証拠
• 決定論的な検証および実行フロー
• EVM 互換のプロセス自動化
• XGRChain データおよび XRC 標準向けのエージェントインターフェース

ドキュメント

詳細なリファレンスは、XGR の中央ドキュメントにあります。

• ゲートウェイの概要
• ツールリファレンス
• 操作の引き継ぎ
• 作成とナレッジ
• セットアップと設定

セルフホスト

ゲートウェイは、独自の XGRChain RPC および Explorer インスタンスを使用して運用できます。セルフホストには、トランザクション検索ツールとセッション分析ツール用に、読み取り専用の Postgres ミラーを備えた Explorer のデプロイが必要です。

一般的なセットアップの流れ：

npm install
npm run typecheck
npm run build
npm run start:http

必要な実行時設定については、セットアップと設定に記載されています。

セキュリティモデル

• ゲートウェイがユーザーまたは第三者の秘密鍵を要求、受領、保存、管理することはありません。
• ユーザーのトランザクションは引き渡し用に準備され、ユーザー自身またはユーザーのカストディ環境によってローカルで署名されます。
• オプションのスターターガスサービスは限定的な例外です。専用のサーバー管理下の資金供給ウォレットからの送金にのみ署名し、ユーザーに代わって署名することはできません。
• スターターガスの付与額は 1 XGR 固定です。受取人の残高、アドレスごとに確認済みの付与 1 回、時間ごとおよび日ごとの上限、上限付きの再試行ポリシーによって制限されます。
• スターターガスの付与状態は、reserved、broadcast、confirmed、failed の各状態を使って SQLite にアトミックに保存されます。
• 本番環境でのユーザー署名は、引き続きユーザーのウォレットまたはカストディ環境の管理下にあります。

リンク

• ウェブサイト：https://xgr.network
• MCP エンドポイント：https://mcp.xgr.network/mcp
• 公式 MCP Registry 名：io.github.xgr-network/xdala-workflow-builder
• Smithery の掲載ページ：https://smithery.ai/servers/xgrnetwork/xdala-workflow-builder

ライセンス

Apache License 2.0 の下でライセンスされています。

メインネット XGR 購入ツール

オプションの購入ツールはメインネット専用で、デフォルトでは無効になっており、テストネットでは登録されません。XGR_PURCHASE_TOOLS_ENABLED=true、XGR_PURCHASE_NETWORK=mainnet、有効な HTTPS API URL（またはローカル HTTP）、および 249.99 EUR 以下の上限を設定してから有効にしてください。

quote_xgr_purchase は任意の計画用ツールです。create_xgr_purchase_order は POST /api/orders を 1 回呼び出して実際の注文を作成します。ウェブサイトの確認モーダルは、独立した API フェーズではありません。最終価格、暗号資産の数量、カストディウォレット、支払い参照情報、予約を決定するのはバックエンドです。MCP はユーザーまたは第三者の秘密鍵を保持せず、支払いも行いません。外部ウォレットエージェントは、返された正確な支払い指示を実行できます。

249.99 EUR の上限は、自律型注文に適用される MCP ポリシーです。これとは別に、XGR_Web バックエンドでは、新たに計算された net_eur >= 250 の場合、請求先住所の全項目が必要です。これはバックエンドの注文上限ではありません。バックエンドで価格の再計算または住所に関するエラーが発生した場合、注文を再試行せずにエラーを返します。

購入ツールでは、XGR の数量が固定された注文と、保守的な USDC/USDT 予算注文が区別されます。確定する市場価格と正確な amount_crypto は、実際のバックエンドへの POST によって決まります。EUR はポリシー上の参照値にすぎません。返された正確な数量が上限を超える予算注文では、支払いは行われず、既存の予約は通常どおり失効します。

スターターガスツール

有効な場合、get_xgr_starter_gas_options は現在の固定付与額と適格性ポリシーを提示します。request_xgr_starter_gas は、専用サービスウォレットから、残高の少ない適格な EVM アドレスへ 1 XGR の固定付与を 1 回送信します。対象アドレスにガス代用のネイティブ XGR がない場合、エージェントはデプロイ、セッションの開始、コントラクト呼び出し、その他のオンチェーン操作の前にこのツールを使用してください。

このサービスでは、アドレスの所有権証明を要求せず、プルーフ・オブ・ワークも使用しません。悪用を抑えるため、アドレスごとに確認済みの付与を 1 回に制限し、時間ごとおよび日ごとの上限を設け、受取人の残高に基づく適格性判定を行います。また、サービスウォレットの残高を低く保ち、ブロードキャスト前の失敗後の再試行回数も制限します。