Create MCP Server

POSThttps://api.confident-ai.com/v1/mcp-servers

Registers one of your MCP servers with the project and returns its id. Registering does not connect — call the connect route to verify it and discover its tools.

POST/v1/mcp-servers

curl -X POST "https://api.confident-ai.com/v1/mcp-servers" \
  -H "CONFIDENT_API_KEY: <PROJECT-API-KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "GitHub",
  "transport": "HTTP",
  "url": "https://mcp.example.com/sse",
  "headers": {
    "Authorization": "Bearer YOUR-TOKEN"
  }
}'

200

{
  "success": true,
  "data": {
    "id": "MCP-SERVER-ID"
  },
  "deprecated": false
}

Headers

CONFIDENT_API_KEYstringRequired
The API key of your Confident AI project.

Request body

namestringRequired
The name of the MCP server. Must be unique — names are not reused.
transportenumRequired
How Confident AI reaches the server. HTTP requires url, STDIO requires command.
Show 2 enum valuesHide 2 enum values
- HTTP
- STDIO
descriptionstring
The description of the MCP server.
urlstring
The URL of the server. Required when the transport is HTTP, and cleared otherwise.
headersobject
Static headers sent with every request. Only used when authType is HEADERS, and cleared otherwise. Replaces the whole map, so send every header you want to keep.
authTypeenum
How Confident AI authenticates to the server. HTTP transport only, and defaults to HEADERS.
Show 3 enum valuesHide 3 enum values
- HEADERS
- OAUTH_CLIENT_CREDENTIALS
- AZURE_AD
authConfigobject
Credentials for a non-HEADERS auth type. Unlike headers, these fields merge — send only the ones you are changing.
Show 4 propertiesHide 4 properties
- tenantIdstring
  The Azure AD directory (tenant) id. Required when authType is AZURE_AD.
- clientIdstring
  The OAuth client id. Required when authType is AZURE_AD or OAUTH_CLIENT_CREDENTIALS.
- clientSecretstring
  The OAuth client secret. Write-only — omit it to keep the stored secret. Changing authType discards the stored secret, so a new one must be sent.
- scopestring
  The OAuth scope to request. Required when authType is AZURE_AD.
commandstring
The command that launches the server. Required when the transport is STDIO, and cleared otherwise.
argslist of strings
The arguments passed to command. STDIO transport only. Replaces the whole list.

Response

The id of the created MCP server.

successboolean
Indicates if the request was successful.
dataobject
The id of the affected MCP server.
Show 1 propertyHide 1 property
- idstring
  The id of the affected MCP server.
deprecatedboolean
Indicates if this endpoint is deprecated.

Built byConfident AI