Para desenvolvedores / Para começar

Agentes de IA (MCP)

Uma única URL dá a um agente de IA os dados do explorador e os preços do oráculo.

O que é

O MCP da Pickle é um servidor público do Model Context Protocol, o padrão que os agentes de IA usam para chamar ferramentas. Ele responde em https://mcp.picklechain.xyz/mcp por HTTP em streaming, lê o mesmo indexador que o explorador, e tira os preços dos mesmos feeds que o oráculo.

Somente leitura, sem chave

Ele nunca assina nem envia uma transação, e não pede conta nem chave de API. Cada ferramenta é marcada como somente leitura, então um cliente pode executá-la sem pedir permissão antes.

Conectar um cliente

Claude Code, a partir de um terminal:

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" } } }

O Claude Desktop, o claude.ai, o ChatGPT, o Codex, o Gemini CLI e o Devin Desktop usam a mesma URL. Os passos de cada um estão em mcp.picklechain.xyz/start.

Ferramentas

  • inspect: qualquer coisa colada: um hash de transação ou de minibloco, um endereço, um NFT, um número de bloco ou um nome Pickle.
  • get_address_activity: as transações de um endereço, das mais recentes às mais antigas, uma página de cada vez.
  • get_approvals: as permissões de tokens e as aprovações de NFT que uma carteira concedeu e não revogou.
  • get_latest: os blocos, transações ou miniblocos mais recentes.
  • get_chain_stats: o último bloco e minibloco, o atraso do indexador, a vazão, a taxa de sucesso, o preço do gas, e o ETH e o PKL em USD.
  • search: tokens, coleções de NFT e contratos rotulados, por nome ou símbolo.
  • list_assets: os tokens com seu preço em USD, ou as coleções de NFT.
  • get_prices: os preços do oráculo em USD, e os tokens Pickle precificados pelos pools on-chain.
  • get_network_info: o chain ID, os pontos de acesso públicos, o token de gas e os endereços dos contratos.

Os valores chegam com seu valor em USD primeiro, depois em ETH ou nas unidades próprias do token. Um valor USD nulo significa que não há preço atual, nunca uma estimativa.

Limites

  • Somente rede de teste: chain ID 78270, a rede que o restante desta referência descreve.
  • Cada endereço IP pode enviar ao MCP 10 solicitações por segundo, e por trás disso se aplica o limite próprio do explorador por endereço. Acima desse limite, o MCP responde HTTP 429; uma consulta que o próprio explorador limita responde RATE_LIMITED.
  • Uma ferramenta que falha responde com um código e uma frase, nunca com um rastro de pilha: INVALID_INPUT, NOT_FOUND, RATE_LIMITED ou UPSTREAM_UNAVAILABLE.