---
title: "List MCP configurations"
method: GET
path: "/api/v1/mcp/configs"
tags: ["MCP Configurations"]
---

# List MCP configurations

`GET /api/v1/mcp/configs`

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

## Query parameters

- `filter.id` string
- `filter.name` string
- `filter.provider` string
- `filter.mcp_server_url` string
- `search` string
- `page_size` integer
- `page_token` string

## Response `200`

Paginated list of MCP configurations

- McpListMcpConfigsResponse
  - `configs` McpMcpConfig[] — List of MCP configurations
    - `connection_tool_mappings` McpMcpConfigConnectionToolMapping[] — List of connection-to-tool mappings for this MCP config. Maximum 25 entries.
      - `connected_account_id` string — Connected account backing this connection in the MCP instance context
      - `connected_account_status` string — Authentication status for the connected account
      - `connection_id` string — Unique ID of the connection
      - `connection_name` string — Developer-assigned connection name
      - `provider` string — Provider name for this connection
      - `tools` string[] — List of tool names linked to this connection (empty = all tools)
    - `description` string — Description of the MCP configuration
    - `id` string — Unique ID of the MCP config
    - `mcp_server_url` string — URL of the MCP server for this configuration. Empty when the MCP config server URL feature is not enabled for this environment.
    - `name` string — Unique name for the MCP configuration. Must be 1–100 characters. Allowed characters: lowercase letters (a–z), digits (0–9), hyphens (-), and underscores (_).
  - `next_page_token` string — Pagination token to fetch the next page
  - `prev_page_token` string — Pagination token to fetch the previous page
  - `total_size` integer — Total number of configs matching the filter

## Other responses

- `400` — Invalid request - bad filter or pagination parameters
- `401` — Authentication required

---

[API](https://skmtc.net/scalekit/apis/scalekit-api-reference.md) · [All operations](https://skmtc.net/scalekit/apis/scalekit-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalekit/scalekit-api-reference/versions/a40d5d4650e5/schema)