authbox

Instructions

Implementation Reference

• packages/mcp-protocol/src/server.ts:372-396 (handler)

  The `toolListServices` function is the handler for `list_available_services`. It checks agent policy and retrieves services from the bridge.

  private async toolListServices(
    session: MCPSession,
    policies: AgentPolicy[],
  ): Promise<ToolCallResult> {
    const request: AccessRequest = {
      agentId: session.agentId,
      action: 'read',
    };
  
    const decision = this.policyEngine.evaluate(policies, request);
    await this.logAccess(session, 'list_services', undefined, decision);
  
    if (!decision.allowed) {
      return {
        content: [{ type: 'text', text: `Access denied: ${decision.reason}` }],
        isError: true,
      };
    }
  
    const services = await this.bridge.listServices(session.userId);
  
    return {
      content: [{ type: 'text', text: JSON.stringify({ services }) }],
    };
  }

• packages/mcp-protocol/src/tools.ts:62-70 (schema)

  The `list_available_services` tool definition, including name, description, and input schema.

      name: 'list_available_services',
      description:
        'List all services that the user has stored credentials for. Returns service names only, no secrets. Useful for discovering what credentials are available before making requests.',
      inputSchema: {
        type: 'object',
        properties: {},
      },
    },
  ];