maiat-protocol

Instructions

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}`);
  }