Для разработчиков / С чего начать

ИИ-агенты (MCP)

Один URL даёт ИИ-агенту данные обозревателя и цены оракула.

Что это

Pickle MCP - это публичный сервер Model Context Protocol, стандарта, который ИИ-агенты используют для вызова инструментов. Он отвечает по адресу https://mcp.picklechain.xyz/mcp по потоковому HTTP, читает тот же индексатор, что и обозреватель, и берёт цены из тех же источников, что и оракул.

Только чтение, без ключа

Он никогда не подписывает и не отправляет транзакцию и не требует ни аккаунта, ни ключа API. Каждый инструмент помечен как предназначенный только для чтения, так что клиент может запустить его, не спрашивая разрешения заранее.

Подключить клиента

Claude Code, из терминала:

bash
claude mcp add --transport http --scope user pickle https://mcp.picklechain.xyz/mcp

Cursor:

~/.cursor/mcp.json
{ "mcpServers": { "pickle": { "url": "https://mcp.picklechain.xyz/mcp" } } }

VS Code:

.vscode/mcp.json
{ "servers": { "pickle": { "type": "http", "url": "https://mcp.picklechain.xyz/mcp" } } }

Claude Desktop, claude.ai, ChatGPT, Codex, Gemini CLI и Devin Desktop используют тот же URL. Шаги для каждого - на mcp.picklechain.xyz/start.

Инструменты

  • inspect: что угодно вставленное: хеш транзакции или мини-блока, адрес, NFT, номер блока или имя Pickle.
  • get_address_activity: транзакции адреса, от новых к старым, постранично.
  • get_approvals: разрешения на токены и одобрения NFT, которые кошелёк выдал и не отозвал.
  • get_latest: самые новые блоки, транзакции или мини-блоки.
  • get_chain_stats: последний блок и мини-блок, отставание индексатора, пропускную способность, долю успешных запросов, цену газа, а также ETH и PKL в USD.
  • search: токены, NFT-коллекции и помеченные контракты, по имени или символу.
  • list_assets: токены с их ценой в USD, или NFT-коллекции.
  • get_prices: цены оракула в USD, и Pickle-токены, оценённые ончейн-пулами.
  • get_network_info: chain ID, публичные точки доступа, газовый токен и адреса контрактов.

Суммы приходят сначала со значением в USD, затем в ETH или в собственных единицах токена. Значение USD, равное null, означает отсутствие текущей цены, а не оценку.

Ограничения

  • Только тестовая сеть: chain ID 78270, сеть, которую описывает остальная часть этого справочника.
  • Каждый IP-адрес может отправлять MCP до 10 запросов в секунду, а за этим действует собственный лимит обозревателя на адрес. Сверх этого лимита MCP отвечает HTTP 429; запрос, который ограничивает сам обозреватель, отвечает RATE_LIMITED.
  • Инструмент, который завершается ошибкой, отвечает кодом и фразой, никогда трассировкой стека: INVALID_INPUT, NOT_FOUND, RATE_LIMITED или UPSTREAM_UNAVAILABLE.