List MCP clients
Returns a paginated list of configured MCP clients with their tools and connection state. Supports case-insensitive name search and exact-match filtering by connection type, auth type, code-mode, and enabled/disabled status. Multi-value filters accept a comma-separated list and use OR semantics within a field.
Query parameters
Maximum number of clients to return (1–100, default 25).
Number of clients to skip.
Case-insensitive search by client name.
Filter to a single client by its exact client_id.
Comma-separated connection types to include (OR semantics).
Comma-separated auth types to include (OR semantics).
Comma-separated runtime connection states to include (OR semantics), resolved against live engine state. connected matches clients the engine currently reports as connected; disconnected matches everything else.
When true, include clients that are open to all virtual keys (allow_on_all_virtual_keys). ORs with virtual_keys.
Comma-separated virtual key IDs; includes clients explicitly assigned to any of them. ORs with all_virtual_keys.
Filter by code-mode clients. Omit for no filter.
Filter by disabled status — true returns disabled clients, false returns enabled clients. Omit for no filter.
Response
Successful response