---
title: "List MCP Clients"
method: GET
path: "/api/mcp/clients"
tags: ["MCP Management"]
---

# List MCP Clients

`GET /api/mcp/clients`

Get information about all configured MCP (Model Context Protocol) clients including their connection state, available tools, and configuration.

## Response `200`

List of MCP clients

- MCPClient[]
  - `name` string, required — Unique name for this MCP client
  - `config` MCPClientConfig, required
    - `name` string, required — Client name
    - `connection_type` 'http' | 'stdio' | 'sse', required — Communication protocol for MCP connections
    - `connection_string` string — HTTP or SSE URL (required for HTTP or SSE connections)
    - `stdio_config` MCPStdioConfig
      - `command` string, required — Executable command to run
      - `args` string[], required — Command line arguments
      - `envs` string[] — Environment variables required
    - `tools_to_skip` string[] — Tools to exclude from this client
    - `tools_to_execute` string[] — Tools to include from this client (if specified, only these are used)
  - `tools` string[], required — Available tools from this client
  - `state` 'connected' | 'disconnected' | 'error', required — Connection state of MCP client

## Other responses

- `500` — unresolved $ref

---

[API](https://skmtc.dev/getbifrost/apis/bifrost-http-transport-api.md) · [All operations](https://skmtc.dev/getbifrost/apis/bifrost-http-transport-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getbifrost/bifrost-http-transport-api/revisions/e70d3ae3c0d0/schema)