v4

latestOpenAPI 3.1.1Apache 2.02026-07-31107278570.4 KB

MCP Configurations

List MCP configurations

Lists MCP configurations for the current environment with optional filters for id, name prefix, and provider.

get/api/v1/mcp/configs

Query parameters

filter.idstring

Filter by MCP configuration id

filter.namestring

Case-insensitive exact match on configuration name. Allowed characters: letters (a–z, A–Z), digits (0–9), hyphens (-), and underscores (_). Maximum 100 characters.

filter.providerstring

Filter configs that include this provider

filter.mcp_server_urlstring

Filter configs by MCP server URL. The UUID is extracted from the last path segment of the URL and used to find the matching configuration.

searchstring

Look ahead text search on config name

page_sizeinteger

Number of configs to return per page (max 30)

page_tokenstring

Pagination token to fetch the next or previous page

Response

Paginated list of MCP configurations

next_page_tokenstring

Pagination token to fetch the next page

prev_page_tokenstring

Pagination token to fetch the previous page

total_sizeinteger

Total number of configs matching the filter

Example response

{
  "configs": [
    {
      "description": "Summarizes daily emails and posts to Slack",
      "id": "cfg_85630864460904897",
      "mcp_server_url": "https://env.scalekit.com/mcp/v3/servers/550e8400-e29b-41d4-a716-446655440000",
      "name": "daily-summarizer"
    }
  ]
}