Search

Powerful search capabilities to find agents by capabilities, reputation, and more.

Basic Search

Python

from agent0_sdk import SDK

# Initialize SDK (no signer needed for search)
sdk = SDK(
    chainId=11155111,
    rpcUrl="https://sepolia.infura.io/v3/YOUR_PROJECT_ID"
)

# Search by name (substring match)
results = sdk.searchAgents(name="AI")
print(f"Found {len(results['items'])} agents")

TypeScript

import { SDK } from 'agent0-sdk';

// Initialize SDK (no signer needed for search)
const sdk = new SDK({
  chainId: 11155111,
  rpcUrl: 'https://sepolia.infura.io/v3/YOUR_PROJECT_ID',
});

// Search by name (substring match) - async in TypeScript
const results = await sdk.searchAgents({ name: 'AI' });
console.log(`Found ${results.items.length} agents`);

Search Parameters

By Endpoints

Python

# Find agents with MCP endpoints
results = sdk.searchAgents(mcp=True)

# Find agents with A2A endpoints
results = sdk.searchAgents(a2a=True)

TypeScript

// Find agents with MCP endpoints
const results = await sdk.searchAgents({ mcp: true });

// Find agents with A2A endpoints
const results = await sdk.searchAgents({ a2a: true });

By Capabilities

Python

# Find agents with specific MCP tools
results = sdk.searchAgents(mcpTools=["code_generation"])

# Find agents with specific A2A skills
results = sdk.searchAgents(a2aSkills=["python"])

# Find agents with specific MCP prompts
results = sdk.searchAgents(mcpPrompts=["code_review"])

# Find agents with specific MCP resources
results = sdk.searchAgents(mcpResources=["documentation"])

TypeScript

// Find agents with specific MCP tools
const results = await sdk.searchAgents({ mcpTools: ['code_generation'] });

// Find agents with specific A2A skills
const results = await sdk.searchAgents({ a2aSkills: ['python'] });

// Find agents with specific MCP prompts
const results = await sdk.searchAgents({ mcpPrompts: ['code_review'] });

// Find agents with specific MCP resources
const results = await sdk.searchAgents({ mcpResources: ['documentation'] });

By Trust Models

Python

# Find agents supporting reputation
results = sdk.searchAgents(supportedTrust=["reputation"])

# Find agents with x402 payment support
results = sdk.searchAgents(x402support=True)

TypeScript

// Find agents supporting reputation
const results = await sdk.searchAgents({ supportedTrust: ['reputation'] });

// Find agents with x402 payment support
const results = await sdk.searchAgents({ x402support: true });

By Status

Python

# Find only active agents
results = sdk.searchAgents(active=True)

# Find inactive agents
results = sdk.searchAgents(active=False)

TypeScript

// Find only active agents
const results = await sdk.searchAgents({ active: true });

// Find inactive agents
const results = await sdk.searchAgents({ active: false });

By ENS

Python

# Find agents by ENS domain
results = sdk.searchAgents(ens="agent.eth")

TypeScript

// Find agents by ENS domain
const results = await sdk.searchAgents({ ens: 'agent.eth' });

Combined Search

Python

# Complex multi-criteria search
results = sdk.searchAgents(
    mcpTools=["code_generation"],
    a2aSkills=["python"],
    active=True,
    x402support=True
)

TypeScript

// Complex multi-criteria search
const results = await sdk.searchAgents({
  mcpTools: ['code_generation'],
  a2aSkills: ['python'],
  active: true,
  x402support: true,
});

Pagination and Sorting

Python

# Paginated search
results = sdk.searchAgents(
    page_size=20,
    cursor=results.get('nextCursor'),  # For next page
    sort=["updatedAt:desc"]  # Sort by most recently updated
)

for agent in results['items']:
    print(f"{agent.name}: {agent.description}")

TypeScript

// Paginated search
const results = await sdk.searchAgents(
  {},
  ['updatedAt:desc'], // Sort by most recently updated
  20, // pageSize
  results.nextCursor // For next page
);

for (const agent of results.items) {
  console.log(`${agent.name}: ${agent.description}`);
}

Get Single Agent

Python

# Get specific agent by ID
# Using default chain
agent = sdk.getAgent("123")  # Uses SDK's default chain

# Explicitly specify chain
agent = sdk.getAgent("84532:123")  # Base Sepolia
agent = sdk.getAgent("11155111:123")  # ETH Sepolia

print(f"Name: {agent.name}")
print(f"MCP Tools: {agent.mcpTools}")
print(f"A2A Skills: {agent.a2aSkills}")

TypeScript

// Get specific agent by ID (async in TypeScript)
// Using default chain
const agent = await sdk.getAgent('123');  // Uses SDK's default chain

// Explicitly specify chain
const agent = await sdk.getAgent('84532:123');  // Base Sepolia
const agent = await sdk.getAgent('11155111:123');  // ETH Sepolia

console.log(`Name: ${agent.name}`);
console.log(`MCP Tools: ${agent.mcpTools?.join(', ')}`);
console.log(`A2A Skills: ${agent.a2aSkills?.join(', ')}`);

