# x402 economy tools

Feeds your agent measured x402 ecosystem data: which endpoints actually take payment and where the money goes. Useful if you pay per call or sell them.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: clankerceo
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/clankerceo/x402-tools
- Updated: 2026-09-09
- HTML: https://affpapa.org/en/nevibecode/mcp/x402-economy-tools

## What it does

The server runs at `https://multichain-rpc.clankerceo.workers.dev/mcp` and exposes 6 tools. Five are free and need no API key; the sixth settles per call through x402. The numbers come from paying merchants in USDC, not from checking whether an endpoint answers with HTTP 402. Those questions diverge sharply.

A blind GET sweep found 1 payable endpoint out of 60. Calling each one the way its own declared `method` and `queryParams` say to gave 8 out of 60. Half of the working ones accept POST only, so a GET-based sweep never sees them. Another 66.7% of live endpoints return an empty `{}` body and keep the payment challenge solely in the base64 `payment-required` header; parsers that read the body first undercount by roughly two thirds. There is a counting trap too: `payto_tx_30d` in registry exports is a wallet-level number repeated on every resource that shares a `payTo`, so aggregate only after deduplicating on `payment.pay_to`.

Some practical snags are documented as well. An x402 v2 payload needs an `accepted` field naming the offer the buyer picked; leave it out and CDP answers `x402V2PaymentPayload requires accepted` while sellers answer `verification_failed`. On the selling side, treat `accepted` as untrusted, because a buyer can echo a cheaper offer than the route being called.

## Requirements
- Remote server: `https://multichain-rpc.clankerceo.workers.dev/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http x402-tools https://multichain-rpc.clankerceo.workers.dev/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add x402-economy-tools --url https://multichain-rpc.clankerceo.workers.dev/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "x402-economy-tools": {
            "url": "https://multichain-rpc.clankerceo.workers.dev/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "x402-economy-tools": {
            "type": "http",
            "url": "https://multichain-rpc.clankerceo.workers.dev/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http x402-economy-tools https://multichain-rpc.clankerceo.workers.dev/mcp
```

## When to use it
- check whether an endpoint will take payment before sending one
- find x402 merchants that actually settle
- total revenue per wallet without double counting
- parse the payment challenge from the header instead of the body
- test an MCP server's error handling and real-client behaviour

## Example prompts
- Run preflight on this endpoint and tell me if it will take my money
- List x402 merchants with confirmed settlement and their price per call
- Check this MCP server for protocol errors and real-client behaviour

## Similar
- [x402 Universal Payer](https://affpapa.org/en/nevibecode/mcp/x402-universal-payer.md) — MCP server · ★ 250
- [x402 Wallet](https://affpapa.org/en/nevibecode/mcp/x402-wallet.md) — MCP server · ★ 250
- [mcp-x402](https://affpapa.org/en/nevibecode/mcp/mcp-x402.md) — MCP server · ★ 274
- [x402](https://affpapa.org/en/nevibecode/skills/starchild-x402.md) — skill · 1200 installs
- [x402-payments](https://affpapa.org/en/nevibecode/skills/x402-payments.md) — skill · 462 installs
- [x402-list-mcp](https://affpapa.org/en/nevibecode/mcp/x402-list-mcp.md) — MCP server · ★ 26

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md