Britive platform release 2026.09.02 is now live in production.

Create a new MCP server

Prev Next
Post
/api/mcp-manager/mcp-servers
Security
HTTP
Type bearer
Body parameters
Expand All
object
id
string
serverName
string Required
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 Required

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 Required

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

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.

Responses
201

MCP server created successfully

Expand All
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.