gold402-mcp

MCP-сервер поверх gold-402 — курируемого каталога x402, который ведёт 24K Labs. Даёт любому MCP-совместимому агенту (Claude, Cursor или чему угодно, говорящему на MCP) четыре инструмента для поиска x402-сервисов и для проверки эндпоинта до того, как он потратит на него деньги.

Статус: v0.1 — протестирован, упакован, ещё не опубликован. Работает через stdio.

Инструменты

Бесплатно и платно

Четыре из пяти инструментов бесплатны и останутся бесплатными — поиск, полки, поиск записей и живая проверка. Без ключа, без кошелька, без аккаунта.

gold402_verdict платный: $0.001 USDC на Base. Он единственный такой, и он покупает то, чего бесплатная проверка явно не даёт — человеческое суждение. Действительный 402 доказывает, что дверь работает; вердикт — это мейнтейнер, говорящий, что ресурс стоил денег незнакомца.

Этот сервер никогда не держит кошелёк и никогда не платит от вашего имени. Вызовите gold402_verdict один раз без payment_signature — и он вернёт декодированные x402-условия: цену, сеть, актив, payTo, таймаут. Подпишите их своим кошельком и вызовите снова с подписью. Деньги идут от вас к 24K Labs; этот процесс не участвует в пути.

gold402_check_endpoint — это проверка двери, которую выполняют мейнтейнеры, сделанная вызываемой. Она работает с эндпоинтами, которых нет в каталоге, и в этом суть: агент, собирающийся заплатить незнакомцу, может сначала спросить.

Related MCP server: Secant Agent Research

Что утверждают ответы, а чего не утверждают

Листинг означает, что мейнтейнер проверил ресурс и он корректно ответил на x402-запрос на момент проверки, и мы периодически перепроверяем. Это не аудит провайдера, не гарантия аптайма и не обещание, что любой вызов удастся. Действительный 402 доказывает, что дверь работает — но не то, что сервис выполняет свои обязательства. Каждый ответ несёт метку as_of и источник, из которого он получен.

Отсутствие в каталоге — не вердикт против сервиса. Это курируемый список, а не перепись.

Установка

uvx gold402-mcp            # no install step
pip install gold402-mcp    # then run: gold402-mcp

Из клона:

python3 -m venv .venv && ./.venv/bin/pip install -e .
./.venv/bin/gold402-mcp

Конфигурация клиента

Claude Desktop / Claude Code (claude_desktop_config.json или .mcp.json):

{
  "mcpServers": {
    "gold402": {
      "command": "uvx",
      "args": ["gold402-mcp"]
    }
  }
}

Предпочитаете pip? Установите его, затем используйте "command": "gold402-mcp" без аргументов.

Источник данных

https://24klabs.ai/directory.json — публичный, опубликованный, кэшируется 15 минут. Без ключа, без авторизации, без скрейпинга. Если запрос не удался, а кэшированная копия существует, отдаётся кэшированная копия, и её возраст раскрывается, а не скрывается.

Покрытие, заявленное прямо. Этот эндпоинт — намеренный превью: он несёт полную структуру полок и реальные количества по полкам, но только самые недавно добавленные записи как записи. 24K Labs не отдаёт полный набор оптом анонимным вызывающим (почему). Поэтому этот сервер не подразумевает того, чего у него нет:

• каждый ответ сообщает и курируемый итог, и сколько записей было реально просмотрено;

• полка без превью-записей сообщается как ограничение покрытия, а не как пустая или несуществующая полка;

• для всего, что вне превью: просмотрите https://24klabs.ai/directory, найдите один ресурс по /api/v1/verify?resource=<url> или используйте gold402_check_endpoint, который работает с любым эндпоинтом, включён ли он в каталог или нет.

Тесты

./.venv/bin/python test_tools.py    # tool-level, incl. error paths
./.venv/bin/python test_stdio.py    # end-to-end over the real MCP protocol

Оба проходят по состоянию на 2026-08-20, в том числе против установленного консольного скрипта (чистое venv, pip install из собранного колеса) — не только исходного файла.

Курируется 24K Labs · каталог: https://github.com/Haustorium12/gold-402