XRPL Token Guard

XRPL Token Guard

AI エージェントや音声アシスタントに「このトークンは安全ですか？」と尋ねれば、理由を添えた正直な回答が得られます。

XRPL Token Guard はオープンソースの MCP サーバーです。XRP Ledger のトークンとウォレットを、メインネットの最新の読み取り専用データを使ってチェックし、次の 3 つを返します。

• 判定：高リスク／注意／危険信号は見つかりません／データが不十分です
• その判定の理由。それぞれに、根拠となる正確なレジャー上の事実を示します
• Alexa+ やその他の音声アシスタントでのテキスト読み上げにすぐ使える、1 文の音声要約

署名やトランザクションの送信は一切行わず、キーを尋ねることもありません。

簡易チェックより詳しい情報が必要ですか？

無料のホスト型デモを試すか、無料のトークン証拠ページをご覧ください。Launch Lab では、5 XRP のトークンレポート、3 XRP のウォレット診断、10 XRP のトークンローンチキットを提供しています。有料レポートを選ぶ前に、調査結果をプレビューできます。これらはレジャーの事実確認であり、売買の助言や安全性の保証ではありません。Token Guard は引き続き無料です。

ホスト型 MCP： https://cocoeatsai.com/area4/guard/mcp（Streamable HTTP）。ホスト型デモでは、テキストでの質問とサンプルボタンが利用できます。ホスティングポリシーにより、現在マイク入力は無効になっています。これは音声アシスタントのシミュレーターであり、実際の Alexa 連携ではありません。

Claude Desktop（claude_desktop_config.json）または Cursor（.cursor/mcp.json）の場合は、以下のコマンドでローカルクローンをビルドしてから、この設定内の絶対パスを置き換えてください。

{"mcpServers": {
  "xrpl-token-guard": {"command": "node", "args": ["/absolute/path/to/xrpl-token-guard/dist/stdio.js"]}
}}

リスク解釈の例（取引の推奨ではありません）：

You:    "Is this RLUSD real?"
Guard:  "Warning, high risk. This token calls itself RLUSD, but it is not the real Ripple USD.
         The real one comes from a different issuer. A matching name does not establish authenticity."

作成の背景

詐欺師は XRP Ledger 上で有名な名前をコピーします。現在のメインネットには、Ripple のものではない RLUSD という名前のトークンが複数存在します。その多くはブラックホール化された発行者を持ち、これ以上発行できないことから、単純なチェッカーでは「安全」と判定されます。Token Guard は公式の発行者を把握しており、コピー品を最初に検出します。供給量がロックされていても、模倣品が本物になるわけではないことを説明します。

回答は、音声で読み上げられるだけ短く、信頼できるだけ具体的である必要があります。検出結果にはすべて、画面表示やエージェント向けの正確な message と、音声向けの spoken の行が含まれます。

ツール

ツール	回答する内容	レジャー呼び出し
check_token_safety	「このトークンは安全ですか？」を確認します。RLUSD／USDC／SOLO の模倣品、発行を継続できる発行者、凍結や取り消しが可能な発行者、Global Freeze、送金手数料、未確認またはローンチパッドのみのドメイン、クジラによる保有集中（AMM プールを除く）、流動性の薄い AMM、新規発行者をチェックします。	account_info, gateway_balances, amm_info, account_lines, account_tx
is_it_the_real_token	「これは本物の RLUSD ですか？」に回答します。確認済みの公式発行者（各発行者のレジャー上の Domain がブランド独自のサイトを指しています）を使って即座に回答します。	なし
check_wallet_security	「ウォレットがハッキングされましたか？」を確認します。見知らぬユーザーのレギュラーキーやマルチシグ署名者リスト（典型的な資産抜き取りの設定）を検出し、過去 7 日間の変更には緊急のマークを付けます。	account_info, account_tx

音声アシスタントに回答方法を指示する voice_token_check プロンプトもあります。判定と主な理由を 2 文で述べ、売買の助言はしないよう指示します。

すべてのツールには次のものが含まれます。

• readOnlyHint: true
• 各レスポンスに型付きの structuredContent を含む outputSchema
• 人が読めるテキストブロック

ティッカーは発行者の実際の債務に対して大文字・小文字を区別せずに照合されるため、「bigds」と尋ねると $BIGDS が見つかります。

実行方法

npm install
npm run build
npm start                 # Streamable HTTP on http://127.0.0.1:8787/mcp, voice demo on http://127.0.0.1:8787/
npm run stdio             # stdio transport for Claude Desktop / Claude Code / Cursor
npm test                  # 14 unit + end-to-end MCP tests (LIVE=1 adds a mainnet check)

