Para desarrolladores / Para empezar

Agentes de IA (MCP)

Una sola URL le da a un agente de IA los datos del explorador y los precios del oráculo.

Qué es

El MCP de Pickle es un servidor público del Model Context Protocol, el estándar que usan los agentes de IA para invocar herramientas. Responde en https://mcp.picklechain.xyz/mcp sobre HTTP en streaming, lee el mismo indexador que el explorador, y toma sus precios de los mismos feeds que el oráculo.

Solo lectura, sin clave

Nunca firma ni envía una transacción, y no pide ni cuenta ni clave de API. Cada herramienta está marcada de solo lectura, así que un cliente puede ejecutarla sin pedir permiso antes.

Conectar un cliente

Claude Code, desde una 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 y Devin Desktop toman la misma URL. Los pasos para cada uno están en mcp.picklechain.xyz/start.

Herramientas

  • inspect: cualquier cosa que se pegue: un hash de transacción o de minibloque, una dirección, un NFT, un número de bloque o un nombre Pickle.
  • get_address_activity: las transacciones de una dirección, de las más nuevas a las más antiguas, página por página.
  • get_approvals: las asignaciones de tokens y las aprobaciones de NFT que una billetera ha otorgado y no ha revocado.
  • get_latest: los bloques, transacciones o minibloques más nuevos.
  • get_chain_stats: el último bloque y minibloque, el retraso del indexador, el rendimiento, la tasa de éxito, el precio del gas, y ETH y PKL en USD.
  • search: tokens, colecciones NFT y contratos etiquetados, por nombre o símbolo.
  • list_assets: los tokens con su precio en USD, o las colecciones NFT.
  • get_prices: los precios del oráculo en USD, y los tokens Pickle cotizados por los pools on-chain.
  • get_network_info: el chain ID, los puntos de acceso públicos, el token de gas y las direcciones de los contratos.

Los montos llegan con su valor en USD primero, luego en ETH o en las unidades propias del token. Un valor USD nulo significa que no hay un precio actual, nunca una estimación.

Límites

  • Solo red de pruebas: chain ID 78270, la red que describe el resto de esta referencia.
  • Cada dirección IP puede enviar al MCP 10 solicitudes por segundo, y detrás se aplica el límite propio del explorador por dirección. Por encima de ese límite, el MCP responde HTTP 429; una consulta que el propio explorador limita responde RATE_LIMITED.
  • Una herramienta que falla responde con un código y una frase, nunca con una traza de pila: INVALID_INPUT, NOT_FOUND, RATE_LIMITED o UPSTREAM_UNAVAILABLE.