VerdictSwarm MCP Server

VerdictSwarm MCP サーバー

2026年10月7日に終了しました。 ホスト型の VerdictSwarm API と MCP サービスは廃止されました。公開パッケージは廃止済みの API に依存しており、トークンチェック、無料キー、リアルタイム価格、決済サービスを提供しなくなりました。このリポジトリでは、既存のライセンスのもとで、参照と再利用のために実装を保存しています。以下のセットアップ手順は、以前のサービスについて説明しています。

VerdictSwarm は、暗号資産に触れるエージェント向けの取引前セキュリティレイヤーです。この MCP サーバーは、Verdict API v2 を、トークンチェック、取引サイズを考慮した売却スクリーニング、リアルタイム価格情報の取得を行う、読み取り専用の小規模なツールセットとして提供します。

クイックスタート

アカウントの設定は不要です。VS_API_KEY が設定されていない場合、API を利用する最初のツール呼び出し時にサーバーが無料キーを発行し、プラットフォームのユーザー設定ディレクトリに保存します。

uvx verdictswarm-mcp

次に、MCP クライアントに「Solana 上の DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 を fast レベルでチェックして」と尋ねます。

既存の無料キーまたはクレジット付きキーを指定する場合：

VS_API_KEY=vs1_your_key uvx verdictswarm-mcp

Claude Desktop、Cursor、Windsurf、OpenClaw

このサーバーエントリーを使用します（env ブロックは任意です）。

{
  "mcpServers": {
    "verdictswarm": {
      "command": "uvx",
      "args": ["verdictswarm-mcp"],
      "env": {
        "VS_API_KEY": "vs1_your_key"
      }
    }
  }
}

VS_API_KEY がない場合、自己発行されたキーは次の場所に保存されます。

• macOS：~/Library/Application Support/VerdictSwarm/config.json
• Linux：${XDG_CONFIG_HOME:-~/.config}/verdictswarm/config.json
• Windows：%APPDATA%\VerdictSwarm\config.json

このファイルは、オペレーティングシステムがサポートしている場合、ユーザーのみがアクセスできる権限で作成されます。ディレクトリを変更するには、VS_CONFIG_DIR を設定します。

ツール

ツール	説明
check_token(address, chain="solana", level="fast")	POST /v2/verdict を呼び出し、アクション、スコア、概要、および最も強いシグナルを5件返します。レベルは triage、fast、deep です。
exit_sim(address, size_usd, side)	include:["exit_sim"] をリクエストし、最新の Solana 売却シミュレーションブロックを返します。side は buy または sell です。
get_pricing()	GET /v2/verdict/info から、リアルタイムの料金、レベル、上限、対応チェーンを取得します。

0.1.x の名称である scan_token、get_quick_score、check_rug_risk、get_token_report、verify_payment は、MCP ツールとして案内されなくなりました。クライアントに表示されるのは、上記の現在の v2 ツール3つだけです。古い名前を明示的に呼び出すと、移行に関する応答が返され、従来の決済レーンへのリクエストは行われません。

無料枠と x402 の超過分

無料キーには、API が案内するレベルごとの1日あたりの上限があります。上限に達すると、ツールの応答にはクォータのリセット時刻が示され、x402 チャレンジ全体が保持されます。すぐに利用を続けるには、VS_API_KEY にクレジット付きキーを設定するか、返された x402 の決済手順を使用します。

MCP クライアントは、API リクエストに次の帰属情報ヘッダーを送信します。

• X-VS-Integration: mcp
• X-VS-SDK-Version: 0.2.1

設定

環境変数	デフォルト	説明
VS_API_KEY	未設定	任意の無料またはクレジット付き v2 API キーです。
VS_API_URL	https://api.vswarm.io	VerdictSwarm API のベース URL です。
VS_TIMEOUT	120	HTTP リクエストのタイムアウト（秒）です。
VS_CONFIG_DIR	プラットフォームのユーザー設定ディレクトリ	自己発行されたキーの保存先ディレクトリです。
VS_TRANSPORT	stdio	MCP トランスポートです。HTTP には streamable-http を使用します。
HOST	0.0.0.0	HTTP のバインド先ホストです。
PORT	8000	HTTP のバインド先ポートです。

HTTP トランスポートの場合：

VS_TRANSPORT=streamable-http HOST=0.0.0.0 PORT=8000 uvx verdictswarm-mcp

プログラムからのクライアント利用

import asyncio
from verdictswarm_mcp import VerdictSwarmApiClient

async def main():
    client = VerdictSwarmApiClient()
    verdict = await client.check_token("TOKEN_ADDRESS", "solana", "fast")
    print(verdict["verdict"]["action"], verdict["verdict"]["score"])

asyncio.run(main())

開発

git clone https://github.com/sentien-labs/verdictswarm-mcp.git
cd verdictswarm-mcp
uv sync --extra dev
uv run --extra dev python -m pytest -q

このサーバーは Python 3.10～3.13 と、stdio および HTTP の両トランスポートに対応しています。

フィードバックとコミュニティ

エージェント、ボット、ウォレット、ダッシュボードでこのサーバーを使用しましたか？ クライアント、ランタイム、リスクチェックをどこに組み込んだか、うまくいったことや失敗したことを、VerdictSwarm コミュニティページで共有してください。また、インテグレーションを紹介したり、構造化された課題フォームを選択したり、プロジェクトをADOPTERS.mdに追加したりすることもできます。称賛は必須ではありません。スターを付けるのは、プロジェクトに独自に価値を見出した人だけにしてください。エージェントがスターを自動化してはなりません。

リンク

• VerdictSwarm
• API ドキュメント
• GitHub リポジトリ
• セキュリティポリシー

MIT ライセンスです。LICENSEをご覧ください。