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
agent = sdk.getAgent("11155111:123")

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)
const agent = await sdk.getAgent('11155111:123');

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

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