Skip to content
MCP server

verify402

Free x402 preflight gate and paid on-chain checks before an agent signs a transaction

Runs locallyStatus and history
Pricing
Freemium
Platforms
CLI, API
Runs
Locally
Version
1.1.1
Listing updated
3 days ago

About verify402

verify402 is a freemium MCP server for security. It runs locally on your machine and is started by your AI client.

verify402 is a check between an agent's intent and its signature. The free preflight_gate takes an exact payment request or chain transaction and returns PASS, CAUTION or BLOCK with typed reasons, lists of what was and was not checked, and a receipt that expires after 90 seconds (the default). If sign_allowed is false the agent should not sign. The gate needs no wallet, account or API key.

Two more tools are free: inspect_402 reads a 402 challenge to show the price, token, network and payee, and directory_402 lists watched x402 endpoints. Five paid tools are fixed price at $0.03 to $0.10 per call: arbitrage verification, token sellability, best swap route, quote fairness and trade depth.

The published npm package defaults paid calls to Base Sepolia testnet USDC for the public demo; mainnet is an explicit opt-in not enabled by this release. Use a dedicated hot wallet, with MAX_PAYMENT_USD (default 0.25) and optional MAX_DAILY_USD caps. The bridge signs only the x402 payment, never a trade. The site says a PASS is a measurement, not a guarantee, and notes it has had no external buyers so far.

Install

Run in a terminal

claude mcp add verify402-mcp --env EVM_PRIVATE_KEY='<EVM_PRIVATE_KEY>' -- npx -y verify402-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "verify402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "verify402-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "verify402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "verify402-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "verify402-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "verify402-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "verify402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "verify402-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "verify402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "verify402-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>"
      }
    }
  }
}

Configuration

  • VERIFY402_URLverify402 base URL
  • EVM_PRIVATE_KEYPrivate key for a dedicated hot wallet. Omit for the free preflight_gate only. verify402-mcp@1.1.1 (this published release) defaults paid calls to Base Sepolia testnet (eip155:84532) for the public demo. Base mainnet (eip155:8453) is an explicit opt-in for a separate deployment and is not enabled by this release. Fund only Base Sepolia testnet USDC for the demo. Never use a main wallet.
  • VERIFY402_NETWORKSComma-separated EVM payment networks for paid calls. Default Base Sepolia testnet (eip155:84532); set eip155:8453 explicitly for Base mainnet. The supported network-to-canonical-asset map is constrained to Base Sepolia and Base mainnet.
  • MAX_PAYMENT_USDHard cap on one x402 payment in USD (default 0.25). Enforced before signing.
  • MAX_DAILY_USDOptional cap for total spend per UTC day across restarts.

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

preflight_gate
Free PASS/CAUTION/BLOCK verdict before signing a payment or transaction
inspect_402
Free read of what a 402 challenge asks for
directory_402
Free list of watched x402 endpoints
verify_arbitrage
Checks whether a cross-venue arbitrage is real
check_token_safety
Checks whether a token is sellable and round-trip cost
get_best_route
Best swap route and quoted venues
verify_quote_fairness
Rates an offered quote as fair, overpaying or too good to be true
get_trade_depth
Per-size impact and round-trip cost

What it does

Preflight gate
Free PASS, CAUTION or BLOCK verdict before signing, with a short-lived receipt.
402 inspection
Read what a 402 response actually asks for.
Paid on-chain checks
Five fixed-price checks from $0.03 to $0.10.
Spend caps
Per-payment and daily limits enforced before signing.
Testnet default
Paid calls use Base Sepolia USDC in the public demo.
Opt-in telemetry
Anonymous tool-name pings are off by default.

Good for

  • Block an agent from signing a payment to an unexpected host
  • Check if a token can be sold at a realistic size
  • Verify a broker's quoted price
  • Estimate trade depth before sizing an order
  • Review what an x402 endpoint demands before paying

Pricing

Freemium

Gate free; paid checks $0.03-$0.10 per call in testnet USDC

Prices change. Check verify402.onrender.com before you buy.

verify402 FAQ

Does PASS mean safe?

No. It means the listed checks passed at that block; notChecked shows the gaps.

Do I need a wallet?

Not for the free gate; paid tools need a dedicated hot wallet.

Does it send trades?

No. It returns a verdict and receipt only.

Is it mainnet?

Analysis reads mainnet data, but demo payments use Base Sepolia testnet USDC.

Is verify402 free?

verify402 has a free plan, with paid plans for more usage or features.

How do I add verify402 to Claude Code?

Run this command in your terminal: claude mcp add verify402-mcp --env EVM_PRIVATE_KEY='<EVM_PRIVATE_KEY>' -- npx -y verify402-mcp

What are the best alternatives to verify402?

The closest alternatives to verify402 are REA, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Agent Roast and Midplane.

Alternatives to verify402

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  5. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments