v0.4.0 · live on npm

Give Claude
a wallet.

The first MCP server for the x402 payment protocol. Discover 959 verified live APIs, inspect costs, and pay them — all from Claude. No private key on your machine.

Get started View on GitHub

959

verified live APIs

MCP tools

$0.01

typical API call

private keys exposed

How it works

Claude finds what it needs

Browse 959 verified live APIs from Coinbase's Bazaar catalog — pre-tested and scored. Filter by keyword, network, or price.

discover_paid_services({ query: "weather", network: "base" })

Check the price before paying

Probe any x402 URL live and get a full cost breakdown — network, USDC amount, recipient address. No payment is made at this step.

estimate_payment({ resource_url: "https://..." })

Pay and call in one shot

Claude pays via your CDP Server Wallet and gets the real API response back. Signing happens in Coinbase's TEE — the private key never touches your machine.

make_x402_request({ resource_url: "https://...", max_cost_usdc: 0.05 })

Live catalog

959 verified live APIs, tested daily. Full catalog at x402mcp.app/catalog.json.

Weather

Current Weather

Real-time conditions, UV index, wind, humidity, and an actionable brief for any location.

Weather

16-Day Forecast

Daily high/low temps, precipitation probability, and wind for any lat/lon.

Finance

FX Rate + Convert

Live exchange rate and conversion for any currency pair. Returns converted amount and rate.

Finance

CPI / Inflation

US Consumer Price Index, monthly values with history. Seasonally adjusted.

Location

IP Geolocation

Country, region, city, ZIP, lat/lon, timezone, ISP, and ASN for any IP address.

Location

Air Quality (AQI)

Current AQI by US ZIP code. PM2.5, ozone readings, Good/Moderate/Unhealthy category.

Government

OFAC Sanctions Check

Sanctions and restricted-party screening for any name or entity. Returns SDN list match data.

Government

FDA Drug Alerts

FDA adverse event reports — reactions, suspect drugs, seriousness. Query by drug name.

Government

US Census Data

Population, median household income, and median age by ZIP code or county.

Government

Congress Bills

Recent Congressional bills — title, latest action, origin chamber, update date.

Identity

VIN Decode

Year, make, model, trim, body class, and drive type for any 17-character VIN.

Identity

Barcode / UPC Lookup

Product name, brand, ingredients, nutri-score, and nutrition facts for any barcode.

Install

claude_desktop_config.json

{ "mcpServers": { "x402": { "command": "npx", "args": ["@nullbuilds/x402-mcp"], "env": { "CDP_API_KEY_ID": "your-key-id", "CDP_API_KEY_SECRET": "your-key-secret", "CDP_WALLET_SECRET": "your-wallet-secret" } } } }

CDP credentials enable make_x402_request. All discovery tools work without them. Get credentials at portal.cdp.coinbase.com.

Tools

discover_paid_services read-only

Browse 959 verified live APIs from the curated catalog. Returns services sorted by score with cost, network, and URL.

querystringSearch by name or description (optional)

networkstringFilter by network: base, solana, ethereum (optional)

limitnumberResults to return (max 100, default 20) (optional)

offsetnumberPagination offset (optional)

get_service_details read-only

Get full payment requirements for a specific resource URL — all options, networks, and pricing.

resource_urlstringExact URL of the x402 resource

estimate_payment read-only

Probe a URL live and return its x402 payment requirements. No payment is made.

resource_urlstringURL to probe

methodGET|POSTHTTP method (default GET) (optional)

check_wallet_balance read-only

Check the USDC balance of any wallet address on Base. No private key required.

wallet_addressstring0x address or ENS name

make_x402_request requires CDP

Pay and call an x402-enabled API using your CDP wallet. Handles payment automatically. Returns the actual API response.

resource_urlstringURL of the x402 API to call

methodGET|POSTHTTP method (default GET) (optional)

bodystringJSON body for POST requests (optional)

max_cost_usdcnumberMax USDC to spend, default 1.0. Aborts if over limit. (optional)

get_my_wallet requires CDP

Return your x402-mcp CDP wallet address. Use this to find out where to send USDC before making paid API calls.

(no parameters)

get_payment_history read-only

Show your recent x402 payment history — what APIs you called, how much you paid, and whether each request succeeded.

limitnumberRecords to return (1-100, default 20) (optional)

Example

1. Find weather APIs

claude

discover_paid_services({ query: "weather", network: "base" })

Found 4 verified service(s): - x402-data-bazaar.vercel.app (Base, 0.005000 USDC) URL: https://x402-data-bazaar.vercel.app/api/weather/current Actionable weather decision brief for any location. - x402-data-bazaar.vercel.app (Base, 0.008000 USDC) URL: https://x402-data-bazaar.vercel.app/api/weather/forecast Daily forecast (1-16 days) for any lat/lon.

2. Check the cost first

claude

estimate_payment({ resource_url: "https://x402-data-bazaar.vercel.app/api/weather/current" })

Payment estimate for: https://x402-data-bazaar.vercel.app/api/weather/current Option 1 - Cost: 0.005000 USDC on Base - Recipient: 0x4a9f... - Timeout: 30s No payment was made. This is an estimate only.

3. Pay and call

claude

make_x402_request({ resource_url: "https://x402-data-bazaar.vercel.app/api/weather/current?q=San+Francisco", max_cost_usdc: 0.01 })

Success. Paid 0.005000 USDC from 0x7f3a... { "location": "San Francisco, CA", "temp_f": 62, "condition": "Partly Cloudy", "humidity": 74, "wind_mph": 12, "brief": "Cool and breezy. Light jacket recommended." }

Roadmap

v0.1 ✓ Discovery, estimation, balance check

v0.2 ✓ make_x402_request — pay and call via CDP Server Wallets

v0.3 ✓ Curated catalog — 959 verified live APIs, scored and ranked daily

v0.4 ✓ Payment history + wallet address lookup

v0.5 Spending limits, multi-chain, category browsing

Give Claudea wallet.

Give Claude
a wallet.