개발자를 위한 문서 / 시작하기

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에 초당 10개의 요청을 보낼 수 있으며, 그 뒤에서 익스플로러 자체의 주소별 한도가 적용됩니다. 이 한도를 넘으면 MCP는 HTTP 429로 응답하고, 익스플로러 자체가 제한한 조회는 RATE_LIMITED로 응답합니다.
  • 실패하는 도구는 코드와 한 문장으로 응답하며, 스택 트레이스를 절대 반환하지 않습니다: INVALID_INPUT, NOT_FOUND, RATE_LIMITED, 또는 UPSTREAM_UNAVAILABLE.