Create Server

POSThttps://api.confident-ai.com/v2/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 the server and discover its tools.

POST/v2/mcp-servers

curl -X POST "https://api.confident-ai.com/v2/mcp-servers" \
  -H "CONFIDENT_API_KEY: <PROJECT-API-KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Internal Tools",
  "transport": "STDIO",
  "description": "Internal engineering tools",
  "url": "https://mcp.internal.example.com/sse",
  "headers": {
    "Authorization": "Bearer YOUR-TOKEN"
  },
  "authType": "HEADERS",
  "authConfig": {
    "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
    "clientId": "9a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
    "clientSecret": "abc123~ExampleClientSecretValue",
    "scope": "api://internal-tools/.default"
  },
  "command": "npx",
  "args": [
    "-y",
    "@modelcontextprotocol/server-filesystem"
  ]
}'

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, unique within the project.
transportenumRequired
How Confident AI reaches the server. HTTP requires url and is the only transport that authenticates; STDIO requires command and launches the server as a local process.
Show 2 enum valuesHide 2 enum values
- STDIO
- HTTP
descriptionstring | null
What the MCP server is for. Send null to leave it unset.
urlstring | null
The URL of the server. Required when transport is HTTP, and cleared otherwise.
headersobject | null
Static headers sent with every request. Only used when authType is HEADERS, and cleared otherwise. This map is stored as a whole rather than merged, so send every header you want to keep.
authTypeenum
How Confident AI authenticates to the server. HEADERS sends the static headers map, OAUTH_CLIENT_CREDENTIALS and AZURE_AD fetch a token from authConfig before every call. HTTP transport only; a STDIO server is always HEADERS.
Show 3 enum valuesHide 3 enum values
- HEADERS
- OAUTH_CLIENT_CREDENTIALS
- AZURE_AD
authConfigobject | null
Credentials for a non-HEADERS auth type. Unlike headers, these fields merge into what is stored, so send only the ones you are changing. Unknown keys are ignored, which is what lets you send back an object you read from the API without stripping its clientSecretPreview first.
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: it is never returned, and clientSecretPreview comes back in its place. Omit this field to leave the stored secret exactly as it is, or send a new value to replace it. Changing authType discards the stored secret, so a new one must be sent in the same call.
- scopestring
  The OAuth scope to request. Required when authType is AZURE_AD.
commandstring | null
The command that launches the server. Required when transport is STDIO, and cleared otherwise.
argslist of strings
The arguments passed to command. STDIO transport only. This list is stored as a whole rather than appended to.

Response

Create Server succeeded.

successboolean
Indicates if the request was successful.
dataobject
A reference to an MCP server by its id.
Show 1 propertyHide 1 property
- idstring
  The id of the MCP server, generated by Confident AI.
deprecatedboolean
Indicates if this endpoint is deprecated.

Built byConfident AI