x402 MCP Server

Pay-per-use APIs for AI agents. One npm install, automatic USDC micropayments on Base.

Tools

| Tool | Description | Price | |------|-------------|-------| | x402_network_info | List all APIs with pricing and health status | Free | | x402_screenshot | Capture any URL as a base64 image | $0.01 / capture | | x402_pdf_extract | Extract text from a PDF via URL | $0.01 / extraction | | x402_sentiment | Real-time sentiment analysis for a crypto coin | $0.01 / query | | x402_market_overview | Broad crypto market sentiment overview | $0.05 / query | | x402_intelligence | Multi-source crypto intelligence (CoinGecko, DeFiLlama, news, GitHub) | $0.10 / query | | x402_send_email | Send transactional emails via Resend | $0.01 / email | | x402_scrape_url | Scrape any URL and return structured markdown, links, tables, metadata | $0.02 / scrape | | x402_convert_file | Convert files: image resize/reformat, CSV to JSON, HTML to PDF | $0.02 / conversion | | x402_web_search | Search the web via Tavily with ranked results and optional AI answer | $0.01 / search | | x402_transcribe_audio | Transcribe audio files with auto language detection and word timestamps | $0.05 / transcription |

What's New in 1.1.0

Five new tools added to the network:

• Web Scraping — scrape any URL with JavaScript rendering support and SSRF protection
• File Conversion — resize images, convert CSV to JSON, or render HTML to PDF
• Web Search — Tavily-powered ranked search results with optional AI-synthesized answers
• Email Sending — transactional email via Resend with abuse rate limits
• Audio Transcription — speech-to-text via faster-whisper with auto language detection (30-120s latency)

Quick Start — Free Mode

No wallet or private key needed. Add the server to your MCP client config:

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "x402-mcp-server"]
    }
  }
}

Free mode limitations:

• Screenshots limited to example.com, example.org, and httpbin.org
• PDF extraction limited to first 3 pages
• Sentiment returns mock data with real market structure
• Email returns a fake message ID (no delivery)
• Scraping returns fixture data (no live scraping)
• File conversion returns fixture data (no live conversion)
• Web search returns fixture results (no live search)
• Transcription returns fixture transcript (no live transcription)

Quick Start — Paid Mode

Requires a Base wallet funded with USDC.

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "x402-mcp-server"],
      "env": {
        "X402_PRIVATE_KEY": "your-private-key-here"
      }
    }
  }
}

Never commit your private key. Store it in your system environment or a local .env file loaded by your shell.

You need USDC on the Base network. Base is an Ethereum L2 with low transaction fees. See the full wallet setup guide for detailed instructions.

MCP Client Configs

Omit the env block entirely for free mode.

Claude Desktop

Config file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "x402-mcp-server"],
      "env": {
        "X402_PRIVATE_KEY": "your-private-key-here"
      }
    }
  }
}

Claude Code

claude mcp add --transport stdio x402 -- npx -y x402-mcp-server

Then set X402_PRIVATE_KEY in your environment.

Cursor

Config file: ~/.cursor/mcp.json

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "x402-mcp-server"],
      "env": {
        "X402_PRIVATE_KEY": "your-private-key-here"
      }
    }
  }
}

Windsurf

Config file: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "x402-mcp-server"],
      "env": {
        "X402_PRIVATE_KEY": "your-private-key-here"
      }
    }
  }
}

How It Works

1. Your AI agent calls a tool (e.g., x402_screenshot)
2. The MCP server makes an HTTP request to the API
3. The API responds with 402 Payment Required
4. x402-fetch automatically signs a USDC payment on Base and retries
5. The API returns the result

The payment flow is handled by x402-fetch — your agent never needs to manage transactions directly.

License

MIT