Skip to content
MCP server

x402check

Pre-payment risk checks for AI agents: screen a counterparty before x402 payments

Runs locallyStatus and history
Install
Pricing
Paid
Platforms
CLI, API
Runs
Locally
Version
0.3.3
Listing updated
2 days ago

About x402check

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

x402check lets an agent clear a payee before money moves. Each check screens the address against the OFAC SDN digital-currency list, phishing and drainer feeds, look-alike domains and on-chain facts, and can simulate the transaction. A typed model can also read content the agent acted on for injected instructions. Results come back as allow, warn, block or not_verified, with findings and a signed ES256 attestation that the server verifies against the issuer's did:web identity before the agent sees an action.

There is no free tier. Checks are paid from prepaid credits at $0.001 each ($0.005 when a transaction is simulated), or per call via x402 from a dedicated low-balance wallet, with a per-payment cap and a total budget. Without credentials, every check returns not_verified.

The site spells out limits: a clean verdict means none of the checks fired, not that the payee is safe, and unknown drainer addresses on no feed are not detected.

Install

Run in a terminal

claude mcp add x402check --env X402CHECK_CREDIT_TOKEN='<X402CHECK_CREDIT_TOKEN>' --env X402CHECK_PAYER_KEY='<X402CHECK_PAYER_KEY>' -- npx -y @x402check/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "x402check": {
      "command": "npx",
      "args": [
        "-y",
        "@x402check/mcp"
      ],
      "env": {
        "X402CHECK_CREDIT_TOKEN": "<X402CHECK_CREDIT_TOKEN>",
        "X402CHECK_PAYER_KEY": "<X402CHECK_PAYER_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "x402check": {
      "command": "npx",
      "args": [
        "-y",
        "@x402check/mcp"
      ],
      "env": {
        "X402CHECK_CREDIT_TOKEN": "<X402CHECK_CREDIT_TOKEN>",
        "X402CHECK_PAYER_KEY": "<X402CHECK_PAYER_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "x402check": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@x402check/mcp"
      ],
      "env": {
        "X402CHECK_CREDIT_TOKEN": "<X402CHECK_CREDIT_TOKEN>",
        "X402CHECK_PAYER_KEY": "<X402CHECK_PAYER_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "x402check": {
      "command": "npx",
      "args": [
        "-y",
        "@x402check/mcp"
      ],
      "env": {
        "X402CHECK_CREDIT_TOKEN": "<X402CHECK_CREDIT_TOKEN>",
        "X402CHECK_PAYER_KEY": "<X402CHECK_PAYER_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "x402check": {
      "command": "npx",
      "args": [
        "-y",
        "@x402check/mcp"
      ],
      "env": {
        "X402CHECK_CREDIT_TOKEN": "<X402CHECK_CREDIT_TOKEN>",
        "X402CHECK_PAYER_KEY": "<X402CHECK_PAYER_KEY>"
      }
    }
  }
}

Configuration

  • X402CHECK_CREDIT_TOKENPrepaid credit token (x402c_…, from POST https://x402check.xyz/v1/credits): $0.001 a check
  • X402CHECK_PAYER_KEYPrivate key of a dedicated low-balance wallet: pays the x402 resources x402check_pay clears, and per-call checks without credits
  • X402CHECK_BUDGET_USDSpend cap for this server process: the payer's spend (checks and resources), and separately what checks spend from prepaid credits
  • X402CHECK_PINNED_KEYSComma-separated RFC 7638 thumbprints of the attestation keys accepted (default: x402check's own keys, for its own issuer)
  • X402CHECK_MAX_PAYMENT_USDThe most a single payment may cost (a check or a resource)

Tools this server provides (4)

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

x402check_check
Risk-checks a counterparty and returns allow, warn, block or not_verified.
x402check_pay
Fetches an x402 resource and pays only if the payee is cleared.
x402check_verify_attestation
Verifies an x402check attestation without making a payment.
x402check_methodology
Explains what is checked, the price and the measured limits.

What it does

Signed attestations
Verdicts are ES256 JWS tokens that state which checks actually ran.
Sanctions and phishing screening
Checks OFAC SDN, MetaMask phishing and ScamSniffer drainer lists.
Transaction simulation
Simulates a transaction to see where assets end up.
Gated x402 payments
x402check_pay pays an x402 resource only after the payee is cleared.
Spend caps
Environment variables set a total budget and a maximum per payment.
Fail-closed behaviour
If the model or feeds are unavailable, the evidence says so instead of inventing a score.

Good for

  • Clear a payee before an agent pays an x402 API
  • Screen a wallet address against OFAC sanctions
  • Simulate a transaction before signing
  • Verify a previously issued attestation

Pricing

Paid

$0.001 per check with prepaid credits; $0.005 with simulation.

Prices change. Check x402check.xyz before you buy.

x402check FAQ

Is there a free tier?

No. Every check is paid, from credits or per call.

How much does a check cost?

$0.001 from prepaid credits, or $0.005 with transaction simulation; $0.0035 per call on Base via x402.

Does a clean result mean safe?

No. The site says it means none of the checks fired.

What runtime does it need?

Node.js 22 or later, run via npx -y @x402check/mcp.

Is x402check free?

No. x402check is a paid product.

How do I add x402check to Claude Code?

Run this command in your terminal: claude mcp add x402check --env X402CHECK_CREDIT_TOKEN='<X402CHECK_CREDIT_TOKEN>' --env X402CHECK_PAYER_KEY='<X402CHECK_PAYER_KEY>' -- npx -y @x402check/mcp

What are the best alternatives to x402check?

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

Alternatives to x402check

  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