# x402-list-mcp

Помогает агенту находить API с оплатой x402, сверять аптайм, расценки и объём расчётов в блокчейне перед отправкой монет.

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

## Что делает

Пакет работает как прямая прослойка к публичному JSON API каталога x402-list. Сервер не взаимодействует с базами данных, ничего не записывает в реестр и не хранит ключи шифрования.

Внутри находятся семь инструментов. Шесть из них бесплатные и отдают данные только для чтения. Они позволяют искать сервисы, смотреть расценки конечных точек и проверять историю сбоев. Седьмой инструмент (`x402_assess_services`) платный: 0.25 USDC в сети Base. Он лишь пересылает 402-челлендж. Подписывать платёж придётся самостоятельно на клиенте, потому что сервер не хранит приватных ключей и не переводит средства сам.

Подключиться можно к удалённому адресу по HTTP или запустить процесс локально через stdio. Для локального запуска на машине потребуется Node.js версии не ниже 20 и установленный npm.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://mcp.x402-list.com/mcp`
- Переменные окружения: `X402_LIST_BASE_URL`, `X402_LIST_TIMEOUT_MS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http x402-list-mcp https://mcp.x402-list.com/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env X402_LIST_BASE_URL=<X402_LIST_BASE_URL> --env X402_LIST_TIMEOUT_MS=<X402_LIST_TIMEOUT_MS> --transport stdio x402-list-mcp -- npx -y x402-list-mcp
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add x402-list-mcp --url https://mcp.x402-list.com/mcp
```

2. **Командой платформы**
```bash
codex mcp add x402-list-mcp --env X402_LIST_BASE_URL=<X402_LIST_BASE_URL> --env X402_LIST_TIMEOUT_MS=<X402_LIST_TIMEOUT_MS> -- npx -y x402-list-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "x402-list-mcp": {
            "url": "https://mcp.x402-list.com/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "x402-list-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "x402-list-mcp"
            ],
            "env": {
                "X402_LIST_BASE_URL": "<X402_LIST_BASE_URL>",
                "X402_LIST_TIMEOUT_MS": "<X402_LIST_TIMEOUT_MS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "x402-list-mcp": {
            "type": "http",
            "url": "https://mcp.x402-list.com/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "x402-list-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "x402-list-mcp"
            ],
            "env": {
                "X402_LIST_BASE_URL": "<X402_LIST_BASE_URL>",
                "X402_LIST_TIMEOUT_MS": "<X402_LIST_TIMEOUT_MS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http x402-list-mcp https://mcp.x402-list.com/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e X402_LIST_BASE_URL=<X402_LIST_BASE_URL> -e X402_LIST_TIMEOUT_MS=<X402_LIST_TIMEOUT_MS> x402-list-mcp npx -y x402-list-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- найти сервисы с приёмом стейблкоинов по протоколу x402
- проверить аптайм и историю сбоев целевого API
- узнать ончейн-объём расчётов у конкретного фасилитатора
- отследить смену цен или адресов выплат в реестре

## Примеры запросов агенту
- Проверь доступность и цены сервисов в каталоге x402 по запросу transcription.
- Найди наиболее стабильный сервис через x402_find_best_service.
- Покажи недавние изменения цен в x402_change_events за последние 30 дней.

## Похожие
- [MCP Toolbox for Databases](https://affpapa.org/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP-сервер · ★ 16717
- [PostHog MCP Server](https://affpapa.org/nevibecode/mcp/posthog-mcp-server.md) — MCP-сервер · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/nevibecode/mcp/openwork-mcp-gateway.md) — MCP-сервер · ★ 24242
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18727
- [Nhost](https://affpapa.org/nevibecode/mcp/nhost.md) — MCP-сервер · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP-сервер · ★ 7506

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