Verdix address risk

verdix-mcp：エージェントが送金する前にアドレスを確認

AI エージェントが、資金を送ったりコントラクトを承認したりする前に、Base 上の EVM アドレスを確認できる MCP サーバーです。Verdix に問い合わせ、安全・注意・危険の判定とその理由を取得します。以下をチェックします。

• OFAC 制裁対象
• 詐欺、フィッシング、エクスプロイトのリスト
• アドレスポイズニングに使われる類似アドレス。Base 上のすべてのトークン送金をリアルタイムで監視して生成されます
• コントラクトの経過年数、コード、来歴
• バーンアドレス

チェックごとに、x402 を介して Base 上の USDC で支払います。支払元はご自身のウォレットです。アカウント、API キー、サブスクリプションは不要です。キーがマシンの外に出ることはなく、署名する前に価格上限が適用されます。

「0x4c3f…9e21 に 50 USDC を送って」：エージェントはまず check_address_risk を呼び出し、"verdict": "danger", "reasons": ["address_poisoning"] を受け取ると、停止して確認を求めます。

ツール	機能	料金
check_address_risk(address, tier)	Verdix の判定 JSON を変更せずに返します	quick $0.02 · standard $0.10（デフォルト） · deep $0.50
check_address_risk_quick(address)	quick tier に固定した同じチェックです	$0.02
check_address_risk_standard(address)	standard tier に固定した同じチェックです	$0.10
check_address_risk_deep(address)	deep tier に固定した同じチェックです	$0.50
check_address_risk_lite(address)	最安のチェックです。safe と判定することはありません（Lite を参照）	$0.01
get_pricing()	現在の料金（lite は専用の lite フィールド）、価格上限、ウォレットの公開アドレスを返します	無料

check_address_risk は tier 引数を受け取りますが、x402 クライアントが提示された最初の料金を常に支払うエージェントフレームワークでは、指定した tier に関係なく quick の料金を支払うことになります。3 つの check_address_risk_<tier> ツールを使えば、この問題を避けられます。それぞれ Verdix の単一 tier エンドポイント（/risk/address/<tier>）を呼び出し、料金を 1 つだけ提示するため、どの x402 クライアントでもツール名に示された tier の料金を支払います。クライアントにとって使いやすい方を選んでください。どちらも同じリスクチェックを行います。

Lite（$0.01、「safe」にはなりません）

check_address_risk_lite は最安のチェックで、よく知らないアドレスに USDC を送る前の簡易スクリーニングを目的としています。/risk/address/lite を呼び出し、OFAC 制裁対象、詐欺・フィッシングのリスト、アドレスポイズニングに使われる類似アドレス、バーンアドレス、フィッシングトークン、フラグが付いたコントラクトのデプロイヤーをチェックします。アドレスの経過年数と、注意判定のみを行うコントラクトチェックは省略されます。

判定は no_known_risk、caution、danger のいずれかで、safe になることはありません。no_known_risk は、そのアドレスがこれらのリストのいずれにも載っていないという意味にすぎません。安全との判定ではありません。safe が必要な場合（たとえば、高額送金の前）は、check_address_risk_quick（$0.02）を使用してください。応答には limited_checks: true、checks_performed、not_checked、full_check も含まれます。get_pricing は従来どおり tiers に quick／standard／deep を、別の lite フィールドに lite の料金を表示します。

必要なもの

• Node.js 18 以降（npx 経由で実行するため、インストールは不要です）。
• USDC を少額保有している Base ウォレット。 x402 の支払いはご自身が署名し、決済ファシリテーターがオンチェーンで決済するため、ガス代用の ETH は不要です。エージェントにはメインウォレットではなく、少額（数ドル程度）の残高を入れた専用ウォレットを使用してください。

安全性

• キーはお使いのマシンから外に出ません。 このサーバーの環境から読み込まれ、各支払いへの署名にローカルでのみ使用されます。Verdix やその他の場所に送信されることはなく、ログにも記録されません。
• 価格上限。 VERDIX_MAX_PRICE_USD（デフォルトは 0.10。lite、quick、standard に十分な金額）は、1 回の呼び出しにかかる費用の上限です。上限を超える呼び出しは、何も署名される前に拒否されます。deep ティアを利用するには、値を 0.50 に設定してください。
• Base メインネット上の USDC のみ。 その他の資産やネットワークは拒否されます。
• 完全な回答に対してのみ支払います。 Verdix がチェックを完了できない場合（データソースが停止している場合）は、503 を返し、支払いは決済されません。

セットアップ

