xRocket Exchange MCP

MCP対応のAIクライアントを通じて、xRocket CEXの注文を準備・レビュー・実行します。ローカルサーバーは、別途承認された実行の前に、取引所の見積もり、手数料、市場ルール、関連残高、正確な意図を取得します。

ホスト型エンドポイントは、公開マーケットデータのデモおよびオンボーディング経路として引き続き機能し、アカウント資格情報を受け取ることはなく、取引を実行することもできません。このパッケージはxRocketと提携しておらず、xRocketからの推奨も受けていません。取引を設定する または xRocketを開く。

取引クイックスタート

1. xRocketにサインインし、メニュー → 設定 → 取引所設定 → APIトークン を開きます。

2. テストネット優先、注文限定のMCP設定を生成します：

   npx -y xrocket-mcp@0.5.0 trading-config

3. 出力されたJSONをローカルのMCPクライアントに貼り付けます。SET_YOUR_XROCKET_API_TOKEN_LOCALLY は、クライアントのローカルシークレットまたは環境設定のみで置き換えてください。

4. クライアントに注文の準備を依頼し、実行せずに見積もり、手数料、残高、ルール、正確な意図を表示させます。そのプレビューを確認した後、明示的に承認します。

npx -y xrocket-mcp@0.5.0 trading-config --mainnet は、テストネットの検証後に のみ使用してください。これは、メインネットの注文ゲートを個別に有効にし、転送と引き出しは無効のままです。

上流トークンは、文書化された粒度の細かいスコープではなく、アカウント全体に及ぶ広範なアクセス権を持ちます。このトークンをチャット、ホスト型エンドポイント、コミットしたファイル、イシュー、ログに入れないでください。

ホスト型マーケットデモ

接続ページ を使うか、何もインストールせず、認 proof なしで公開メインネットエンドポイントを直接コピーしてください：

https://xrocket-mcp-production.up.railway.app/mcp

これは10個の公開ツールのみを提供し、アカウントの鍵を読み取ることも、金銭的な書き込み操作を有効にすることもありません。取引を求められた場合、そのオンボーディングツールは上記のローカル設定手順をユーザーに案内します。

Related MCP server: tossinvest-openapi-mcp

ローカルクイックスタート

npx -y xrocket-mcp@0.5.0 doctor
npx -y xrocket-mcp@0.5.0 config

Node.js 20以上が必要です。公共の market データの読取りは設定なしで動作します：

XROCKET_PROFILE=public
XROCKET_ENVIRONMENT=mainnet

リポジトリのプラグイン用マーケットプレイスから、オールインワンのCodexプラグインをインストールします：

codex plugin marketplace add nakazanie-ton/myrocket --ref main
codex plugin add xrocket-exchange@xrocket-agents

MCPクライアントの例：

{
  "mcpServers": {
    "xrocket": {
      "command": "npx",
      "args": ["-y", "xrocket-mcp@0.5.0"],
      "env": {
        "XROCKET_ENVIRONMENT": "mainnet",
        "XROCKET_ENABLE_TRADING": "false",
        "XROCKET_ENABLE_TRANSFERS": "false",
        "XROCKET_ENABLE_WITHDRAWALS": "false",
        "XROCKET_ALLOW_MAINNET_WRITES": "false"
      }
    }
  }
}

ソースコードの開発は、このディレクトリで npm ci、npm test、および npm run build を実行します。

プロファイルと書き込みゲート

• public： 認証設定なしの10個のツール、合成された xrocket_market_snapshot を含みます。

• public-read： public ツールに加えて、残高、アカウント全体概要、注文、振替、引き出し、ク hostフォルダを利用可能。XROCKET_API_TOKEN が存在するとき判別されます。

• full：全ツールを使用できます。ただし、各実行機能群は、対応するゲートが true になるまで無効のままです。

書き込みゲートは XROCKET_ENABLE_TRADING、XROCKET_ENABLE_TRANSFERS、XROCKET_ENABLE_WITHDRAWALS です。初期値はすべて false 。メインネットへの書き込みにはさらに XROCKET_ALLOW_MAINNET_WRITES=true が必要です。

すべての金融書込みは、正確に準備された指示をサーバーのメモリに保存し、短命でリクエストに紐付き・一回限り使用できる承認レシートを返します。不足しているクライアント識別子は prepare の段階で生成され、プレビューとして表示されます。Execute はそのレシートだけを受け入れます。通信が不明瞭な場合も、書込みが自動的に再試行されることはありません。まずクライアント識別子で照合してください。

レシートはペイロードを拘束しますが、本人の同意を証明するものではありません。MCPクライアントに信頼できる承認画面やオペレータの帯域外承認手段がない場合は、すべての実行ゲートを無効のままにしてください。

制限事項

• Exchange APIには入金ウォレットアドレスのエンドポイントがありません。オンボールはUI上の案内のみです。

• 交換所内の振替は内部の fund ↔ trading 間の移動であり、ユーザー間送金ではありません。

• xRocket Payは xRocket の別製品であり、本スコープに含まれません。

• WebSocket チャンネルは監査ずみですが、0.5.0 は制約付きのRESTスナップショットを使用します。

• 金額は10進数の文字列として保ち、現在のAPIが要求する場合は TONCOIN を使ってください。

詳しいドキュメント、テストカバレッジ、セキュリティポリシー、プライバシー通知、利用条件は、プロジェクトリポジトリ にあります。