For developers / Start here

AI agents (MCP)

One URL gives an AI agent the explorer's data and the oracle's prices.

What it is

The Pickle MCP is a public server for the Model Context Protocol, the standard AI agents use to call tools. It answers at https://mcp.picklechain.xyz/mcp over streamable HTTP, reads the same indexer as the explorer, and prices from the same feeds as the oracle.

Read-only, no key

It never signs or sends a transaction, and it asks for no account and no API key. Every tool is marked read-only, so a client can run it without asking first.

Connect a client

Claude Code, from a 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 and Devin Desktop take the same URL. The steps for each are on mcp.picklechain.xyz/start.

Tools

  • inspect: anything pasted: a transaction or mini-block hash, an address, an NFT, a block number or a Pickle name.
  • get_address_activity: an address's transactions, newest first, a page at a time.
  • get_approvals: the token allowances and NFT approvals a wallet has granted and not revoked.
  • get_latest: the newest blocks, transactions or mini-blocks.
  • get_chain_stats: the latest block and mini-block, indexer lag, throughput, success rate, gas price, and ETH and PKL in USD.
  • search: tokens, NFT collections and labelled contracts, by name or symbol.
  • list_assets: the tokens with their USD price, or the NFT collections.
  • get_prices: oracle prices in USD, and Pickle tokens priced from on-chain pools.
  • get_network_info: the chain ID, the public endpoints, the gas token and the contract addresses.

Amounts come with their USD value first, then ETH or the token's own units. A null USD value means there is no current price, never a guess.

Limits

  • Testnet only: chain ID 78270, the network the rest of this reference describes.
  • Each IP address may send the MCP 10 requests a second, and the explorer's own per-address limit applies behind it. Over that limit the MCP answers HTTP 429; a lookup the explorer itself rate-limits answers RATE_LIMITED.
  • A tool that fails answers with a code and a sentence, never a stack trace: INVALID_INPUT, NOT_FOUND, RATE_LIMITED or UPSTREAM_UNAVAILABLE.