Verdix address risk

verdix-mcp：在 Agent 转账前检查地址

一个 MCP 服务，可让你的 AI Agent 在向某个 EVM 地址转账或批准合约之前，先检查该地址在 Base 上的风险。它会调用 Verdix，并返回 safe、caution 或 danger，以及相应原因。它会检查：

• OFAC 制裁名单
• 诈骗、网络钓鱼和漏洞利用名单
• 地址投毒相似地址，数据来自对 Base 上每笔代币转账的实时监控
• 合约年龄、代码和来源
• 销毁地址

每次检查都通过 x402 使用你自己的钱包在 Base 上以 USDC 付费。无需账户、API 密钥或订阅。你的密钥绝不会离开你的设备，并且会在签名前强制执行价格上限。

“向 0x4c3f…9e21 转账 50 USDC”：Agent 会先调用 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 参数，但如果某个 Agent 框架的 x402 客户端总是支付第一个提供的价格，那么无论它请求什么 tier，最终都会支付 quick 的费用。三个 check_address_risk_<tier> 工具可以避免这个问题：每个工具都会调用 Verdix 的单 tier 端点 （/risk/address/<tier>），该端点只提供一个价格，因此任何 x402 客户端都会支付与工具名称对应 tier 的费用。选择更适合你客户端的方式即可； 两种方式都会执行相同的风险检查。

Lite（$0.01，绝不返回“safe”）

check_address_risk_lite 是最便宜的检查，适用于向不熟悉的地址发送 USDC 前快速筛查。它会调用 /risk/address/lite，检查 OFAC 制裁名单、诈骗和网络钓鱼名单、 地址投毒相似地址、销毁地址、钓鱼代币以及被标记的合约部署者。它会跳过地址年龄和仅用于判定 caution 的合约检查。

它的判定结果为 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 钱包。 无需 ETH 支付 gas：x402 付款由你签名，并由支付服务商在链上结算。请为你的 Agent 使用一个余额较少的专用钱包（几美元即可），而不是主钱包。

安全

• 你的密钥保留在本机。 系统会从此服务的环境中读取密钥，并仅在本地用于签署每笔付款。密钥绝不会发送给 Verdix 或任何其他地方，也不会被记录。
• 价格上限。 VERDIX_MAX_PRICE_USD（默认值为 0.10，足以支付 lite、quick 和 standard）是单次调用的最高费用。超过上限的调用会在签署任何内容之前被拒绝。若要使用 deep 层级，请将其设为 0.50。
• 仅支持 Base 主网上的 USDC。 任何其他资产或网络都会被拒绝。
• 只有获得完整答复才会收费。 如果 Verdix 无法完成检查（例如数据源不可用），会返回 503，且不会结算付款。

设置

将 0xYOUR_PRIVATE_KEY 替换为你的专用 Base 钱包密钥。

Claude Desktop：一键扩展

1. 从最新版本下载 verdix-mcp-<version>.mcpb。
2. 在 Claude Desktop 中，打开设置 → 扩展，然后将文件拖入。
3. 点击安装，然后输入钱包密钥和价格上限。

密钥会存储在操作系统的钥匙串中。无需安装 Node.js，因为 Claude Desktop 会使用自带的 Node.js 运行扩展。

Claude Desktop：配置文件

打开设置 → 开发者 → 编辑配置，这会打开 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 （单个项目）：

{
  "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

Agent 框架

任何能够启动 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 钱包私钥（十六进制）。也接受 EVM_PRIVATE_KEY
VERDIX_MAX_PRICE_USD	否	0.10	单次调用的最高费用，单位为美元
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（仅限 lite，用于替代 safe）：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