> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns. > > **Recommended**: > ```bash > npx @scalekit-inc/cli setup > ``` > > Global: > ```bash > npm install -g @scalekit-inc/cli > scalekit setup > ``` > > Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents. > Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim. > [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/) --- # 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. **Path parameters** | Name | Type | Required | Description | | --- | --- | --- | --- | | `config_id` | string | Yes | ID of the MCP configuration to update. | **Request body** | Name | Type | Required | Description | | --- | --- | --- | --- | | `connection_tool_mappings` | array of object | No | Updated list of connection-to-tool mappings for this MCP config. Maximum 25 entries. | | `connection_tool_mappings.connection_name` | string | Yes | Developer-assigned connection name. | | `connection_tool_mappings.tools` | array of string | No | List of tool names linked to this connection (empty = all tools). | | `description` | string | No | Updated description for the MCP configuration. | **Response (200)** | Name | Type | Description | | --- | --- | --- | | `config` | object | The updated MCP configuration. | | `config.connection_tool_mappings` | array of object | List of connection-to-tool mappings for this MCP config. Maximum 25 entries. | | `config.connection_tool_mappings.connected_account_id` | string | Connected account backing this connection in the MCP instance context. | | `config.connection_tool_mappings.connected_account_status` | string | Authentication status for the connected account. | | `config.connection_tool_mappings.connection_id` | string | Unique ID of the connection. | | `config.connection_tool_mappings.connection_name` | string | Developer-assigned connection name. | | `config.connection_tool_mappings.provider` | string | Provider name for this connection. | | `config.connection_tool_mappings.tools` | array of string | List of tool names linked to this connection (empty = all tools). | | `config.description` | string | Description of the MCP configuration. | | `config.id` | string | Unique ID of the MCP config. | | `config.mcp_server_url` | string | The URL MCP clients connect to for this server. Every user and session shares it; the session token identifies the user. | | `config.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 (_). | **Errors** - `400`: Invalid request - malformed payload or invalid mappings - `401`: Authentication required - `404`: Not Found - MCP configuration does not exist **Request** ```bash curl -sS -X PUT \ "$SCALEKIT_ENVIRONMENT_URL/api/v1/mcp/configs/cfg_85630864460904897" \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "description": "Reads the user'\''s GitHub repositories, issues and pull requests", "connection_tool_mappings": [ { "connection_name": "github-connect", "tools": [ "github_user_repos_list", "github_issues_list", "github_pull_requests_list" ] } ] }' ``` **Response** ```json { "config": { "id": "cfg_85630864460904897", "name": "repo-assistant", "description": "Reads the user's GitHub repositories, issues and pull requests", "connection_tool_mappings": [ { "connection_id": "conn_70219645518267719", "connection_name": "github-connect", "provider": "GITHUB", "tools": [ "github_user_repos_list", "github_issues_list", "github_pull_requests_list" ] } ], "mcp_server_url": "https://your-env.scalekit.dev/mcp/v3/servers/3d9f6a2e-7b41-4c8e-a5d2-0f1e8b6c4a93" } } ``` **Python SDK:** `scalekit_client.actions.mcp.update_config` Update mutable fields on an existing MCP configuration. ```python scalekit_client.actions.mcp.update_config( config_id: str, description: Optional[str] = None, connection_tool_mappings: Optional[List[McpConfigConnectionToolMapping]] = None, ) -> UpdateMcpConfigResponse ``` Example: ```python from scalekit.actions.types import McpConfigConnectionToolMapping result = scalekit_client.actions.mcp.update_config( config_id="cfg_85630864460904897", description="Reads the user's GitHub repositories, issues and pull requests", connection_tool_mappings=[ McpConfigConnectionToolMapping( connection_name="github-connect", tools=[ "github_user_repos_list", "github_issues_list", "github_pull_requests_list", ], ), ], ) ``` | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `config_id` | `str` | Yes | Identifier of the configuration to update. | | `description` | `Optional[str]` | No | New description to persist, if provided. | | `connection_tool_mappings` | `Optional[List[McpConfigConnectionToolMapping]]` | No | Replacement connector-to-tool mappings. | Returns `UpdateMcpConfigResponse`: The updated configuration payload. **Node.js SDK:** `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. ```ts scalekit.actions.mcp.updateConfig( params: { configId: string; description?: string; connectionToolMappings?: MessageInitShape['connectionToolMappings']; }, ): Promise ``` Example: ```ts 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", ], }, ], }); ``` | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `configId` | `string` | Yes | ID of the configuration to update. | | `description` | `string` | No | New description. | | `connectionToolMappings` | `MessageInitShape['connectionToolMappings']` | No | Replacement connection-to-tool mappings. | Returns `Promise`. **Used in** - [Create a Virtual MCP server](https://docs.scalekit.com/agentkit/mcp/configure-mcp-server/) Part of [Virtual MCP servers](https://docs.scalekit.com/agentkit/reference/virtual-mcp-servers/) in the [AgentKit API reference](https://docs.scalekit.com/agentkit/reference/). Authentication: https://docs.scalekit.com/agentkit/reference/authentication.md. Errors and rate limits: https://docs.scalekit.com/agentkit/reference/errors.md. Pagination: https://docs.scalekit.com/agentkit/reference/pagination.md --- ## More Scalekit documentation | Resource | What it contains | When to use it | |----------|-----------------|----------------| | [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content | | [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas | | [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |