On-chain Forensics

オンチェーンフォレンジック MCP サーバー

MCP 対応のエージェント向けトークン調査ツールです。「このトークンに手を出すべきか」と尋ねると、価格チャートではなく、理由付きのレターグレードが得られます。依存関係ゼロ、stdio トランスポート、インストール不要です。

npx -y onchain-forensics-mcp

npm で onchain-forensics-mcp として公開されています。 レジストリにアクセスできない場合は、同じコードを GitHub から直接インストールできます： npx -y github:leohoudinisanders-byte/forensics-mcp。

ツール

ツール	回答する質問	価格
token_verdict	このトークンに手を出すべきか？A〜F のグレード、判定ティア、アクティビティスコア、一言の辛口評価。	無料トライアル後、$0.001
token_mints	このトークンは発行されているか？ミントイベント、発行量、ミント権限、正確な期間。	無料トライアル後、$0.02
settlesafe_check	このトークンは実際に決済できるか？レジストリ上の正当性、ERC-20 の読み取り可能性、一時停止状態。	無料トライアル後、$0.02
token_profile	読みやすい完全なプロフィール：供給量、小数桁数、保有者、上位ウォレット。	無料トライアル後、$0.05
wallet_profile	このウォレットは実在するか、また何を保有しているか？	無料トライアル後、$0.05
forensics_catalog	このサーバーでほかに何ができ、料金はいくらか？無料、ネットワーク呼び出しなし。	無料

グレードは、ライブのチェーン読み取りに対する決定論的なルールで算出されます。判定プロセスに LLM は介在しないため、同じトークンには毎回同じグレードが付与されます。

インストール

Claude Desktop（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "onchain-forensics": {
      "command": "npx",
      "args": ["-y", "onchain-forensics-mcp"]
    }
  }
}

Claude Code：

claude mcp add onchain-forensics -- npx -y onchain-forensics-mcp

Cursor（.cursor/mcp.json）とその他のクライアントでは、同じ command と args の組み合わせを使用します。

LangChain／Vercel AI SDK／カスタムランタイム：このサーバーは stdio 上で改行区切りの JSON-RPC 2.0 を使用するため、あらゆる MCP クライアント実装に組み込めます。実装済みのメソッド：initialize、tools/list、tools/call、ping。

無料の開発者キー（月 10,000 回の呼び出し）

curl -X POST https://api.onchainforensics.dev/functions/devKeys \
  -H "Content-Type: application/json" -d '{"email":"[email protected]"}'

レスポンスには、一度だけ表示されるキーが含まれています。キーを設定すると、すべてのツール呼び出しが支払い署名の不要な通常のデータ読み取りになります：

{
  "mcpServers": {
    "onchain-forensics": {
      "command": "npx",
      "args": ["-y", "onchain-forensics-mcp"],
      "env": { "FORENSICS_DEV_KEY": "fxk_..." }
    }
  }
}

支払い

各ツールはまず無料トライアルのティアを呼び出します。その経路の日次利用枠を使い切ると、有料エンドポイントは HTTP 402 を返します。ツールはエラーではなく、デコード済みの x402 チャレンジ（価格、USDC アセット、payTo、ネットワーク）を返すため、支払いに署名できるエージェントは処理を続行でき、署名できないエージェントも正確な料金を把握できます。

• 呼び出しごとの支払い：https://api.onchainforensics.dev/functions/<route> に対する任意の x402 クライアント
• プリペイドキー（呼び出しごとの署名不要）：POST /functions/forensicsCredits {"plan":"pack1"}

環境変数

変数	デフォルト
FORENSICS_BASE_URL	https://api.onchainforensics.dev/functions
FORENSICS_CHAIN	base
FORENSICS_TIMEOUT_MS	45000
FORENSICS_DEV_KEY	空（無料トライアルにフォールバックし、その後 x402 チャレンジにフォールバック）

ライセンス

MIT