Connect MCP Server

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

Connects to the MCP server and lists the tools it exposes, replacing its stored connected and availableTools. This reaches out to your own server and can take a few seconds.

POST/v1/mcp-servers/{mcpServerId}/connect

curl -X POST "https://api.confident-ai.com/v1/mcp-servers/{mcpServerId}/connect" \
  -H "CONFIDENT_API_KEY: <PROJECT-API-KEY>"

200

{
  "success": true,
  "data": {
    "connected": true,
    "availableTools": [
      {
        "name": "search_issues",
        "description": "Search issues in a repository",
        "inputSchema": {
          "type": "object"
        }
      }
    ],
    "error": null
  },
  "deprecated": false
}

Headers

CONFIDENT_API_KEYstringRequired
The API key of your Confident AI project.

Path parameters

mcpServerIdstringRequired
The id of the MCP server.

Response

The result of the connection attempt. A server that failed to connect also returns 200 — read connected for the verdict.

successboolean
Indicates if the request was successful.
dataobject
Show 3 propertiesHide 3 properties
- connectedboolean
  Whether Confident AI completed a handshake with the server.
- availableToolslist of objects
  The tools the server exposes. Empty when the connection failed.
  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.
- errorstring
  Why the connection failed. Null when connected.
deprecatedboolean
Indicates if this endpoint is deprecated.

Built byConfident AI