Back to MCP Servers

Awesome X402

Curated directory of x402 payment protocol resources, MCP servers, and tools for HTTP 402-based USDC payments on Base, Arbitrum, and other EVM chains.

finance-fintechai
By xpaysh
274757Updated 1 week agoCC0-1.0

Installation

npx -y awesome-x402

Configuration

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

How to use

  1. Run the installation command above (if needed)
  2. Open your Claude Code settings file (~/.claude/settings.json)
  3. Add the configuration to the mcpServers section
  4. Restart Claude Code to apply changes

Awesome X402 Awesome

⚑ The Ultimate x402 Resource Hub - Everythng you need to build internet-native payments using HTTP 402. Perfect for AI agents, APIs, and micropayments. Build paywalls, monetize services, and enable autonomous agent payments with crypto/USDC. Zero fees, 2-second settlement.

GitHub stars

Contents

The x402 protocol enables instant Blockchain payments over HTTP using the 402 "Payment Required" status code. This is your complete guide to mastering x402 and building the future of agent payments.

πŸš€ Start building in 5 minutes | ⚑ 2-second settlement | πŸ’° USDC on Base


🎯 Quick Start - Become an x402 Champion

New to x402? Follow this path to mastery:

  1. 5-Minute Quickstart - Accept your first payment.
  2. Choose Your Stack - Find your language/framework.
  3. Copy an Example - Working code you can run immediately.
  4. Join the Community - Get help from other builders.

For AI Agents: Start with MCP Integration to enable Claude/other agents to make autonomous payments.


πŸ“š Official Resources

Core resources from the x402 protocol maintainers.

πŸ“– Protocol Documentation

Essential documentation for understanding and implementing x402.

πŸš€ Quickstart Guides

Get started with x402 in minutes.

βš™οΈ Protocol Implementations

Official and community implementations of the x402 protocol.

Go

  • coinbase/x402 ⭐ Official - Complete Go implementation.
    • Core protocol types and utilities
    • Payment verification and settlement logic
    • Multi-chain support (Base, Base Sepolia, Ethereum, Solana)

TypeScript/JavaScript

  • x402-typescript ⭐ Official - Complete TypeScript implementation.

    • Core protocol types and utilities
    • Payment verification and settlement logic
    • Multi-chain support (Base, Base Sepolia, Ethereum, Solana)
  • x402-data-api - HTTP 402 micro-payment data API with Base chain USDC payments. 16 developer data tools including email validation, DNS lookup, WHOIS, SSL check, and IP geolocation with x402 payment integration.

  • x402-express - Express.js middleware example.

  • hive-rosetta ⭐ Community - Open EIP-3009 transferWithAuthorization signer. Zero ethers/web3 dependency, primitives-only EIP-712. Returns wire shape {scheme: 'exact', network: 'eip155:8453', payload: {authorization, signature}}. Same package name on PyPI. (GitHub)

Python

  • x402 ⭐ Official - Python SDK on PyPI.

    • FastAPI middleware integration
    • Requests session with auto-payments
    • Payment requirement generation
  • ag402 ⭐ Community - Payment layer for AI agents using x402. Wrap any API or MCP server with a USDC paywall (ag402 serve), or let agents auto-pay (ag402 run). Solana USDC, ~0.5s settlement, non-custodial, 648+ tests. Glama

  • x402-pay - Call any x402 API with one API key. Routes requests through a broker that handles on-chain payment. httpx-based, optional wallet mode for direct payments. (GitHub)

  • hive-rosetta ⭐ Community - Direct port of the Node hive-rosetta signer. Byte-identical EIP-712 digest across both languages. Returns {scheme, network, payload} matching CDP /verify and /settle. (GitHub)

Rust

  • x402-rs ⭐ Community - Production-grade Rust implementation.
    • Axum middleware
    • Reqwest client wrapper
    • Self-hostable facilitator
    • Multi-chain support
  • x402-axum - Axum web framework integration.
  • x402-reqwest - Reqwest HTTP client wrapper.

🏭 Production Implementations

Real companies using x402 in production with proven scale and transaction volumes.

  • AfaAgent x402 API Suite - 43 production-grade x402 APIs (DeFi, wallet security, AI/ML, developer tools, SEO) with pay-per-call USDC micropayments on Base. Includes MCP server with 43 tools (Streamable HTTP), OpenAPI 3.0 spec, llms.txt, and agents.json for AI-agent discovery. Premium services up to .99/call. (Discovery | MCP | GitHub)
  • Langston Search - Autonomous AI agent's pay-per-query web search API (Brave, falls back to SerpAPI), live on Solana mainnet. 0.02 USDC per query via x402 exact scheme. (Discovery)

High-Volume Production Deployments

  • Kaisha β€” Japan Company Registry API - Official-registry data for all 5.76M Japanese corporations + 5.05M invoice registrations from National Tax Agency open data: resolve company names / corporate numbers (法人η•ͺ号) to registry records, verify Japan invoice registration numbers (適格請求書/T+13-digit) against the NTA dataset, and compute Japanese business days & national holidays. $0.002–$0.01 USDC per call on Base & Solana via CDP facilitator. No API keys. MCP: npx -y kaisha-mcp. (OpenAPI | llms.txt | Discovery | x402scan | npm | GitHub)

  • MoneyMachine x402 Suite - Agent-payable APIs on Base USDC: GigRadar (Superteam/r/forhire/HN/Freelancer gigs $0.15), LightHouse-lite web vitals ($0.12), DocClerk PDF field extract ($0.25), CrawlJudge ($0.03), Axe-lite a11y ($0.08), HTML scrape ($0.05). Self-facilitator, open source. PayTo 0x5Cc3c4E5020Ec3D81E392658eFe7b27966872CE7.

  • J-sey Data API - Pay-per-call data API on Base with 18 endpoints for wallet lookups, web scraping, crypto prices, and DeFi yields; $0.002 per call via x402.

  • Fleet x402 Microservices - Two agent-payable AI services on Base: SEO Audit ($0.05 USDC) and Competitive Intel Pack ($0.50 USDC). Instant response, zero auth required, machine-readable JSON. (Discovery)

  • Arch Tools - 58 production API tools for AI agents with x402 payments built in. Web scraping, AI generation, crypto data, OCR, browser automation, MCP compatible. Patent-pending agent auth. 15+ chains supported. (GitHub)

  • Bounty API - Agent-native API marketplace with x402 micropayments. 7 live endpoints. Free + paid ($0.005-0.01 USDC on Base). MCP: npx bountyapi-mcp. Verified on-chain. (GitHub: vncent786/bounty-api)

  • PayAPI Market - First marketplace for x402-powered APIs. 10 APIs, 65 endpoints: UK property data, email verification, company enrichment, postcode lookup, currency/crypto rates, screenshots, DNS intelligence, web scraping, IP geolocation, QR codes. $0.001–$0.01 USDC on Base per request. MCP server discovery. ([GitHub](https://github.com/chetparker/x402-m

…

View source on GitHub