---
title: "Update an existing MCP configuration"
method: PUT
path: "/api/v1/mcp/configs/{config_id}"
tags: ["MCP Configurations"]
---

# Update an existing MCP configuration

`PUT /api/v1/mcp/configs/{config_id}`

Updates the description and connection-to-tool mappings for an existing MCP configuration. The configuration name cannot be changed after creation.

## Path parameters

- `config_id` string, required

## Request body

- McpServiceUpdateMcpConfigBody
  - `connection_tool_mappings` McpMcpConfigConnectionToolMapping[] — Updated 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 — Updated description for the MCP configuration

## Response `200`

The updated MCP configuration

- McpUpdateMcpConfigResponse
  - `config` McpMcpConfig
    - `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 (_).

## Other responses

- `400` — Invalid request - malformed payload or invalid mappings
- `401` — Authentication required
- `404` — Not Found - MCP configuration does not exist

---

[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)