0xYOUR_PRIVATE_KEY を専用の Base ウォレットのキーに置き換えてください。

Claude Desktop：ワンクリック拡張機能

1. 最新リリースから verdix-mcp-<version>.mcpb をダウンロードします。
2. Claude Desktop で Settings → Extensions を開き、ファイルをドラッグして追加します。
3. Install をクリックし、ウォレットキーと価格上限を入力します。

キーは OS のキーチェーンに保存されます。Claude Desktop は独自の Node.js で拡張機能を実行するため、Node.js をインストールする必要はありません。

Claude Desktop：設定ファイル

Settings → Developer → Edit Config を開くと、claude_desktop_config.json が開きます。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

次を追加します。

{
  "mcpServers": {
    "verdix": {
      "command": "npx",
      "args": ["-y", "verdix-mcp"],
      "env": {
        "VERDIX_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY",
        "VERDIX_MAX_PRICE_USD": "0.10"
      }
    }
  }
}

その後、Claude Desktop を再起動します。

Cursor

同じブロックを ~/.cursor/mcp.json（すべてのプロジェクト）または .cursor/mcp.json （1 つのプロジェクト）に配置します。

{
  "mcpServers": {
    "verdix": {
      "command": "npx",
      "args": ["-y", "verdix-mcp"],
      "env": {
        "VERDIX_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY",
        "VERDIX_MAX_PRICE_USD": "0.10"
      }
    }
  }
}

キーを含むプロジェクト単位の .cursor/mcp.json をコミットしないでください。

Claude Code

claude mcp add verdix -e VERDIX_PRIVATE_KEY=0xYOUR_PRIVATE_KEY -e VERDIX_MAX_PRICE_USD=0.10 -- npx -y verdix-mcp

エージェントフレームワーク

stdio サーバーを起動できる MCP クライアントであれば、どれでも動作します。コマンドは npx -y verdix-mcp で、以下の環境変数を使用します。公式 MCP SDK を使った Python の例：

from mcp import StdioServerParameters

verdix = StdioServerParameters(
    command="npx",
    args=["-y", "verdix-mcp"],
    env={"VERDIX_PRIVATE_KEY": os.environ["AGENT_WALLET_KEY"], "VERDIX_MAX_PRICE_USD": "0.10"},
)

環境変数

変数	必須	デフォルト	説明
VERDIX_PRIVATE_KEY	有料チェックツールで必要	なし	Base ウォレットの秘密鍵（16 進数）。EVM_PRIVATE_KEY も使用できます
VERDIX_MAX_PRICE_USD	いいえ	0.10	1 回の呼び出しにかけられる上限額（USD）
VERDIX_API_URL	いいえ	https://api.verdixapi.com	別のデプロイ環境に対するテストにのみ使用

回答の例

check_address_risk は、Verdix の JSON を API が送信したとおりに返します。

{
  "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
  "chain": "base",
  "tier": "quick",
  "price_usd": 0.02,
  "risk_score": 5,
  "verdict": "safe",
  "reasons": [],
  "checked": ["ofac", "scam_lists", "poisoning_watch", "onchain_age", "contract_code", "burn_list", "provenance"],
  "as_of": "2026-09-26T13:15:10.524501+00:00"
}

• danger：制裁対象、既知の詐欺、エクスプロイトまたはフィッシングのアドレス、アドレスポイズニングによる類似アドレス、バーンアドレスなどです。資金を送らないでください。
• caution：安全と判断するには証拠が不十分です。たとえば、新しいアドレス、未検証のコントラクト、または利用できないデータソースがある場合です。送金する前にユーザーに確認してください。
• safe：すべてのチェックが実行され、問題は見つかりませんでした。
• no_known_risk（safe の代わりに lite のみで返されます）：lite のリストには該当するアドレスがありません。安全性を保証する判定ではありません。判定が必要な場合は quick を使用してください。

支払いのレシート（支払者、オンチェーントランザクション）は、ツールの結果の _meta 内、com.verdixapi/payment にあります。

トラブルシューティング

• 「No wallet configured」：このサーバーの env ブロックに VERDIX_PRIVATE_KEY が設定されていません。
• 「Refusing to pay: … above your cap」：VERDIX_MAX_PRICE_USD を引き上げるか、より安価なティアを使用してください（lite は $0.01 です）。
• 「Verdix did not accept the payment」：ウォレットの Base 上の USDC が不足している可能性があります。get_pricing を呼び出して、資金を入金するウォレットアドレスを確認してください。
• HTTP 503 の回答：データソースが停止していました。課金されていないので、後でもう一度お試しください。

ライセンス

MIT