SCscalekit
MCP Configurations

Create a new MCP configuration

Changed on

Creates a new MCP configuration with a set of connections and tools.

post/api/v1/mcp/configs

Request

Request body

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.

tool_exposure'DIRECT' | 'META'

How a Virtual MCP server exposes tools: DIRECT lists every mapped tool, META gives agents five tools to search for and run them.

namestring

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

Example request

{
  "description": "Summarizes daily emails and posts to Slack",
  "id": "cfg_85630864460904897",
  "mcp_server_url": "https://env.scalekit.com/mcp/v3/servers/550e8400-e29b-41d4-a716-446655440000",
  "name": "daily-summarizer"
}

Response

The newly created MCP configuration

Example response

{
  "config": {
    "description": "Summarizes daily emails and posts to Slack",
    "id": "cfg_85630864460904897",
    "mcp_server_url": "https://env.scalekit.com/mcp/v3/servers/550e8400-e29b-41d4-a716-446655440000",
    "name": "daily-summarizer"
  }
}

Changes

  • f6c5d8349d4aRevision changes
    • info

      added the new optional request property

    • info

      added the optional property / to the response with the status

  • 8895edb68754Revision changes
    • breaking

      removed the success response with the status

    • info

      added the success response with the status