X402 Mcp

io.github.x402nodePublished by GitHub account x402nodev1.0.4Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyFinance Developer Tools

Server details

Identifier: io.github.x402node/x402-mcp
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account x402node for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.x402node%2Fx402-mcp.svg)](https://sourceweft.com/mcp/io.github.x402node%2Fx402-mcp?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Local MCP server that turns hundreds of x402-paid APIs discovered from Coinbase Bazaar into tools, paying per call in USDC on Base or Solana.

What you can do: Discover x402-paid API endpoints automatically from CDP Bazaar, with metadata such as description, schema and pricing, refreshed periodically without a restart (about 117 tools on first run). Call those endpoints as tools, with the server handling the HTTP 402 payment flow and settling USDC on Base or Solana. Enforce a per-call price cap so calls above the limit are blocked.
When to use it: Use it when you want an assistant to reach a broad catalog of pay-per-call APIs without configuring each one, and you are comfortable paying small USDC amounts per tool call from a dedicated wallet.
Requirements: Runs locally over stdio, typically via npx with Node.js. Requires the X402_PRIVATE_KEY environment variable: a 0x-prefixed Base EOA private key holding USDC on Base mainnet (SPL USDC on Solana also supported). Network access to Bazaar and the payment facilitator. Optional MAX_PRICE_USD caps the per-call price.

Before you install

The server needs a private key that can spend real USDC; the README advises a fresh burner wallet rather than a main wallet. Each tool call costs roughly $0.0001 to $0.10 USDC, and calls are paid automatically, so spending depends on how often the assistant invokes tools. Tool calls send requests to third-party x402 endpoints and payment data to the facilitator.

Installation

In SourceWeft

Open X402 Mcp in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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 claude_desktop_config.json:

json

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

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

Set X402_PRIVATE_KEY 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: MAX_PRICE_USD 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

bash

git clone https://github.com/x402node/x402-mcpcd x402-mcpnpm installcp .env.example .env  # edit X402_PRIVATE_KEYnode mcp-server.js

git clone https://github.com/x402node/x402-mcpcd x402-mcpnpm installcp .env.example .env  # edit X402_PRIVATE_KEYnode mcp-server.js

License

MIT

Source: README.md at commit e5cd11c

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v1.0.4LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts