X402 Buyer

The universal buyer agent for the x402 economy.

An MCP server that lets Claude Desktop, Cursor, and Claude Code users discover, pay for, and call any x402 endpoint — automatically. Ask Claude a question, and it pays for the answer with USDC.

Discovery powered by Decixa (5,500+ verified x402 endpoints) with local registry fallback.

Install

Claude Desktop / Cursor

Add to your MCP config:

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

Requirements

• Node.js 18+
• AgentCash wallet set up and funded with USDC on Base

Tools

Tool	Description
x402_discover	Search for x402 endpoints — queries Decixa's 5,500+ verified APIs with local fallback
x402_call	Call any x402 endpoint with automatic USDC payment via AgentCash
x402_balance	Check your AgentCash wallet balance
x402_research	Multi-endpoint parallel research — calls 3-5 endpoints simultaneously

How It Works

1. You ask Claude a question ("Is stripe.com secure?")
2. x402_discover searches Decixa + local registry for matching endpoints
3. x402_call pays the endpoint in USDC on Base via AgentCash
4. Data comes back, Claude synthesizes the answer

The local registry includes 8 Alderpost intelligence endpoints backed by premium sources (VirusTotal, People Data Labs, Hunter.io, AbuseIPDB, Qualys SSL Labs, NIH RxNorm, US Census, ESPN, The Odds API). Decixa extends discovery to the full x402 ecosystem.

Discovery Architecture

Primary: Decixa /api/agent/resolve — semantic search across 5,500+ verified x402 endpoints, ranked by latency, price, trust score, and capability match.

Fallback: Local registry of 8 curated Alderpost endpoints with full metadata. Used automatically if Decixa is unreachable.

This "soft swap" pattern means discovery always works, even if the network is down.

Local Registry Endpoints

Endpoint	Price	Premium Sources
Domain Shield	$0.12	VirusTotal (70+ engines)
Company X-Ray	$0.15	People Data Labs, Hunter.io
Threat Pulse	$0.10	VirusTotal, AbuseIPDB
Compliance Check	$0.15	Qualys SSL Labs
Prospect IQ	$0.12	People Data Labs, Hunter.io
Sports Edge	$0.12	ESPN, The Odds API, Claude AI
Property Intel	$0.10	US Census, OpenWeather
Health Signal	$0.10	NIH RxNorm, FDA

Changelog

v2.0.0

• Decixa integration — discovery now queries Decixa's /api/agent/resolve API as primary source, with local registry as fallback (soft swap pattern).
• x402_discover returns results from the entire x402 ecosystem, not just Alderpost endpoints.
• Added capability mapping from natural language queries to Decixa's verb-based taxonomy.
• Updated tool descriptions to reflect ecosystem-wide discovery.
• First integration partner credit from Decixa.

v1.0.5

• Fixed npm bin entry and ESM module configuration.
• CLI moved to root cli.js.

v1.0.0

• Initial release with 4 tools and 8 Alderpost endpoints.

Credits

• Discovery: Decixa — the decision layer for AI agents
• Payment: AgentCash — USDC wallets for AI agents
• Intelligence: Alderpost — bundled intelligence APIs

Links

• Alderpost
• Decixa
• AgentCash
• GitHub

License

MIT — Alderpost LLC