# x402 economy tools

Отдаёт агенту измеренные данные об экосистеме x402: какие эндпоинты реально принимают оплату и кто зарабатывает. Пригодится, если вы платите за вызовы или продаёте их.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: clankerceo
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/clankerceo/x402-tools
- Обновлён: 2026-09-09
- HTML: https://affpapa.org/nevibecode/mcp/x402-economy-tools

## Что делает

Сервер поднимается по адресу `https://multichain-rpc.clankerceo.workers.dev/mcp` и отдаёт 6 инструментов. Пять из них бесплатны и не требуют ключа API, шестой рассчитывается за вызов через x402. Данные собраны не опросом «есть ли ответ 402», а реальной оплатой мерчантам в USDC — это разные вопросы с разными ответами.

Что внутри: слепой перебор GET показал 1 рабочий эндпоинт из 60, а вызов по объявленным в самом эндпоинте `method` и `queryParams` — 8 из 60. Половина рабочих принимает только POST, поэтому для GET-переписей они невидимы. Ещё 66.7% живых эндпоинтов кладут платёжный запрос только в base64-заголовок `payment-required`, а тело отдают пустым `{}` — парсеры, которые смотрят сначала в тело, недосчитывают примерно две трети. Отдельно лежит ловушка подсчёта: `payto_tx_30d` в выгрузках реестра относится к кошельку и повторяется в каждой строке с тем же `payTo`, поэтому агрегировать без дедупликации по `payment.pay_to` нельзя.

Есть и практические грабли. Полезная нагрузка x402 v2 требует поля `accepted` с тем предложением, которое выбрал покупатель: без него CDP отвечает `x402V2PaymentPayload requires accepted`, а продавцы — `verification_failed`. Как продавец не доверяйте `accepted` — покупатель может подставить более дешёвое предложение, чем маршрут, который он вызывает.

## Требования
- Удалённый сервер: `https://multichain-rpc.clankerceo.workers.dev/mcp`

## Установка

### Claude Code (родная платформа)

**Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http x402-tools https://multichain-rpc.clankerceo.workers.dev/mcp
```

### Codex

**Командой платформы: удалённый сервер**
```bash
codex mcp add x402-economy-tools --url https://multichain-rpc.clankerceo.workers.dev/mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "x402-economy-tools": {
            "url": "https://multichain-rpc.clankerceo.workers.dev/mcp"
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "x402-economy-tools": {
            "type": "http",
            "url": "https://multichain-rpc.clankerceo.workers.dev/mcp"
        }
    }
}
```

### Gemini CLI

**Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http x402-economy-tools https://multichain-rpc.clankerceo.workers.dev/mcp
```

## Когда брать
- проверить, примет ли эндпоинт оплату, до первого платежа
- найти x402-мерчантов, которые действительно рассчитываются
- посчитать выручку по кошелькам без двойного счёта
- разобрать платёжный запрос из заголовка, а не из тела
- проверить MCP-сервер на обработку ошибок и совместимость с клиентами

## Примеры запросов агенту
- Прогони preflight по этому эндпоинту и скажи, примет ли он оплату
- Собери список x402-мерчантов с подтверждённым расчётом и ценой за вызов
- Проверь MCP-сервер на ошибки и поведение реальных клиентов

## Похожие
- [x402 Universal Payer](https://affpapa.org/nevibecode/mcp/x402-universal-payer.md) — MCP-сервер · ★ 250
- [x402 Wallet](https://affpapa.org/nevibecode/mcp/x402-wallet.md) — MCP-сервер · ★ 250
- [mcp-x402](https://affpapa.org/nevibecode/mcp/mcp-x402.md) — MCP-сервер · ★ 274
- [x402](https://affpapa.org/nevibecode/skills/starchild-x402.md) — скилл · 1200 установок
- [x402-payments](https://affpapa.org/nevibecode/skills/x402-payments.md) — скилл · 462 установки
- [x402-list-mcp](https://affpapa.org/nevibecode/mcp/x402-list-mcp.md) — MCP-сервер · ★ 26

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md