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.21.0.

Response 200

configobject

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

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