List MCP servers
Returns every MCP server in your organization as a JSON array. Unset fields come back as empty values, and secrets come back redacted.
Authentication
AuthorizationBearer
JWT bearer token authentication. Include the Configuration API key in the Authorization header as ‘Bearer <token>’.
Response
The MCP servers in your organization
id
Unique identifier of the MCP server, assigned by the server.
name
Display name of the MCP server. Must be unique within the organization; up to 128 characters.
connector_id
Connector that provides the MCP server’s base URL and authentication. The connector must use an authentication type supported for MCP servers. ID of an existing connector (GET /configurations/v1alpha1/platform/connectors).
path
Path appended to the connector’s base URL to reach the MCP endpoint, for example ‘/mcp’. Must start with ’/’ when set.
enabled
If true, the MCP server is available for use. Defaults to false.
description
Description of what this MCP server does. Up to 1024 characters.
launch_config
Which users the MCP server and its tools are available to. If no audience is set, it is available to all users.
tool_confirmation_mode
When users must confirm before a tool on this server runs: always, never, or server-guided. Defaults to server-guided, which follows the server’s own tool annotations.
Allowed values:
updated_time
When the configuration was last updated.
updated_by
Who last updated the configuration.
version
Document version. On update, send back the num from your last read.
Errors
401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error
500
Internal Server Error