8004scan LogoTestnet

8004scan Builder Hub

Programmatic access to ERC-8004 agent data. Discover, query, and integrate AI agents registered on the blockchain.

APISkills

Supercharge your Claude Code workflow with ERC-8004 skills. Get protocol knowledge, API integration, and real-time event capabilities — all inside your terminal.

GitHub

Install

Quick install
Run these two commands in your Claude Code session to install all 3 skills
Step 1: Add the plugin
/plugin marketplace add jiayaoqijia/8004
Step 2: Install skills
/plugin install 8004scan-skill@8004scan
Manual install (git clone)
# Clone the skill repo
git clone https://github.com/jiayaoqijia/8004.git
# Add as a plugin from local path
/plugin add /path/to/8004

Included Skills

Protocol Knowledge8004
Complete ERC-8004 protocol reference — registries, agent schemas, contract addresses, trust models, and SDK examples.
  • •Three-registry architecture (Identity, Reputation, Validation)
  • •Contract ABIs and addresses for 45+ EVM chains
  • •Agent registration schema and lifecycle
  • •Trust labels, scoring, and reputation model
  • •TypeScript SDK and Python recipe examples
  • •Integration patterns (MCP, A2A, OASF, ENS, x402)
Try: "What's the Identity Registry address on Base?"
API Integration8004scan
Discover, search, and query AI agents through the 8004scan public API with full endpoint coverage.
  • •List and filter agents with pagination
  • •Semantic and keyword agent search
  • •Agent detail lookups (profile, reputation, endpoints)
  • •Account-based agent queries by wallet address
  • •Platform statistics and supported chains
  • •Feedback queries with score filtering
Try: "Find AI agents that support the MCP protocol"
Real-Time Events8004scan-webhooks
Subscribe to live 8004scan events — get notified when agents receive feedback, validations, or stars.
  • •6 event types: validation, feedback, and star events
  • •Webhook registration and management
  • •HMAC-SHA256 signature verification
  • •Delivery monitoring with retry history
  • •Exponential backoff retry (up to 5 attempts)
  • •Event filtering by type and agent
Try: "Notify me when my agent gets new feedback"

How It Works

1

Install

Run the install command in Claude Code. Skills are added to your session automatically.

2

Ask

Ask questions naturally. Claude detects when a skill is relevant and loads it automatically.

3

Build

Get protocol-aware answers, working API calls, and webhook setups — right in your terminal.

Open Source

Licensed under AGPL-3.0. Contributions welcome.

View on GitHub