Update MCP Server

PUThttps://api.confident-ai.com/v1/mcp-servers/{mcpServerId}

Updates an MCP server. Only the fields you send change, and the merged result must be valid — switching transport needs that transport's required field in the same call.

PUT/v1/mcp-servers/{mcpServerId}

curl -X PUT "https://api.confident-ai.com/v1/mcp-servers/{mcpServerId}" \
  -H "CONFIDENT_API_KEY: <PROJECT-API-KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "GitHub (production)"
}'

200

{
  "success": true,
  "data": {
    "mcpServer": {
      "id": "MCP-SERVER-ID",
      "name": "GitHub (production)",
      "description": "Repository and issue tools",
      "transport": "HTTP",
      "connected": false,
      "url": "https://mcp.example.com/sse",
      "headers": {
        "Authorization": "Bearer YOUR-TOKEN"
      },
      "authType": "HEADERS",
      "authConfig": null,
      "command": null,
      "args": []
    }
  },
  "deprecated": false
}

Headers

CONFIDENT_API_KEYstringRequired
The API key of your Confident AI project.

Path parameters

mcpServerIdstringRequired
The id of the MCP server.

Request body

namestring
The name of the MCP server. Must be unique — names are not reused.
transportenum
How Confident AI reaches the server. Switching transport clears the fields the other one owns, so send the new transport's required field in the same call.
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 updated MCP server.

successboolean
Indicates if the request was successful.
dataobject
The MCP server, with the stored OAuth client secret masked.
Show 1 propertyHide 1 property
- mcpServerobject
  Show 12 propertiesHide 12 properties
  - idstring
    The unique identifier of the MCP server. Use this value when running a dataset evaluation.
  - namestring
    The name of the MCP server.
  - descriptionstring
    The description of the MCP server.
  - transportenum
    How Confident AI reaches the server.
    Show 2 enum valuesHide 2 enum values
    HTTP
    STDIO
  - connectedboolean
    Whether the last connection attempt succeeded. Set by the connect route, and reset to false by any update.
  - urlstring
    The URL of the server. Only set when the transport is HTTP.
  - headersobject
    The static headers sent with every request, returned as stored.
  - authTypeenum
    How Confident AI authenticates to the server.
    Show 3 enum valuesHide 3 enum values
    HEADERS
    OAUTH_CLIENT_CREDENTIALS
    AZURE_AD
  - authConfigobject
    The stored credentials with the secret removed — clientSecret is replaced by a masked clientSecretPreview, which cannot be sent back.
  - commandstring
    The command that launches the server. Only set when the transport is STDIO.
  - argslist of strings
    The arguments passed to command. Only set when the transport is STDIO.
  - availableToolslist of objects
    The tools discovered by the last successful connection. Not cleared by an update, so treat it as stale whenever connected is false.
    Show 3 propertiesHide 3 properties
    namestring
    The name of the tool, as the server reports it.
    descriptionstring
    What the tool does.
    inputSchemaobject
    The JSON Schema describing the tool's arguments.
deprecatedboolean
Indicates if this endpoint is deprecated.

Built byConfident AI