トランスポート： Streamable HTTP、MCP プロトコル 2025-11-25。

• ステートレスです。各 POST /mcp で新しいサーバーが起動するため、水平スケーリングが可能です。
• JSON レスポンスを返します。
• レート制限：IP アドレスごとに毎分 60 リクエストです。
• ALLOWED_ORIGINS でオリジンの許可リストを設定できます。
• GET /health でトランスポートとプロトコルが報告されます。

Docker：

# Web demo + Streamable HTTP (default target)
docker build -t xrpl-token-guard .
docker run --rm -p 8787:8787 xrpl-token-guard

# stdio MCP clients / Glama: keep stdin open; do not allocate a TTY
docker build --target stdio -t xrpl-token-guard:stdio .
docker run --rm -i xrpl-token-guard:stdio

デフォルトイメージを使用する Glama ビルド仕様では、CMD 引数に node dist/stdio.js を設定してください。API キーやウォレット認証情報は必要ありません。

Claude Desktop（claude_desktop_config.json）：

{ "mcpServers": { "xrpl-token-guard": { "command": "node", "args": ["/path/to/xrpl-token-guard/dist/stdio.js"] } } }

設定

環境変数	デフォルト値	意味
XRPL_RPC_URLS	https://xrplcluster.com,https://s1.ripple.com:51234,https://s2.ripple.com:51234	順番に試行されるパブリック XRPL JSON-RPC エンドポイント
HOST / PORT	127.0.0.1 / 8787	バインドアドレス
ALLOWED_ORIGINS	（任意）	/mcp 用のカンマ区切りの Origin 許可リスト
TOKEN_GUARD_LINKS	on	トークンの無料の台帳証拠ページが存在する場合、そのページへのリンクを追加します。off にすると無効になります

音声デモ（Alexa+ スタイルのシミュレーター）

http://127.0.0.1:8787/ を開いてマイク（Chrome）をタップするか、テキストを入力してください。

• このページは、Streamable HTTP で /mcp と通信する小規模な MCP クライアントです。質問をツール呼び出しに変換し、spoken_summary を読み上げます。
• 右側のパネルに、ライブの tools/call リクエストと結果が表示されます。
• /?demo=1 では、画面録画用の字幕付きスクリプト実行を再生します。

判定の仕組み

重大度	例	影響
⛔ 高	公式トークンへのなりすまし、Global Freeze が有効、クローバックが有効、発行者が存在しない、発行量がゼロ	判定 高リスク
⚠️ 注意	発行者が追加発行／凍結できる、送金手数料が 1% 超、1 つのウォレットが 50% 超または上位 10 件が 80% 超（AMM プールを除く）、保有者が 25 未満、AMM の流動性が 500 XRP 未満、発行者の設立から 14 日未満、ドメインに発行者が記載されていない	判定 注意
✅ 良好 / ℹ️ 情報	公式発行者、ブラックホール化された供給量、検証済みドメイン、十分な流動性	参考情報のみ

規制対象のステーブルコインでは、発行者による制御が残されている場合があります。公式な身元の確認と制御ポリシーの判定は別です。クローバックは、公式発行者であっても重大な失格要因です。スコア（0～100）は大まかな目安にすぎません。投資助言ではありません。 これらはチェック時点の台帳上の事実です。

開発者

Zach Riehn（Launch Lab、人々と AI エージェント向けの XRPL ツール）。Launch Lab は、ウォレットとトークンの詳細レポートを提供する従量課金制の x402 API（XRPL 上の XRP/RLUSD、Base 上の USDC）も運営しています。Token Guard は無料のオープンコアです。

MIT ライセンスです。

発行者制御ポリシー（2026-10-18）

凍結制御の条件は、NoFreeze が設定されている、または master が無効化され、RegularKey が正確に rrrrrrrrrrrrrrrrrrrrBZbvji であり、署名者リストが存在しない場合に合格します。規制対象のステーブルコインを含むすべての発行者について、クローバック権限は重大な失格要因です。Global Freeze がすでに有効な場合も失格となります。MCP の構造化出力には、freeze_control_pass、issuer_controls_pass と正確なルールが含まれます。RegularKey がないことは、要求されるブラックホール化の証明にはなりません。NoFreeze だけでは、追加発行や Global Freeze の有効化を防げません。身元、集中度などのチェックも引き続き適用されます。スコアは機械的に算出されたもので、安全である確率を示すものではありません。