Skip to content
Artist Alley

List registered MCP-client servers

GET
/admin/ai/mcp-clients

Returns every operator-registered MCP server (enabled + disabled). Each entry carries the connection config, the last-known health status from the per-server poller, and the tool-grant whitelist count.

Stored auth secrets are NOT included — each entry carries auth_secret_set instead (#711).

Requires mcp.client.admin capability.

Authorizations

Section titled “Authorizations ”

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Server list

object
items
required
Array<object>

One registered MCP server. Each registration becomes one ai.Provider in the router; the operator-chosen name is the audit-dashboard identifier and the dispatcher slot key.

object
id
required
string format: uuid
name
required
string
>= 1 characters <= 128 characters
url
required
string
>= 1 characters
transport
required
string
Allowed values: http stdio
auth_kind
required
string
Allowed values: none bearer header mtls
auth_secret_set
required

True when an auth secret is currently stored for this server. The secret itself is NEVER returned — despite the _ref name on the write side it holds the live bearer token / header value, and a stored credential has no read-back workflow, so no capability reads it back (#711). Set it via POST / PATCH auth_secret_ref.

boolean
auth_header_name
string
nullable
privacy_class
required
string
Allowed values: local cloud
enabled
required
boolean
rate_limit_per_second
required
integer
>= 1
rate_limit_per_minute
required
integer
>= 1
health_check_interval_s
required
integer
>= 1
last_health_check_at
string format: date-time
nullable
last_health_status
string
nullable
Allowed values: healthy degraded unreachable
last_health_error
string
nullable
created_at
required
string format: date-time
updated_at
required
string format: date-time

401

Section titled “401 ”

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
  "error": "authentication required: sign in and retry with a valid session or API token"
}

403

Section titled “403 ”

Authenticated but missing required capabilities

object
error
required

Human-readable error summary

string
Example
the request could not be completed