X402 MCP server

by x402node·io.github.x402node/x402-mcp·v1.0.4·1 stars

No reviews yet

Hundreds of x402-paid APIs as MCP tools, auto-discovered from Coinbase Bazaar. USDC on Base+Solana.

B77/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B77/100

full report

Adoption

New

1 stars27 downloads/wk

Reviews

Write one

Nobody has reviewed X402 yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

X402 tools

No tool declarations could be read from the package source. They show once the server is installed.

Public scan report

scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it

no findings

Code scan3 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitystatic API keys via environment variables6/15
Maintenancelast push 69 days ago12/15
Maintainer identityregistry namespace matches repository owner7/10

Overall 77/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How X402 compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 77/100; higher than 50% of 48,255 servers
GitHub stars: 1; more than 65% of 28,688 servers
Downloads a week: 27; more than 14% of 12,191 servers with a package

Install X402 in Claude Code, Cursor or VS Code

Runs npx -y x402node-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add x402-mcp -- npx -y x402node-mcp

Add to Cursor

What the publisher says

From the X402 repository's README, as published. We do not edit it. Read it on GitHub

x402-mcp

MCP server bringing hundreds of x402-paid APIs to AI agents (Claude, Cursor, MCP-aware clients). Auto-discovers tools from CDP Bazaar; handles USDC micropayments on Base + Solana.

Features

Auto-discovers x402 endpoints from CDP Bazaar (no hard-coded list)
Reads metadata directly from Bazaar (description, schema, pricing)
Refreshes every 5 min — new endpoints appear without restart
Handles HTTP 402 + USDC payment automatically
Multi-chain: Base + Solana mainnet live (USDC on both); Polygon/BNB/EVM expandable

Install (Claude Desktop)

Add to claudedesktopconfig.json:

{
  "mcpServers": {
    "x402-mcp": {
      "command": "npx",
      "args": ["-y", "x402node-mcp"],
      "env": { "X402_PRIVATE_KEY": "0xYOUR_BASE_PRIVATE_KEY" }
    }
  }
}

Set X402PRIVATEKEY to a Base EOA private key (hex, 0x-prefixed) with USDC on Base mainnet (Solana payment via SPL USDC also supported). Restart Claude Desktop. The server auto-discovers ~117 tools on first run.

Cost Safety

Each tool call costs $0.0001-$0.10 USDC depending on endpoint
Hard cap: MAXPRICEUSD env var (default $0.10/call); calls above are blocked
Use a fresh burner wallet, not your main wallet

How it works

Agent calls tool -> HTTP 402 -> x402-fetch signs EIP-3009 -> CDP Facilitator settles on Base or Solana -> response returned. Buyer pays no gas.

Development

git clone https://github.com/x402node/x402-mcp
cd x402-mcp
npm install
cp .env.example .env  # edit X402_PRIVATE_KEY
node mcp-server.js

License

MIT

Nothing above is checked by us. What we check is on the safety report.

X402: common questions

Is X402 MCP server safe?: Mostly: it is graded B (77/100). Read the X402 safety report
How do I install X402?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does X402 need an API key?: Yes. The registry entry asks for X402_PRIVATE_KEY.
Is X402 maintained?: The last commit was 109 days ago (2026-07-18). The latest release is v1.0.4.
How does X402 compare with other MCP servers?: safety score 77/100 (higher than 50% of 48,255 servers); github stars 1 (more than 65% of 28,688 servers); downloads a week 27 (more than 14% of 12,191 servers with a package). Full comparison.