Verdix address risk MCP server

verdix-mcp: check an address before your agent sends it money

An MCP server that lets your AI agent check an EVM address on Base before sending it funds or approving a contract. It calls Verdix, which answers safe, caution or danger with the reasons. It checks:

• OFAC sanctions
• scam, phishing and exploit lists
• address-poisoning lookalikes, built from a live watch of every token transfer on Base
• contract age, code and provenance
• burn addresses

Each check is paid per call in USDC on Base via x402, from your own wallet. There is no account, no API key and no subscription. Your key never leaves your machine, and a price cap is enforced before anything is signed.

"Send 50 USDC to 0x4c3f…9e21": the agent calls checkaddressrisk first,

gets "verdict": "danger", "reasons": ["address_poisoning"], and stops to ask you.

What you need

payments are signed by you and settled on-chain by the payment facilitator. Use a dedicated wallet with a small balance (a few dollars) for your agent, not your main wallet.

• Node.js 18 or newer (it runs through npx, so there's nothing to install).
• A Base wallet holding a little USDC. You don't need ETH for gas: x402

Safety

and used only to sign each payment locally. It is never sent to Verdix or anywhere else, and never logged.

• Your key stays on your machine. It is read from this server's environment

cost. A call above it is refused before anything is signed. To allow the deep tier, set it to 0.50.

• Price cap. VERDIXMAXPRICE_USD (default 0.10) is the most one call may

source is down), it answers 503 and the payment is not settled.

• Only USDC on Base mainnet. Any other asset or network is refused.
• You pay only for complete answers. If Verdix can't complete a check (a data

Setup

Replace 0xYOURPRIVATEKEY with the key of your dedicated Base wallet.

Claude Desktop: one-click extension

latest release.

1. Download verdix-mcp-.mcpb from the

1. In Claude Desktop, open Settings → Extensions and drag the file in.
2. Click Install, then enter your wallet key and price cap.

The key is stored in your OS keychain. Node.js doesn't need to be installed, because Claude Desktop runs the extension with its own Node.js.

Claude Desktop: config file

Open Settings → Developer → Edit Config, which opens claudedesktopconfig.json:

• macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
• Windows: %APPDATA%\Claude\claudedesktopconfig.json

Add:

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

Then restart Claude Desktop.

Cursor

Put the same block in ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

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

Shortened. The full README is on GitHub.