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
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/mcpWhat 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_checkto 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_attestationfor 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/mcpReplace <…> with your own values
Platform CLI
codex mcp add mcp --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> -- npx -y @x402check/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@x402check/mcp"
],
"env": {
"X402CHECK_CREDIT_TOKEN": "<X402CHECK_CREDIT_TOKEN>",
"X402CHECK_PAYER_KEY": "<X402CHECK_PAYER_KEY>",
"X402CHECK_BUDGET_USD": "<X402CHECK_BUDGET_USD>",
"X402CHECK_PINNED_KEYS": "<X402CHECK_PINNED_KEYS>",
"X402CHECK_MAX_PAYMENT_USD": "<X402CHECK_MAX_PAYMENT_USD>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@x402check/mcp"
],
"env": {
"X402CHECK_CREDIT_TOKEN": "<X402CHECK_CREDIT_TOKEN>",
"X402CHECK_PAYER_KEY": "<X402CHECK_PAYER_KEY>",
"X402CHECK_BUDGET_USD": "<X402CHECK_BUDGET_USD>",
"X402CHECK_PINNED_KEYS": "<X402CHECK_PINNED_KEYS>",
"X402CHECK_MAX_PAYMENT_USD": "<X402CHECK_MAX_PAYMENT_USD>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e X402CHECK_CREDIT_TOKEN=<X402CHECK_CREDIT_TOKEN> -e X402CHECK_PAYER_KEY=<X402CHECK_PAYER_KEY> -e X402CHECK_BUDGET_USD=<X402CHECK_BUDGET_USD> -e X402CHECK_PINNED_KEYS=<X402CHECK_PINNED_KEYS> -e X402CHECK_MAX_PAYMENT_USD=<X402CHECK_MAX_PAYMENT_USD> mcp npx -y @x402check/mcpReplace <…> 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.