> ## 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. # Get Server Directory ## OpenAPI ````yaml /api-reference/openapi.yaml get /api/registry/v1/server-directory/{server_directory_id} openapi: 3.1.0 info: title: Barndoor.ai Public API description: Unified public API specification for Barndoor.ai platform version: 2.18.0 servers: - url: https://{host} description: Barndoor public API variables: host: default: platform.barndoor.ai description: >- The host serving your Barndoor deployment. Defaults to production; override it for another environment or a dedicated deployment. security: - ApiKey: [] - OAuth2: - openid - profile - email tags: - name: dlp x-group: Data Control Center - name: identity x-group: Identity - name: llm-gateway x-group: LLM Gateway - name: notification x-group: Notifications - name: policy x-group: Policies - name: registry x-group: MCP Gateway - name: system-management x-group: Log Exports paths: /api/registry/v1/server-directory/{server_directory_id}: get: tags: - registry summary: Get Server Directory operationId: get_mcp_server_directory_entry parameters: - name: server_directory_id in: path required: true schema: type: string format: uuid title: Server Directory Id - name: include_active_server_ids in: query required: false schema: type: boolean description: When true, include active_server_ids for this directory default: false title: Include Active Server Ids description: When true, include active_server_ids for this directory responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/MCPServerDirectoryRead' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: MCPServerDirectoryRead: 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 runtime: anyOf: - additionalProperties: true type: object - type: 'null' title: Runtime configuration_schema: additionalProperties: true type: object title: Configuration Schema tool_manifest: items: additionalProperties: true type: object type: array title: Tool Manifest name: type: string title: Name description: anyOf: - type: string - type: 'null' title: Description icon: anyOf: - type: string - type: 'null' title: Icon slug: anyOf: - type: string - type: 'null' title: Slug organization_id: anyOf: - type: string format: uuid - type: 'null' title: Organization Id url: type: string title: Url protocol: $ref: '#/components/schemas/Protocol' default: mcp source: $ref: '#/components/schemas/ServerSource' default: barndoor provider: type: string title: Provider description: The provider name to use when registering with OpenBao default: custom provider_options: title: Provider Options scopes: items: type: string type: array title: Scopes oauth_metadata: additionalProperties: true type: object title: Oauth Metadata protected_resource_metadata: additionalProperties: true type: object title: Protected Resource Metadata allow_oauth_override: type: boolean title: Allow Oauth Override default: false meta: anyOf: - additionalProperties: true type: object - type: 'null' auth_params: title: Auth Params credential_schema: title: Credential Schema public: type: boolean title: Public default: false requires_auth: type: boolean title: Requires Auth default: false requires_auth_observed_at: anyOf: - type: string format: date-time - type: 'null' title: Requires Auth Observed At description: >- When requires_auth was last observed. NULL = not observed since the last URL change. categories: items: $ref: '#/components/schemas/MCPServerCategory' type: array title: Categories default: [] active_server_ids: anyOf: - type: array items: type: string - type: 'null' title: Active Server Ids credential_modes: anyOf: - $ref: '#/components/schemas/DirectoryCredentialModes' - type: 'null' description: >- The OAuth credential modes a new server from this directory can use, for the calling organization. `null` for a directory whose provider does not use OAuth, and on the responses of the directory create and update routes. type: object required: - id - created_at - updated_at - runtime - configuration_schema - tool_manifest - name - description - icon - slug - organization_id - url - protocol - source - provider - provider_options - scopes - oauth_metadata - protected_resource_metadata - allow_oauth_override - meta - auth_params - credential_schema - public - requires_auth - requires_auth_observed_at - categories - active_server_ids - credential_modes title: MCPServerDirectoryRead HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError Protocol: type: string enum: - mcp - sse title: Protocol description: Protocol enum for MCP server communication. ServerSource: type: string enum: - barndoor - third_party - internal - custom_third_party - custom_internal - local - embedded title: ServerSource MCPServerCategory: 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 slug: type: string title: Slug description: anyOf: - type: string - type: 'null' title: Description type: object required: - id - created_at - updated_at - name - slug - description title: MCPServerCategory DirectoryCredentialModes: properties: automatic: type: string enum: - cimd - dcr - manual title: Automatic description: >- The mode server create selects with `credential_mode: auto`: `cimd` when the provider accepts Barndoor's client ID metadata document, else `dcr` when it has a registration endpoint, else `manual`. Depends on the organization's rollout of the metadata document, so it can differ between organizations for the same directory. managed: type: boolean title: Managed description: >- Barndoor's managed OAuth client can be requested with `credential_mode: managed`. default: type: string enum: - managed - cimd - dcr - manual title: Default description: >- The mode to preselect when creating a server: `managed` when it is available and `automatic` would otherwise leave the administrator to enter a client ID, else `automatic`. type: object required: - automatic - managed - default title: DirectoryCredentialModes description: >- The OAuth credential modes a new server from this directory can use, for the calling organization. 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 securitySchemes: ApiKey: type: http scheme: bearer description: >- A Barndoor API key, sent as `Authorization: Bearer `. Keys are prefixed `bdai_` and are opaque — do not attempt to decode one. Interchangeable with an OAuth 2.0 access token. OAuth2: type: oauth2 x-issuer: https://auth.barndoor.ai/realms/barndoor description: >- An OAuth 2.0 access token from Barndoor's identity provider, sent as `Authorization: Bearer `. Public clients must use PKCE. Interchangeable with an API key. flows: authorizationCode: authorizationUrl: >- https://auth.barndoor.ai/realms/barndoor/protocol/openid-connect/auth tokenUrl: >- https://auth.barndoor.ai/realms/barndoor/protocol/openid-connect/token scopes: openid: Issue an OIDC ID token identifying the caller. profile: Read the caller's basic profile claims. email: Read the caller's email address. offline_access: Issue a refresh token. Optional — no operation requires it. clientCredentials: tokenUrl: >- https://auth.barndoor.ai/realms/barndoor/protocol/openid-connect/token scopes: openid: Issue an OIDC ID token identifying the caller. profile: Read the caller's basic profile claims. email: Read the caller's email address. offline_access: Issue a refresh token. Optional — no operation requires it. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.