Britive platform release 2026.09.02 is now live in production.

Press CTRL+K to open search

List all MCP servers

Prev Next
Get
/api/mcp-manager/mcp-servers
Security
HTTP
Type bearer
Query parameters
lastEvaluatedKey
string

Last evaluated key for pagination.

size
integer

Number of MCP servers to retrieve per page. Capped at 100.

Default50
sort
string

Sort field and direction, e.g. serverName,asc.

filter
string

Filter servers by name using the format "name ". Supported operators: eq (exact match), co (contains), sw (starts with). The match is case-insensitive. Only works for servers that have the searchName field populated (servers created after the field was introduced).

Responses
200

A paginated list of MCP servers

Expand All
object
items
Array of object (McpServer)
object
id
string
serverName
string
serverIdentifier
string
description
string
oauthServer
boolean

Whether this MCP server requires downstream OAuth authentication. When true, users must complete an OAuth consent flow before executing tools.

connectionDetails
object

Free-form JSON for OAuth and provider configuration. For OAuth servers: oauth_authorization_endpoint, oauth_token_endpoint, oauth_client_id and oauth_scopes are required. oauth_client_secret is accepted on write but never returned in responses.

proxyPool
string
credProviders
Array of object (McpIDNamePair)
object
id
string
name
string
mcpEndpoint
string

The MCP server endpoint URL. Required on create. Included in all responses so callers can route requests without fetching full connectionDetails.

connected
boolean

Whether the currently authenticated user has an active OAuth token for this MCP server. Populated only in GET responses, not in create/update requests.

toolCount
integer

Total number of tools available on this MCP server. Populated in list responses; not accepted in create/update requests.

policyOrderingEnabled
boolean

When true, policies on this server are ranked and only ordering takes effect -- new policies are assigned the next order automatically. When false (default), policies are unordered. Defaults to false when omitted on create.

nextPageToken
string

Cursor for the next page; absent when no more pages exist.

pageSize
integer

Number of items returned in this page.