Connect MCP Server

(v1)

POST

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