x402-bazaar-mcp

An MCP (Model Context Protocol) server that exposes every paid API in the x402 Bazaar catalog as a callable tool for AI agents (Claude Desktop, Cursor, custom agents, etc.).

Each tool call is backed by an x402 micro-payment in USDC on Base — no API keys, no subscriptions, no sign-up. The agent pays only for what it uses, typically fractions of a cent per call.

How it works

1. On startup the server fetches the live catalog from https://402.com.tr/api/catalog and auto-registers one MCP tool per service.
2. When an AI agent calls a tool the server builds the request URL, hits the endpoint, and transparently handles the x402 payment flow: HTTP 402 → pay USDC on Base → retry → return response.
3. The agent wallet only needs USDC on Base. Gas is paid by the x402 facilitator — it is gasless for the payer.

First few calls per day per service may be served on the free tier at no cost; subsequent calls trigger micro-payments automatically.

Requirements

• Node.js ≥ 20
• A Base wallet private key whose address holds USDC on Base mainnet

Installation & running

# Install dependencies
npm install

# Run (set your private key in the environment)
AGENT_PRIVATE_KEY=0xYOUR_PRIVATE_KEY npx x402-bazaar-mcp

Or with npm start after cloning:

AGENT_PRIVATE_KEY=0xYOUR_PRIVATE_KEY npm start

Environment variables

Claude Desktop configuration

Add the following to your claude_desktop_config.json (usually ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "x402-bazaar": {
      "command": "npx",
      "args": ["-y", "x402-bazaar-mcp"],
      "env": {
        "AGENT_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}

After saving, restart Claude Desktop. You should see the Bazaar tools appear in the tool list (hammer icon).

Cursor / other MCP clients

Any MCP-compatible client that supports stdio servers works the same way — just point it at npx x402-bazaar-mcp with AGENT_PRIVATE_KEY in the environment.

Why agents use this

Agents need fresh on-chain data and AI utilities but don't want to manage RPC endpoints, scrapers, security heuristics, or per-provider API keys. One MCP server plus a funded wallet gives them everything — contract safety checks, live DEX prices, gas estimates, transaction decoding, and Claude-powered text utilities — all pay-per-use, with no subscriptions or sign-up required.

What your agent can do (tools)

Tools are loaded live from the catalog, so the list stays current. At the time of writing it includes:

... View full README on GitHub