Skip to main content
GET
List Server Directory

Authorizations

Authorization
string
header
required

A Barndoor API key, sent as Authorization: Bearer <key>. Keys are prefixed bdai_ and are opaque — do not attempt to decode one. Interchangeable with an OAuth 2.0 access token.

Query Parameters

search
string | null

Search server directories by name or description

category
string[] | null

Filter by category slug(s)

order_by
string | null
default:name

Order by field: name or created_at (default: name)

order
string | null
default:asc

Order direction: asc or desc (default: asc)

include_servers
boolean
default:false

Include server instances for the current user's organization

include_local
boolean
default:true

BCP-4300: false drops catalogs that run locally through the Barndoor CLI (embedded and local sources) before pagination, so page counts match what an org without the local-cli-mcp-tooling flag is shown. Defaults to true (unchanged listing).

page
integer
default:1

Page number (1-based)

Required range: x >= 1
limit
integer
default:10

Number of items per page (max 100)

Required range: 1 <= x <= 100
source
string | null

Filter by source: barndoor, third_party, internal, custom_third_party, custom_internal, local, embedded, or aliases 'custom' / 'local' (which expand to their component sources)

Response

Successful Response

data
MCPServerDirectoryReadWithServers · object[]
required

Array of items for current page

pagination
PaginationMeta · object
required

Pagination metadata