Get MCP Server

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

Retrieves a single MCP server by its mcpServerId, with its full configuration and last discovered tools.

GET/v1/mcp-servers/{mcpServerId}

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

200

{
  "success": true,
  "data": {
    "mcpServer": {
      "id": "MCP-SERVER-ID",
      "name": "Internal Tools",
      "description": "Internal engineering tools",
      "transport": "HTTP",
      "connected": true,
      "url": "https://mcp.internal.example.com/sse",
      "headers": null,
      "authType": "AZURE_AD",
      "authConfig": {
        "tenantId": "TENANT-ID",
        "clientId": "CLIENT-ID",
        "scope": "api://internal-tools/.default",
        "clientSecretPreview": "••••••••Xk3mZq"
      },
      "command": null,
      "args": [],
      "availableTools": [
        {
          "name": "search_issues",
          "description": "Search issues in a repository",
          "inputSchema": {
            "type": "object"
          }
        }
      ]
    }
  },
  "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 requested 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