Pour les développeurs / Pour commencer

Agents IA (MCP)

Une seule URL donne à un agent IA les données de l'explorateur et les prix de l'oracle.

Ce que c'est

Le MCP de Pickle est un serveur public du Model Context Protocol, le standard qu'utilisent les agents IA pour appeler des outils. Il répond à https://mcp.picklechain.xyz/mcp en HTTP streamable, lit le même indexeur que l'explorateur et tire ses prix des mêmes flux que l'oracle.

Lecture seule, sans clé

Il ne signe ni n'envoie jamais de transaction, et ne demande ni compte ni clé d'API. Chaque outil est marqué en lecture seule : un client peut le lancer sans demander d'abord.

Connecter un client

Claude Code, depuis un 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" } } }

Claude Desktop, claude.ai, ChatGPT, Codex, Gemini CLI et Devin Desktop prennent la même URL. Les étapes pour chacun sont sur mcp.picklechain.xyz/start.

Outils

  • inspect : tout ce qu'on colle : un hash de transaction ou de mini-bloc, une adresse, un NFT, un numéro de bloc ou un nom Pickle.
  • get_address_activity : les transactions d'une adresse, des plus récentes aux plus anciennes, page par page.
  • get_approvals : les autorisations de jetons et les approbations NFT qu'un portefeuille a accordées sans les révoquer.
  • get_latest : les derniers blocs, transactions ou mini-blocs.
  • get_chain_stats : le dernier bloc et le dernier mini-bloc, le retard de l'indexeur, le débit, le taux de réussite, le prix du gas, et l'ETH et le PKL en USD.
  • search : les jetons, collections NFT et contrats étiquetés, par nom ou symbole.
  • list_assets : les jetons avec leur prix en USD, ou les collections NFT.
  • get_prices : les prix de l'oracle en USD, et les jetons Pickle cotés par les pools on-chain.
  • get_network_info : le chain ID, les points d'accès publics, le jeton de gas et les adresses des contrats.

Les montants arrivent avec leur valeur en USD d'abord, puis en ETH ou dans les unités du jeton. Une valeur USD nulle veut dire qu'il n'y a pas de prix courant, jamais une estimation.

Limites

  • Réseau de test uniquement : chain ID 78270, le réseau que décrit le reste de cette référence.
  • Chaque adresse IP peut envoyer 10 requêtes par seconde au MCP, et la limite propre à l'explorateur s'applique derrière. Au-delà de cette limite, le MCP répond HTTP 429 ; une recherche que l'explorateur limite lui-même répond RATE_LIMITED.
  • Un outil qui échoue répond par un code et une phrase, jamais par une trace d'erreur : INVALID_INPUT, NOT_FOUND, RATE_LIMITED ou UPSTREAM_UNAVAILABLE.