Token Verdict

token-verdict-mcp

単独のリポジトリ: このサーバーは QuincyGB/token-verdict-tools から分離されました。ディレクトリへの登録とメンテナンスのため、各 MCP サーバーに独自の GitHub リポジトリを用意しています。PyPI パッケージ名（token-verdict-mcp）、バージョン、インストールコマンドに変更はありません。

MCP サーバー（stdio トランスポート）です。Claude Desktop、Cursor、または独自のエージェントランタイムなど、あらゆる MCP ホストで Token Verdict をネイティブツールとして利用できます。

Token Verdict は、AI エージェント向けの従量課金制トークンリスク判定サービスです。トークンのコントラクトアドレスを送ると、判定結果（SOLID / CAUTION / DANGER）、0～100 のリスクスコア、わかりやすい表現で説明された6つの重み付け済み市場構造シグナル、そしてアナリストによる所見が返されます。料金は Base 上で1回あたり $0.02 USDC で、x402 protocol を通じて支払います。アカウントも API キーも不要で、支払いが認証を兼ねます。

ツール

token_verdict — 1つのツールで、サービスの実際のコントラクトに対応しています。

入力	型	備考
address	string（必須）	トークンのコントラクトアドレス（0x...）
chain	string、デフォルト "base"	base · ethereum · solana — 分析するトークン市場です。支払いは常に Base 上の USDC で決済されます。

出力はサービスの判定 JSON で、token、verdict、score、signals（正確に6つ）、take、および market（判定の根拠となる生データのため、呼び出し元が計算を再確認できます）が含まれます。分析対象は市場構造のみです。ハニーポットのシミュレーションと保有者の集中度は確認されず、製品はすべての所見でそのことを明示しています。

インストール

pip install token-verdict-mcp

# Or from a checkout of this repository:
pip install .

Python ≥ 3.10 が必要です。このサーバーでは MCP v1 SDK API（mcp>=1.2,<2）を固定しています。

設定

すべての設定は運用者自身の環境で行います。このサーバーを実行するユーザーが自身のウォレットを用意します。このパッケージに鍵情報は含まれておらず、パッケージの作者があなたの鍵を見ることもありません。

環境変数	必須	用途
AGENT_PRIVATE_KEY	有料呼び出しの場合	Base 上に USDC を保有するウォレットの EVM 秘密鍵（0x...）です。x402 EIP-3009 認証への署名にローカルで使用します。
AGENT_KEY_FILE	代替手段	その鍵を含むファイルへのパスです。
TOKEN_VERDICT_URL	いいえ	サービスのベース URL の上書き（デフォルト：本番環境）です。
TOKEN_VERDICT_MAX_AMOUNT_UNITS	いいえ	USDC の最小単位で指定する、呼び出し1回あたりの支出上限です（デフォルトは 20000 = $0.02、既知の価格です）。クライアントは、この上限を超える価格への署名を拒否します。

署名者が設定されていない場合、このツールは決して支払いません。 402 が返ると、解析済みのチャレンジを構造化エラーとして返します。エラーは error: "payment_required" で、完全な accepts 配列（scheme、network、asset、amount、payTo）を含みます。これにより、呼び出し元のエージェントは価格を確認して対応を判断するか、独自の x402 クライアントでチャレンジを決済できます。

MCP ホストの設定

Claude Desktop（claude_desktop_config.json）。ほかの stdio MCP ホストでも同じ形式です。

{
  "mcpServers": {
    "token-verdict": {
      "command": "token-verdict-mcp",
      "env": {
        "AGENT_PRIVATE_KEY": "0xYOUR_OWN_WALLET_KEY"
      }
    }
  }
}

インストールせず、チェックアウトしたリポジトリから実行する場合：

{
  "mcpServers": {
    "token-verdict": {
      "command": "python",
      "args": ["-m", "token_verdict_mcp"],
      "env": {
        "PYTHONPATH": "/path/to/token-verdict-mcp/src",
        "AGENT_KEY_FILE": "/path/to/your/agent.key"
      }
    }
  }
}

ホストの設定で可能な場合は、設定ファイルに鍵を直接記述するのではなく、AGENT_KEY_FILE を使用してください。

支払いの仕組み

クライアントは標準的な x402 v2 フローを踏襲しています（サービス自身が実際のカタログ登録の支払いに使用するフローと同じです）。

1. 未払いで POST /v1/verdict を送信 → HTTP 402 が返り、チャレンジは payment-required ヘッダー内に Base64 エンコードされます。
2. accepts から exact / eip155:8453 のエントリを選びます。
3. EIP-3009 の TransferWithAuthorization（validAfter: 0、validBefore: now + maxTimeoutSeconds、ランダムな32バイトのノンス）を作成し、チャレンジで通知された USDC ドメイン（extra.name / extra.version）に対する EIP-712 型付きデータとして署名します。
4. 同じ POST を再試行し、ペイロードを PAYMENT-SIGNATURE ヘッダーに含めます。サービスはサーバー側でファシリテーター（PayAI）を通じて検証と決済を行い、決済のレシートを payment-response ヘッダーで返します。

テスト

pip install -e ".[dev]"
pytest

14 件のテストがあり、すべての支払いはモックされています（httpx の MockTransport を使用し、テスト実行時に使い捨ての署名者を生成します）。402 のフィクスチャは本番環境から取得した実際のチャレンジです。支払いフローのテストでは、EIP-712 署名から実際に署名者のアドレスを復元できることを検証します。

セキュリティに関する注意事項

• 秘密鍵は実行時に環境変数から読み込まれ、支払い承認へのローカル署名にのみ使用されます。送信されることはありません。x402 ペイロードに含まれるのは署名であり、鍵ではありません。
• 支出ガードにより、1 回の呼び出しあたりの上限額は設定された金額に制限されます（デフォルト：正確に 0.02 ドル）。
• エージェントに資金を供給する場合と同様に、運用資金のみを保有する専用のエージェントウォレットで実行してください。