Aegis

Instructions

Implementation Reference

• src/mcp/mcp-server.ts:237-266 (handler)

  The handler logic for aegis_list_services tool which retrieves services from the vault and filters them based on agent grants.

  async () => {
    const credentials = this.vault.list();
  
    // If an agent is authenticated, filter to only their granted credentials
    let filtered = credentials;
    if (this.authenticatedAgent && this.agentRegistry) {
      const grantedIds = this.agentRegistry.listGrants(this.authenticatedAgent.name);
      if (grantedIds.length > 0) {
        filtered = credentials.filter((c) => grantedIds.includes(c.id));
      }
    }
  
    const services = filtered.map((c) => ({
      name: c.name,
      service: c.service,
      authType: c.authType,
      domains: c.domains,
      scopes: c.scopes,
      expiresAt: c.expiresAt ?? null,
      rateLimit: c.rateLimit ?? null,
    }));
  
    return {
      content: [
        {
          type: 'text' as const,
          text: JSON.stringify({ services, total: services.length }, null, 2),
        },
      ],
    };

• src/mcp/mcp-server.ts:228-236 (registration)

  Registration of the aegis_list_services tool in the MCP server.

  private registerListServicesTool(): void {
    this.server.registerTool(
      'aegis_list_services',
      {
        title: 'Aegis List Services',
        description:
          'List all available services registered in Aegis. Returns service names, auth types, and allowed domains — never secrets.',
        inputSchema: {},
      },