x402-list-mcp — MCP-сервер для Claude Code: обзор и запуск
Помогает агенту находить API с оплатой x402, сверять аптайм, расценки и объём расчётов в блокчейне перед отправкой монет.
claude mcp add --transport http x402-list-mcp https://mcp.x402-list.com/mcpЧто делает x402-list-mcp
Пакет работает как прямая прослойка к публичному JSON API каталога x402-list. Сервер не взаимодействует с базами данных, ничего не записывает в реестр и не хранит ключи шифрования.
Внутри находятся семь инструментов. Шесть из них бесплатные и отдают данные только для чтения. Они позволяют искать сервисы, смотреть расценки конечных точек и проверять историю сбоев. Седьмой инструмент (x402_assess_services) платный: 0.25 USDC в сети Base. Он лишь пересылает 402-челлендж. Подписывать платёж придётся самостоятельно на клиенте, потому что сервер не хранит приватных ключей и не переводит средства сам.
Подключиться можно к удалённому адресу по HTTP или запустить процесс локально через stdio. Для локального запуска на машине потребуется Node.js версии не ниже 20 и установленный npm.
Какие задачи решает
- найти сервисы с приёмом стейблкоинов по протоколу x402
- проверить аптайм и историю сбоев целевого API
- узнать ончейн-объём расчётов у конкретного фасилитатора
- отследить смену цен или адресов выплат в реестре
Примеры запросов агенту
- Проверь доступность и цены сервисов в каталоге x402 по запросу transcription.
- Найди наиболее стабильный сервис через x402_find_best_service.
- Покажи недавние изменения цен в x402_change_events за последние 30 дней.
Как установить x402-list-mcp
1Командой платформы: удалённый сервер
claude mcp add --transport http x402-list-mcp https://mcp.x402-list.com/mcp2Командой платформы
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Вместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
codex mcp add x402-list-mcp --url https://mcp.x402-list.com/mcp2Командой платформы
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Вместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"x402-list-mcp": {
"url": "https://mcp.x402-list.com/mcp"
}
}
}{
"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>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"x402-list-mcp": {
"type": "http",
"url": "https://mcp.x402-list.com/mcp"
}
}
}{
"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>"
}
}
}
}Вместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
gemini mcp add -t http x402-list-mcp https://mcp.x402-list.com/mcp2Командой платформы
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Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о x402-list-mcp
Как установить x402-list-mcp в Claude Code?
Выполните команду в терминале: claude mcp add --transport http x402-list-mcp https://mcp.x402-list.com/mcp. Сервер сразу подключится по протоколу HTTP.
Что делает x402-list-mcp?
Он открывает агенту доступ к каталогу сервисов с оплатой x402. Модель может проверять аптайм, расценки конечных точек и ончейн-статистику до отправки платежей.
Нужен ли приватный ключ для работы с платным инструментом?
Сервер не хранит кошельки и не подписывает транзакции. Для вызова x402_assess_services агент получает x402-челлендж, который нужно подписать на стороне клиента.