Britive platform release 2026.09.02 is now live in production.

Get MCP servers the user has access to

Prev Next
Get
/api/mcp-manager/access/my-mcp-servers

Lists the MCP servers the user can access, determined by policy evaluation -- a server is included when the user has access to at least one of its tools. Each entry carries the details needed to start the OAuth connect flow when it is an OAuth server (see oauthServer). Admin-only fields (credential providers, proxy pool) are omitted. Supports search, sort and page-number pagination.

Security
HTTP
Type bearer
Query parameters
filter
string

Structured filter as " " clauses joined by "and" (e.g. "serverName co git and connected eq true"). Fields: serverName, serverIdentifier, description, connected. Operators: eq (equals), co (contains).

searchText
string

Case-insensitive filter on server name, identifier or description.

page
integer

Zero-based page number.

Default0
size
integer

Number of servers per page.

Default20
sort
string

Sort field and direction, e.g. "serverName,asc". Supported fields serverName, serverIdentifier, connected.

Responses
200

Accessible MCP servers retrieved successfully

Expand All
object

Paginated list of the MCP servers the user has access to.

count
integer

Total number of accessible servers matching the filter/search, before pagination.

page
integer

Zero-based page number returned.

size
integer

Page size applied.

sort
string

Sort field and direction applied.

data
Array of object (MyMcpServer)
object

An MCP server the user has access to. For OAuth servers it also carries the details needed to start the OAuth connect flow. Admin-only fields (credProviders, proxyPool) are intentionally omitted from this user-facing response.

id
string
serverName
string
serverIdentifier
string

Identifier used as the OAuth backendId.

description
string
oauthServer
boolean

Whether this server requires an OAuth consent flow before executing tools.

accessibleTools
integer

Number of tools on this server the user has access to (via policy evaluation).

connected
boolean

Whether the current user already holds an active OAuth token for this server. Always false for non-OAuth servers.

connectPath
string

Relative path the client calls to start the OAuth consent flow (GET /api/mcp-manager/oauth//start). Present only for OAuth servers.

404

Not Found