Update a Virtual MCP server

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.

This page as markdown Virtual MCP servers overview

Authorization

Authorization: Bearer $TOKEN, an access token from the client credentials grant. See Authentication.

Path parameters

config_idstringrequired

ID of the MCP configuration to update

Body

connection_tool_mappingsarray of object

Updated list of connection-to-tool mappings for this MCP config. Maximum 25 entries.

Show 2 child attributes

connection_namestringrequired

Developer-assigned connection name

toolsarray of string

List of tool names linked to this connection (empty = all tools)

descriptionstring

Updated description for the MCP configuration

scalekit_client.actions.mcp.update_config

Update mutable fields on an existing MCP configuration.

scalekit_client.actions.mcp.update_config(
    config_id: str,
    description: Optional[str] = None,
    connection_tool_mappings: Optional[List[McpConfigConnectionToolMapping]] = None,
) -> UpdateMcpConfigResponse

Parameters

config_idstrrequired

Identifier of the configuration to update.

descriptionOptional[str]

New description to persist, if provided.

connection_tool_mappingsOptional[List[McpConfigConnectionToolMapping]]

Replacement connector-to-tool mappings.

Returns UpdateMcpConfigResponse: The updated configuration payload.

From scalekit-sdk-python 2.19.1.

scalekit.actions.mcp.updateConfig

Updates the description and connection-to-tool mappings of a configuration. The name cannot be changed after creation. Avoid updating while agent sessions are running — tools can become unavailable mid-session. For a significant change, create a new configuration and swap the URL instead.

scalekit.actions.mcp.updateConfig(
  params: {
    configId: string;
    description?: string;
    connectionToolMappings?: MessageInitShape<typeof UpdateMcpConfigRequestSchema>['connectionToolMappings'];
  },
): Promise<UpdateMcpConfigResponse>

Parameters

configIdstringrequired

ID of the configuration to update.

descriptionstring

New description.

connectionToolMappingsMessageInitShape<typeof UpdateMcpConfigRequestSchema>['connectionToolMappings']

Replacement connection-to-tool mappings.

Returns Promise<UpdateMcpConfigResponse>.

From @scalekit-sdk/node 2.18.0.

Response 200

configobject

The updated MCP configuration

Show 5 child attributes

connection_tool_mappingsarray of object

List of connection-to-tool mappings for this MCP config. Maximum 25 entries.

Show 6 child attributes

connected_account_idstring

Connected account backing this connection in the MCP instance context

connected_account_statusstring

Authentication status for the connected account

connection_idstring

Unique ID of the connection

connection_namestring

Developer-assigned connection name

providerstring

Provider name for this connection

toolsarray of string

List of tool names linked to this connection (empty = all tools)

descriptionstring

Description of the MCP configuration

idstring

Unique ID of the MCP config

mcp_server_urlstring

The URL MCP clients connect to for this server. Every user and session shares it; the session token identifies the user.

namestring

Unique name for the MCP configuration. Must be 1–100 characters. Allowed characters: lowercase letters (a–z), digits (0–9), hyphens (-), and underscores (_).

Errors

Every error has the same body: code, message and details. See Errors and rate limits.

400Invalid request - malformed payload or invalid mappings

401Authentication required

404Not Found - MCP configuration does not exist

Used in

Create a Virtual MCP server

Request

1
curl -sS -X PUT \
2
  "$SCALEKIT_ENVIRONMENT_URL/api/v1/mcp/configs/cfg_85630864460904897" \
3
  -H "Authorization: Bearer $TOKEN" \
4
  -H "Content-Type: application/json" \
5
  -d '{
6
    "description": "Reads the user'\''s GitHub repositories, issues and pull requests",
7
    "connection_tool_mappings": [
8
      {
9
        "connection_name": "github-connect",
10
        "tools": [
11
          "github_user_repos_list",
12
          "github_issues_list",
13
          "github_pull_requests_list"
14
        ]
15
      }
16
    ]
17
  }'

1
from scalekit.actions.types import McpConfigConnectionToolMapping
2

3
result = scalekit_client.actions.mcp.update_config(
4
    config_id="cfg_85630864460904897",
5
    description="Reads the user's GitHub repositories, issues and pull requests",
6
    connection_tool_mappings=[
7
        McpConfigConnectionToolMapping(
8
            connection_name="github-connect",
9
            tools=[
10
                "github_user_repos_list",
11
                "github_issues_list",
12
                "github_pull_requests_list",
13
            ],
14
        ),
15
    ],
16
)

const result = await scalekit.actions.mcp.updateConfig({
  configId: "cfg_85630864460904897",
  description: "Reads the user's GitHub repositories, issues and pull requests",
  connectionToolMappings: [
    {
      connectionName: "github-connect",
      tools: [
        "github_user_repos_list",
        "github_issues_list",
        "github_pull_requests_list",
      ],
    },
  ],
});

Response 200

1
{
2
  "config": {
3
    "id": "cfg_85630864460904897",
4
    "name": "repo-assistant",
5
    "description": "Reads the user's GitHub repositories, issues and pull requests",
6
    "connection_tool_mappings": [
7
      {
8
        "connection_id": "conn_70219645518267719",
9
        "connection_name": "github-connect",
10
        "provider": "GITHUB",
11
        "tools": [
12
          "github_user_repos_list",
13
          "github_issues_list",
14
          "github_pull_requests_list"
15
        ]
16
      }
17
    ],
18
    "mcp_server_url": "https://your-env.scalekit.dev/mcp/v3/servers/3d9f6a2e-7b41-4c8e-a5d2-0f1e8b6c4a93"
19
  }
20
}