chainward

chainward-mcp-server

ChainWard 用の Model Context Protocol サーバーです。支払い前に Base または BNB Chain 上のアドレスを確認し、Base 上の AI エージェントウォレットに関する ChainWard のインテリジェンスを照会できます。

ChainWard は AI エージェントウォレットにラベルを付け、オンチェーンのアクティビティをリアルタイムで追跡し、調査結果を Decode として公開しています。このパッケージを使うと、MCP 互換のアシスタント（Claude Desktop、Cursor、Claude Code、Codex、ChatGPT）から、チャットを離れずに平易な言葉でそのインテリジェンスを照会できます。

これはスタンドアロンの配布方法です。Base MCP（署名を処理します）と併用できますが、Base MCP の web_request 許可リストには依存しません。

ツール

ツール	目的
check_counterparty	0x… への支払い前に、ChainWard の判定（ラベルは pay / hold / unknown、表示は「支払い可」「保留」「非アクティブ」「実績なし」「確認できませんでした」）を、判定理由ひとつ、その根拠となるフラグ、および存在する場合は Base 上の EAS アテステーション（uid とエクスプローラーへのリンク）とともに返します。BNB Chain アドレスには、オプションの chain に base（デフォルト）または bsc を指定できます（0.2.3 以降。BNB Chain のレポートはまだアテステーションされていません）。オンチェーンの挙動のみを対象とします。「支払い可」は保証ではありません。
rug_check	Base トークンの購入前に、ChainWard のラグチェック（hold / review / no_flags）を、判定理由ひとつとローンチに関する事実（ローンチしたウォレット、そのウォレットがローンチトークンを送信したかどうか、後続のミント、ローンチウォレットの制裁状況・経過期間・最初の資金提供者）とともに返します。1 時間あたり最大 20 回の新規チェックは無料です。大量利用向けの有料ルートは GET https://api.chainward.ai/api/risk/rugcheck?address=0x… です（x402 経由で $0.02）。ローンチウォレットが追加した流動性を引き揚げた場合は保留にします。ハニーポットや売却シミュレーションはありません。フラグがないことは保証ではありません。0.3.0 以降。
lookup_agent	0x… は既知の AI エージェントですか？ラベルと Decode の参照先を返します。低コストです。
get_agent_profile	詳細なプロフィール：7 日間の残高、30 日間のガス、直近 20 件のトランザクション、関連する Decode。
get_agent_economics	累計 ACP 収益、ジョブ数、成功率に加え、直近 30 日間のオンチェーン情報（受け取った収益、ガス代、利益（30 日間の収益から 30 日間のガス代を引いた額）、ガス効率）を返します。
get_observatory_overview	エコシステム全体の統計情報。
get_top_agents	アクティビティ別のランキング。
get_activity_feed	ラベル付きエージェントの最近のアクティビティ。
list_decodes	公開済みのすべての Decode を新しい順に返します。
find_decodes_for_address	特定のアドレスに言及しているすべての Decode を返します。

すべてのツールは、デフォルトで ChainWard の公開エンドポイントを使用します（認証不要）。CHAINWARD_API_KEY を設定すると、今後追加される認証が必要なツールを利用できます。

インストールと実行

Claude Desktop / Cursor / Claude Code（stdio）

// claude_desktop_config.json or .cursor/mcp.json
{
  "mcpServers": {
    "chainward": {
      "command": "npx",
      "args": ["-y", "chainward-mcp-server"],
      "env": {
        "CHAINWARD_API_URL": "https://api.chainward.ai"
      }
    }
  }
}

リモート HTTP トランスポート

CHAINWARD_MCP_TRANSPORT=http PORT=3300 npx -y chainward-mcp-server
# MCP endpoint: http://localhost:3300/mcp
# Health: http://localhost:3300/healthz

次に、クライアントの接続先を http://your-host:3300/mcp に設定します。

環境変数

変数	デフォルト	説明
CHAINWARD_MCP_TRANSPORT	stdio	stdio または http
PORT	3300	HTTP トランスポートの待ち受けポート
CHAINWARD_API_URL	https://api.chainward.ai	API のベース URL
CHAINWARD_API_KEY	(none)	オプションの ag_… Bearer キー

Base MCP と併用する

このサーバーは読み取り専用です。得られた情報をもとに操作（スワップ、貸し出しなど）を行うには、このサーバーとともに Base MCP をインストールしてください。推奨するアシスタントのプロンプトパターン：

見慣れないアドレスへの支払いまたは取引の前に、ChainWard の check_counterparty（エージェントの場合は lookup_agent も）を呼び出します。トークンの購入前には rug_check を呼び出します。Decode が存在する場合は、Base MCP プラグインを呼び出す前に、その内容をユーザー向けに要約します。

ライセンス

MIT