8004scan

8004scan Builder Hub

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

Supercharge your Claude Code workflow with 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 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