---
title: "Create a new MCP configuration"
method: POST
path: "/api/v1/mcp/configs"
tags: ["MCP Configurations"]
---

# Create a new MCP configuration

`POST /api/v1/mcp/configs`

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

## Request body

- McpMcpConfig
  - `connection_tool_mappings` McpMcpConfigConnectionToolMapping[] — List of connection-to-tool mappings for this MCP config. Maximum 25 entries.
    - `connected_account_id` string — Connected account backing this connection in the MCP instance context
    - `connected_account_status` string — Authentication status for the connected account
    - `connection_id` string — Unique ID of the connection
    - `connection_name` string — Developer-assigned connection name
    - `provider` string — Provider name for this connection
    - `tools` string[] — List of tool names linked to this connection (empty = all tools)
  - `description` string — Description of the MCP configuration
  - `id` string — Unique ID of the MCP config
  - `mcp_server_url` string — URL of the MCP server for this configuration. Empty when the MCP config server URL feature is not enabled for this environment.
  - `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 (_).

## Response `201`

The newly created MCP configuration

- McpCreateMcpConfigResponse
  - `config` McpMcpConfig
    - `connection_tool_mappings` McpMcpConfigConnectionToolMapping[] — List of connection-to-tool mappings for this MCP config. Maximum 25 entries.
      - `connected_account_id` string — Connected account backing this connection in the MCP instance context
      - `connected_account_status` string — Authentication status for the connected account
      - `connection_id` string — Unique ID of the connection
      - `connection_name` string — Developer-assigned connection name
      - `provider` string — Provider name for this connection
      - `tools` string[] — List of tool names linked to this connection (empty = all tools)
    - `description` string — Description of the MCP configuration
    - `id` string — Unique ID of the MCP config
    - `mcp_server_url` string — URL of the MCP server for this configuration. Empty when the MCP config server URL feature is not enabled for this environment.
    - `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 (_).

## Other responses

- `400` — Invalid request - missing required fields or invalid connection/tool mappings
- `401` — Authentication required - missing or invalid access token

---

[API](https://skmtc.net/scalekit/apis/scalekit-api-reference.md) · [All operations](https://skmtc.net/scalekit/apis/scalekit-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalekit/scalekit-api-reference/versions/a40d5d4650e5/schema)