Skip to main content
MCP server CX Codex

x402check — Claude Code MCP server: what it does, setup

The x402check MCP server checks a payee before an agent pays, allowing payment for an x402 resource only after the recipient passes review.

MIT ★ 12 updated 2026-10-24

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add --env X402CHECK_CREDIT_TOKEN=<X402CHECK_CREDIT_TOKEN> --env X402CHECK_PAYER_KEY=<X402CHECK_PAYER_KEY> --env X402CHECK_BUDGET_USD=<X402CHECK_BUDGET_USD> --env X402CHECK_PINNED_KEYS=<X402CHECK_PINNED_KEYS> --env X402CHECK_MAX_PAYMENT_USD=<X402CHECK_MAX_PAYMENT_USD> --transport stdio mcp -- npx -y @x402check/mcp
Open on GitHub

What x402check does

x402check puts a risk decision before an agent’s payment. Its check returns allow, warn, block, or not_verified; the payment tool checks the exact recipient immediately before signing. A warning requires user approval, while blocked or unverified results produce no signature.

The stdio server exposes x402check_check, x402check_pay, x402check_verify_attestation, and x402check_methodology. These tools cover counterparty checks, gated access to paid x402 resources, attestation validation, and the service’s checking rules and prices. Run it with npx -y @x402check/mcp.

Checks are paid: credits charge $0.001, or $0.005 when a transaction simulation is included. Configure X402CHECK_CREDIT_TOKEN or X402CHECK_PAYER_KEY; with neither variable, checks return not_verified. The server requires Node.js 22 or later.

What it helps with

  • screen a counterparty before payment
  • stop a transfer when the result is block
  • gate access to a paid x402 resource
  • validate an attestation before using its result

Example prompts for the agent

  • Use x402check_check to review the recipient of this payment and report the findings.
  • Fetch this paid resource with x402check_pay; sign only after the payee is cleared.
  • Run x402check_verify_attestation for the exact request before trusting the verdict.

How to install x402check

Platform CLI

claude mcp add --env X402CHECK_CREDIT_TOKEN=<X402CHECK_CREDIT_TOKEN> --env X402CHECK_PAYER_KEY=<X402CHECK_PAYER_KEY> --env X402CHECK_BUDGET_USD=<X402CHECK_BUDGET_USD> --env X402CHECK_PINNED_KEYS=<X402CHECK_PINNED_KEYS> --env X402CHECK_MAX_PAYMENT_USD=<X402CHECK_MAX_PAYMENT_USD> --transport stdio mcp -- npx -y @x402check/mcp

Replace <…> with your own values

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about x402check

How do I install x402check in Claude Code?

Run: claude mcp add x402check -e X402CHECK_CREDIT_TOKEN=<X402CHECK_CREDIT_TOKEN> -e X402CHECK_PAYER_KEY=<X402CHECK_PAYER_KEY> -- npx -y @x402check/mcp

What does x402check do?

It evaluates a counterparty before an agent pays and returns allow, warn, block, or not_verified. Its payment tool checks the specific payee before signing an x402 transaction.

What does x402check require?

Use Node.js 22 or later plus either X402CHECK_CREDIT_TOKEN or X402CHECK_PAYER_KEY for paid checks. x402check_pay specifically requires X402CHECK_PAYER_KEY.

Similar MCP servers

All MCP servers for Security →

Project sponsors

Companies that keep this analytics open