Get a Virtual MCP server

GET/api/v1/mcp/configs/{config_id}

Returns a single MCP configuration for the current environment by ID.

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 fetch

scalekit.actions.mcp.getConfig

Fetches a single MCP configuration by ID.

scalekit.actions.mcp.getConfig(
  configId: string,
): Promise<GetMcpConfigResponse>

Parameters

configIdstringrequired

ID of the configuration to fetch (cfg_...).

Returns Promise<GetMcpConfigResponse>.

From @scalekit-sdk/node 2.18.0.

Response 200

configobject

The requested 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

401Authentication required

404Not Found - MCP configuration does not exist

Request

curl -sS -X GET \
  "$SCALEKIT_ENVIRONMENT_URL/api/v1/mcp/configs/cfg_85630864460904897" \
  -H "Authorization: Bearer $TOKEN"

1
import os
2

3
import requests
4

5
env_url = os.environ["SCALEKIT_ENVIRONMENT_URL"]
6
token = requests.post(
7
    f"{env_url}/oauth/token",
8
    data={
9
        "grant_type": "client_credentials",
10
        "client_id": os.environ["SCALEKIT_CLIENT_ID"],
11
        "client_secret": os.environ["SCALEKIT_CLIENT_SECRET"],
12
    },
13
).json()["access_token"]
14

15
response = requests.get(
16
    f"{env_url}/api/v1/mcp/configs/cfg_85630864460904897",
17
    headers={"Authorization": f"Bearer {token}"},
18
)
19
response.raise_for_status()
20
result = response.json()

const result = await scalekit.actions.mcp.getConfig("cfg_85630864460904897");

Response 200

1
{
2
  "config": {
3
    "id": "cfg_85630864460904897",
4
    "name": "repo-assistant",
5
    "description": "Reads the user's GitHub repositories and issues",
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
        ]
15
      }
16
    ],
17
    "mcp_server_url": "https://your-env.scalekit.dev/mcp/v3/servers/3d9f6a2e-7b41-4c8e-a5d2-0f1e8b6c4a93"
18
  }
19
}