> ## Documentation Index > Fetch the complete documentation index at: https://docs.barndoor.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Agents > List registered agents with pagination. ## OpenAPI ````yaml GET /api/agents openapi: 3.1.0 info: title: Barndoor Platform API version: 1.0.0 description: > REST API for the Barndoor Platform - manage MCP servers, OAuth connections, and proxy MCP requests. ## Authentication All endpoints require a JWT Bearer token obtained through Barndoor's OAuth 2.0 authorization-code flow with PKCE. The SDK handles the OAuth flow automatically using interactive login. ## MCP Integration The `/mcp/{mcp_server_name}` endpoints provide streaming proxy access to third-party MCP servers (Salesforce, Notion, Slack, etc.) with automatic authentication and session management. contact: name: Barndoor Support url: https://barndoor.ai servers: - url: https://{organization_id}.platform.barndoor.ai description: Trial (Production) variables: organization_id: description: Your organization identifier default: your-org - url: https://{organization_id}.platform.barndoor.ai description: Enterprise (Production) variables: organization_id: description: Your organization identifier default: your-org - url: https://{organization_id}.platform.barndooruat.com description: Enterprise (Production) variables: organization_id: description: Your organization identifier default: your-org - url: https://{organization_id}.platform.barndoordev.com description: Enterprise (Production) variables: organization_id: description: Your organization identifier default: your-org security: - BearerAuth: [] tags: - name: Servers description: Manage MCP server instances - name: Connections description: Manage OAuth connections to MCP servers - name: Policies description: Manage access control policies for agents and servers - name: Agents description: Manage AI agent registrations - name: MCP Proxy description: Proxy requests to MCP servers - name: Identity description: Retrieve identity information for the authenticated user paths: /api/agents: get: tags: - Agents summary: List Agents description: List registered agents with pagination. operationId: listAgents parameters: - name: search in: query required: false schema: anyOf: - type: string - type: 'null' description: Search applications by name or description title: Search description: Search applications by name or description - name: agent_type in: query required: false schema: anyOf: - $ref: '#/components/schemas/AgentType' - type: 'null' description: Filter by agent type title: Agent Type description: Filter by agent type - name: page in: query required: false schema: type: integer minimum: 1 description: Page number (1-based) default: 1 title: Page description: Page number (1-based) - name: limit in: query required: false schema: type: integer maximum: 100 minimum: 1 description: Number of items per page (max 100) default: 10 title: Limit description: Number of items per page (max 100) responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PaginationResponse_AgentResponse_' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: AgentType: type: string enum: - internal - external title: AgentType description: Agent type classification for applications. PaginationResponse_AgentResponse_: properties: data: items: $ref: '#/components/schemas/AgentResponse' type: array title: Data description: Array of items for current page pagination: $ref: '#/components/schemas/PaginationMeta' description: Pagination metadata type: object required: - data - pagination title: PaginationResponse[AgentResponse] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError AgentResponse: properties: id: type: string format: uuid title: Id created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At organization_id: type: string format: uuid title: Organization Id application_directory_id: type: string format: uuid title: Agent Directory Id application_directory: $ref: '#/components/schemas/AgentDirectoryBase' agent_type: $ref: '#/components/schemas/AgentType' description: Determine agent type based on application directory properties. readOnly: true type: object required: - id - created_at - updated_at - organization_id - application_directory_id - application_directory - agent_type title: AgentResponse PaginationMeta: properties: page: type: integer title: Page description: Current page number limit: type: integer title: Limit description: Items per page total: type: integer title: Total description: Total number of items pages: type: integer title: Pages description: Total number of pages previous_page: anyOf: - type: integer - type: 'null' title: Previous Page description: Previous page number (null if first page) next_page: anyOf: - type: integer - type: 'null' title: Next Page description: Next page number (null if last page) type: object required: - page - limit - total - pages - previous_page - next_page title: PaginationMeta description: Pagination metadata. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError AgentDirectoryBase: properties: id: type: string format: uuid title: Id created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At name: type: string title: Name description: anyOf: - type: string - type: 'null' title: Description organization_id: type: string format: uuid title: Organization Id external_id: anyOf: - type: string - type: 'null' title: External Id public: type: boolean title: Public dcr: type: boolean title: Dcr post_login_success: type: boolean title: Post Login Success callbacks: anyOf: - items: type: string type: array - type: 'null' title: Callbacks description: OAuth callback URLs stored in alphanumeric ascending order type: object required: - id - created_at - updated_at - name - description - organization_id - external_id - public - dcr - post_login_success - callbacks title: AgentDirectoryBase securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: > JWT token obtained through Barndoor's OAuth 2.0 authorization-code flow with PKCE. The token should be included in the Authorization header: `Authorization: Bearer ` Use the Barndoor SDK's `loginInteractive()` function to obtain tokens automatically. ````