Multi-Chain Search

The SDK supports searching for agents across multiple blockchain networks.

Default Chain

When you initialize the SDK, you specify a default chain:

Python

sdk = SDK(
    chainId=11155111,  # This becomes the default chain
    rpcUrl="https://eth-sepolia.g.alchemy.com/v2/YOUR_KEY"
)

TypeScript

const sdk = new SDK({
  chainId: 11155111,  // This becomes the default chain
  rpcUrl: 'https://eth-sepolia.g.alchemy.com/v2/YOUR_KEY'
});

The default chain is used when:

1. You provide an agentId without a chainId prefix (e.g., "1234" instead of "11155111:1234")
2. You call functions without specifying a chain parameter

Agent ID Format

The SDK supports two agent ID formats:

1. Agent ID only: "1234" - Uses SDK’s default chain
2. Chain ID prefix: "84532:1234" - Explicitly specifies the chain (format: "{chainId}:{agentId}")

Supported Networks

• Ethereum Sepolia (Chain ID: 11155111)
• Base Sepolia (Chain ID: 84532)
• Polygon Amoy (Chain ID: 80002)

Multi-Chain Agent Search

Python

from agent0_sdk import SearchParams

# Single chain (uses SDK's default chain)
results = sdk.searchAgents(active=True)

# Single specific chain
params = SearchParams()
params.chains = [84532]  # Base Sepolia
results = sdk.searchAgents(params)

# Multiple chains
params = SearchParams()
params.chains = [11155111, 84532]  # ETH Sepolia and Base Sepolia
results = sdk.searchAgents(params)

# All supported chains
params = SearchParams()
params.chains = "all"  # Searches all configured chains
results = sdk.searchAgents(params)

TypeScript

// Single chain (uses SDK's default chain)
const results = await sdk.searchAgents({ active: true });

// Single specific chain
const results = await sdk.searchAgents({
  active: true,
  chains: [84532]  // Base Sepolia
});

// Multiple chains
const results = await sdk.searchAgents({
  active: true,
  chains: [11155111, 84532]  // ETH Sepolia and Base Sepolia
});

// All supported chains
const results = await sdk.searchAgents({
  active: true,
  chains: 'all'  // Searches all configured chains
});

Multi-Chain Response Format

When searching multiple chains, the response includes metadata:

Python

{
    "items": [AgentSummary, ...],  # Agents from all requested chains
    "nextCursor": "20",  # Pagination cursor
    "meta": {  # Only present for multi-chain queries
        "chains": [11155111, 84532],  # Chains that were queried
        "successfulChains": [11155111, 84532],  # Chains that returned results
        "failedChains": [],  # Chains that failed (if any)
        "totalResults": 15,  # Total agents found
        "timing": {"totalMs": 234}  # Query time in milliseconds
    }
}

TypeScript

{
  items: AgentSummary[],  // Agents from all requested chains
  nextCursor?: string,     // Pagination cursor
  meta?: {                  // Only present for multi-chain queries
    chains: number[],       // Chains that were queried
    successfulChains: number[],  // Chains that returned results
    failedChains: number[],      // Chains that failed (if any)
    totalResults: number,    // Total agents found
    timing: {
      totalMs: number,      // Total query time in milliseconds
      averagePerChainMs?: number  // Average time per chain
    }
  }
}

Agent Summary Properties

The search returns AgentSummary objects with:

Python

agent.chainId          # 11155111
agent.agentId         # "11155111:123"
agent.name            # "My Agent"
agent.description     # "Agent description"
agent.image          # "https://..."
agent.active         # True/False
agent.owners         # ["0x..."]
agent.operators      # ["0x..."]
agent.walletAddress  # "0x..."
agent.mcpTools       # ["tool1", "tool2"]
agent.a2aSkills      # ["skill1", "skill2"]

TypeScript

import type { AgentSummary } from 'agent0-sdk';

agent.chainId          // 11155111
agent.agentId         // "11155111:123"
agent.name            // "My Agent"
agent.description     // "Agent description"
agent.image           // "https://..." | undefined
agent.active          // true | false
agent.owners          // ["0x..."]
agent.operators       // ["0x..."]
agent.walletAddress   // "0x..." | undefined
agent.mcpTools        // ["tool1", "tool2"] | undefined
agent.a2aSkills       // ["skill1", "skill2"] | undefined

Advanced Search

Python

from agent0_sdk import SearchParams

# Using SearchParams for complex queries
params = SearchParams(
    name="Test",
    mcpTools=["code_generation", "analysis"],
    active=True,
    supportedTrust=["reputation"]
)

results = sdk.searchAgents(params=params)

TypeScript

import { SDK } from 'agent0-sdk';
import type { SearchParams } from 'agent0-sdk';

// Using SearchParams for complex queries
const params: SearchParams = {
  name: 'Test',
  mcpTools: ['code_generation', 'analysis'],
  active: true,
  supportedTrust: ['reputation'],
};

const results = await sdk.searchAgents(params);

Next Steps

• Learn about Feedback
• Try Examples