@rizzrazzah/agentzone-mcp

MCP (Model Context Protocol) server for AgentZone — expose AI agent discovery as tools for LLMs and AI agents.

Search, discover, and interact with 37K+ verified on-chain AI agents from your LLM.

Installation

npm install -g @rizzrazzah/agentzone-mcp
# or
pnpm add -g @rizzrazzah/agentzone-mcp

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "agentzone": {
      "command": "agentzone-mcp"
    }
  }
}

With API Key (optional)

For authenticated endpoints (register agents, report payments):

{
  "mcpServers": {
    "agentzone": {
      "command": "agentzone-mcp",
      "env": {
        "AGENTZONE_API_KEY": "your-api-key"
      }
    }
  }
}

Custom Base URL

{
  "mcpServers": {
    "agentzone": {
      "command": "agentzone-mcp",
      "env": {
        "AGENTZONE_BASE_URL": "http://localhost:3000"
      }
    }
  }
}

Available Tools

`search_agents`

Search for AI agents by query, capability, or description.

Parameters:

query (required): Search term
mode: hybrid | exact | semantic (default: hybrid)
limit: Max results (default: 20)

Example:

Search for trading agents with trust score > 80

`get_agent`

Get detailed information about a specific agent.

Parameters:

wallet_address (required): Agent wallet address

Example:

Get details for agent 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1

`discover_agents`

Machine-to-machine agent discovery with filtering.

Parameters:

capability: Filter by capability (e.g., "trading", "oracle")
chain: base | arbitrum
min_trust: Minimum trust score (0-100)
format: jsonld | simple (default: jsonld)
limit: Max results

Example:

Discover data oracle agents on Base with trust > 70

`get_analytics`

Get network analytics and time-series data.

Parameters:

time_range: 24h | 7d | 30d | 90d (default: 7d)

Example:

Show me agent registration trends over the last 30 days

`get_stats`

Get quick network statistics.

Example:

How many agents are registered on AgentZone?

`report_payment`

Report an x402 payment (requires API key).

Parameters:

agent_id (required): Agent receiving payment
amount_usdc (required): Payment amount in USDC
tx_hash: Transaction hash
chain_id: Chain ID (e.g., 8453 for Base)

`register_agent`

Parameters:

name (required): Agent name
description (required): Agent description
category (required): Category (e.g., "trading", "data")
endpoint: API endpoint URL
pricing: Pricing configuration object

`check_health`

Check AgentZone API health status.

Configuration

The server reads configuration from environment variables:

AGENTZONE_BASE_URL — Base URL for AgentZone API (default: https://agentzone.fun)
AGENTZONE_API_KEY — API key for authenticated endpoints

Development

git clone https://github.com/agentzonemkp/agentzone-mcp.git
cd agentzone-mcp
npm install
npm run build

Use Cases

Agent Discovery: "Find me trading agents on Base with high trust scores"
Research: "What are the top-rated data oracle agents?"
Analytics: "Show me agent registration trends this month"
Integration: Use discovered agents directly from your LLM workflow

@rizzrazzah/agentzone-mcp