list_agents
Browse indexed ACP agents with trust scores to discover and evaluate available agents in the maiat-protocol ecosystem.
Instructions
Browse indexed agents with their trust scores. Returns a paginated list of all known ACP agents.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max number of agents to return (default: 50) |
Implementation Reference
- packages/mcp-server/src/index.ts:228-238 (handler)The MCP tool handler for 'list_agents' which executes the request via the SDK.
async ({ limit }) => { try { const data = await sdk.listAgents(limit); return { content: [ { type: "text" as const, text: JSON.stringify(data, null, 2), }, ], }; - packages/mcp-server/src/index.ts:219-227 (registration)Tool definition and schema registration for 'list_agents' in the MCP server.
server.tool( "list_agents", "Browse indexed agents with their trust scores. Returns a paginated list of all known ACP agents.", { limit: z .number() .default(50) .describe("Max number of agents to return (default: 50)"), }, - packages/sdk/src/index.ts:208-210 (helper)The actual SDK method that performs the API call to fetch the list of agents.
async listAgents(limit = 50): Promise<{ agents: AgentTrustResult[]; total: number }> { return this.request(`/api/v1/agents?limit=${limit}`); }