WalletTriage

wallettriage-mcp

WalletTriage 用 MCP サーバーです。AI エージェント向けに、EVM ウォレットのエクスプロイトへのリアルタイムなエクスポージャーをチェックします。各クエリの支払いは、セッションキーでローカル署名される x402 経由（Base 上の USDC）です。サインアップも API キーもプロンプトも必要ありません。ステートレスで、あなたやクエリに関する情報は一切保存されません。

ツール

• check_address_risk（有料）— EVM アドレスのリアルタイムリスクを確認します。危険な ERC20 承認を、攻撃を受けているコントラクトのライブ脅威フィードと照合します。risk_score（0～100）、risk_level、実行可能な対応を含むfindingsを返します。
• get_pricing（無料）— サービスのステータスと現在のクエリごとの料金を確認します。

セットアップ（Claude Desktop、Claude Code、Cursor）

Node 20+ が必要です。MCP 設定に追加します（例：claude_desktop_config.json）。

{
  "mcpServers": {
    "wallettriage": {
      "command": "npx",
      "args": ["-y", "wallettriage-mcp"],
      "env": {
        "GATEWAY_URL": "https://api.wallettriage.com",
        "EVM_PRIVATE_KEY": "0xREPLACE_WITH_SESSION_WALLET_PRIVATE_KEY",
        "MAX_PAYMENT_ATOMIC": "100000"
      }
    }
  }
}

Base 上の USDC を数枚、セッションウォレットに入金します。専用の低残高ウォレットを使用してください。メインキーは絶対に使用しないでください。 このウォレットが署名するのは、ガスレスの EIP-3009 USDC 決済のみです。WalletTriage が資金を保有したり移動したりすることはありません。

EVM_PRIVATE_KEY はウォレットの秘密鍵（0x + 64 桁の 16 進数）であり、アドレスではありません。ETH は不要です。決済はガスレス（EIP-3009）です。入金する前に、まず無料のget_pricingツールで接続を確認してください。

次に、エージェントに「0xd8dA…とやり取りする前に、リスクを確認して」と尋ねます。

トラブルシューティング

• unable to verify the first certificate（Windows／企業ネットワークでよく発生）：ウイルス対策ソフトまたはプロキシが TLS を傍受しています。Node はデフォルトではシステムの証明書ストアを使用しません。envブロックに"NODE_OPTIONS": "--use-system-ca"を追加してください。TLS 検証は絶対に無効にしないでください。決済情報はヘッダーで送信されるため、改ざんされないようにする必要があります。
• EVM_PRIVATE_KEY is malformed：値は0x + 64 桁の 16 進数（セッションウォレットの秘密鍵）である必要があります。プレースホルダーのテキスト、0xの欠落、余分な空白がないか確認してください。
• Gateway unreachable：GATEWAY_URLのデフォルト値はhttps://api.wallettriage.comです。値を上書きした場合（例：ローカルゲートウェイを指定した場合）、そのホストに到達でき、稼働していることを確認してください。

環境変数

変数	必須	デフォルト	用途
EVM_PRIVATE_KEY	はい	—	x402 決済（Base 上の USDC）に署名するセッションキー
GATEWAY_URL	いいえ	https://api.wallettriage.com	WalletTriage API のベース URL。本番環境がデフォルトです。ローカル開発ではhttp://localhost:4021を設定します（ローカル以外のホストでは HTTPS が必須です）
MAX_PAYMENT_ATOMIC	いいえ	100000（US$0.10）	この上限を超える 402 要求を拒否します（USDC の最小単位、6 桁の小数）
DEFAULT_SCAN_CHAIN	いいえ	eth	デフォルトのチェーン：eth、base、polygon、arbitrum、optimism、bsc

ローカル開発

npm install
cp .env.example .env   # set EVM_PRIVATE_KEY
npm start              # runs src/server.ts via tsx (stdio)

GATEWAY_URL=http://localhost:4021を指定してローカルゲートウェイに接続するか、MCP Inspector でテストします。

npx @modelcontextprotocol/inspector npx tsx src/server.ts

npm run buildを実行すると、公開されるbinであるdist/server.jsが生成されます。