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 connections in DIRECT mode.

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

tool_exposurestring (enum)

Change how the server exposes tools to agents: DIRECT or META. Leave it out to keep the current mode. Switching to DIRECT fails when the server has more than 25 connections. After a switch, MCP clients must list the tools again; session tokens keep working.

DIRECTMETA

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,
    tool_exposure: Optional[str] = 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.

tool_exposureOptional[str]

Change how the server exposes tools: DIRECT or META. Leave it out to keep the current mode. Switching to DIRECT fails when the server has more than 25 connections or two connections map tools with the same name. After a switch, MCP clients must list the tools again; session tokens keep working.

Returns UpdateMcpConfigResponse: The updated configuration payload.

From scalekit-sdk-python 2.22.0.

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'];
    toolExposure?: McpToolExposure;
  },
): Promise<UpdateMcpConfigResponse>

Parameters

configIdstringrequired

ID of the configuration to update.

descriptionstring

New description.

connectionToolMappingsMessageInitShape<typeof UpdateMcpConfigRequestSchema>['connectionToolMappings']

Replacement connection-to-tool mappings.

toolExposureMcpToolExposure

Returns Promise<UpdateMcpConfigResponse>.

From @scalekit-sdk/node 2.21.0.

Response 200

configobject

The updated MCP configuration

Show 6 child attributes

connection_tool_mappingsarray of object

List of connection-to-tool mappings for this MCP config. Maximum 25 connections in DIRECT mode.

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 (_).

tool_exposurestring (enum)

How the server exposes tools to agents. DIRECT lists every tool you map to it, for up to 25 connections. META gives agents five tools to search for, inspect and run the mapped tools, with no limit on connections. DIRECT is the default when you create a server without it.

DIRECTMETA

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
    "tool_exposure": "DIRECT"
20
  }
21
}