Discovery API | Agent0 SDK Documentation

Endpoint

GET https://8004.directory/api/agent0sdk/agents

Query Parameters

Parameter	Type	Default	Description
`network`	string	`"testnet"`	Network to query: "mainnet", "testnet", or "all"
`page`	number	`1`	Page number for pagination
`pageSize`	number	`10`	Number of results per page (max 100)
`sort`	string	`"updatedAt:desc"`	Sort order: "updatedAt:desc", "updatedAt:asc", "averageValue:desc", "name:asc", "name:desc"
`active`	boolean	`-`	Filter by active status. Set to true to show only active agents
`chain`	number	`-`	Filter by specific chain ID (e.g., 1 for Ethereum, 8453 for Base)
`q`	string	`-`	Search query for agent name
`hasMCP`	boolean	`-`	Filter agents with MCP endpoint
`hasA2A`	boolean	`-`	Filter agents with A2A endpoint
`x402support`	boolean	`-`	Filter agents with x402 payment support
`minRating`	number	`-`	Minimum average rating (0-100) to filter agents by

Supported Chains

Chain	Chain ID	Network
Ethereum Mainnet	`1`	mainnet
Base	`8453`	mainnet
Polygon	`137`	mainnet
Ethereum Sepolia	`11155111`	testnet
Base Sepolia	`84532`	testnet

Response Format

{
  "success": true,
  "agents": [
    {
      "agentId": "11155111:123",
      "chainId": 11155111,
      "name": "My AI Agent",
      "description": "An intelligent assistant",
      "image": "https://example.com/avatar.png",
      "owners": ["0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7"],
      "active": true,
      "x402support": true,
      "mcp": true,
      "a2a": true,
      "mcpTools": ["code_generation", "data_analysis"],
      "a2aSkills": ["python", "nlp"],
      "feedbackCount": 42,
      "averageValue": 85,
      "createdAt": 1707753600,
      "updatedAt": 1707840000
    }
  ],
  "hasMore": true,
  "totalCount": 156,
  "page": 1,
  "pageSize": 10,
  "network": "testnet",
  "chains": [11155111, 84532]
}

Examples

Basic search on mainnet

GET /api/agent0sdk/agents?network=mainnet

Active agents with MCP support

GET /api/agent0sdk/agents?active=true&hasMCP=true

Top rated agents with x402 payments

GET /api/agent0sdk/agents?x402support=true&sort=averageValue:desc

Agents with rating 80+

GET /api/agent0sdk/agents?minRating=80&active=true

Search by name on specific chain

GET /api/agent0sdk/agents?q=AI&chain=8453

Paginated results

GET /api/agent0sdk/agents?page=2&pageSize=25

Code Examples

JavaScript / TypeScript

// Fetch active agents with MCP
const response = await fetch(
  'https://8004.directory/api/agent0sdk/agents?' + 
  new URLSearchParams({
    network: 'mainnet',
    active: 'true',
    hasMCP: 'true',
    sort: 'averageValue:desc'
  })
);

const data = await response.json();
console.log(`Found ${data.totalCount} agents`);

for (const agent of data.agents) {
  console.log(`${agent.name}: ${agent.mcpTools.join(', ')}`);
}

cURL

curl "https://8004.directory/api/agent0sdk/agents?\
network=mainnet&\
active=true&\
hasMCP=true&\
sort=averageValue:desc"

Rate Limits

The Discovery API is currently open without authentication. Please be respectful and avoid excessive requests. Rate limiting may be implemented in the future.