# verify402

> verify402 is a freemium MCP server for security. Free x402 preflight gate and paid on-chain checks before an agent signs a transaction. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://verify402.onrender.com
- **Repository:** https://github.com/a32116150-ctrl/verify402/tree/HEAD/mcp-bridge
- **MCP Registry name:** io.github.a32116150-ctrl/verify402-mcp
- **Categories:** security, finance and payments
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/verify402
