開発者へ / はじめに

AI エージェント (MCP)

一つの URL が、AI エージェントにエクスプローラーのデータとオラクルの価格を渡します。

これは何か

Pickle MCP は Model Context Protocol の公開サーバーで、これは AI エージェントがツールを呼び出す ために使う標準です。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：最新のブロックとミニブロック、インデクサーの遅れ、スループット、成功率、ガス価格、そして USD での ETH と PKL。
  • search：トークン、NFT コレクション、ラベル付きコントラクトを、名前またはシンボルで。
  • list_assets：USD 価格付きのトークン、または NFT コレクション。
  • get_prices：USD でのオラクル価格、そしてオンチェーンのプールから値付けされた Pickle トークン。
  • get_network_info：chain ID、公開エンドポイント、ガストークン、そしてコントラクトアドレス。

金額はまず USD の値、その後に ETH かトークン自身の単位で示されます。USD の値が null であることは、 現在の価格がないことを意味し、推測を意味することは決してありません。

制限

  • テストネット限定：chain ID 78270、このリファレンスの残りが説明するネットワークです。
  • 各 IP アドレスは MCP に 1 秒あたり 10 リクエストまで送信でき、その裏でエクスプローラー自身の アドレスごとの制限が働きます。この制限を超えると MCP は HTTP 429 で応答し、エクスプローラー自身が制限した照会は RATE_LIMITED と応答します。
  • 失敗したツールはコードと一文で応答し、スタックトレースを返すことは決してありません。INVALID_INPUT、NOT_FOUND、RATE_LIMITED、UPSTREAM_UNAVAILABLE のいずれかです。