List Servers

GEThttps://api.confident-ai.com/v2/mcp-servers

Lists the MCP servers registered in your Confident AI project one page at a time, ordered by name. Credentials are never included here — neither the static headers nor the OAuth config — so retrieve a server by id to see its configuration.

GET/v2/mcp-servers

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

200

{
  "success": true,
  "data": {
    "mcpServers": [
      {
        "id": "<MCP-SERVER-ID>",
        "name": "Internal Tools",
        "description": "Internal engineering tools",
        "transport": "STDIO",
        "url": "https://mcp.internal.example.com/sse",
        "connected": true
      }
    ],
    "totalMcpServers": 3,
    "page": 1,
    "pageSize": 25
  },
  "deprecated": false
}

Headers

CONFIDENT_API_KEYstringRequired
The API key of your Confident AI project.

Query parameters

pageintegerdefault: 1
The page to return. Defaults to 1.
pageSizeintegerdefault: 25
The number of results per page, at most 100. Defaults to 25.

Response

List Servers succeeded.

successboolean
Indicates if the request was successful.
dataobject
One page of MCP servers, with the total across all pages.
Show 4 propertiesHide 4 properties
- mcpServerslist of objects
  The MCP servers for the current page, ordered by name.
  Show 6 propertiesHide 6 properties
  - idstring
    The id of the MCP server, generated by Confident AI.
  - namestring
    The name of the MCP server.
  - descriptionstring | null
    What the MCP server is for.
  - transportenum
    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
  - urlstring | null
    The URL of the server. Only set when transport is HTTP.
  - connectedboolean
    Whether the last connection attempt succeeded.
- totalMcpServersinteger
  The total number of MCP servers in this project.
- pageinteger
  The page this response covers.
- pageSizeinteger
  The number of MCP servers per page.
deprecatedboolean
Indicates if this endpoint is deprecated.

Built byConfident AI