---
title: "Create a new MCP group (admin only)"
method: POST
path: "/api/v1/mcp-groups"
tags: ["mcp-groups"]
---

# Create a new MCP group (admin only)

`POST /api/v1/mcp-groups`

## Request body

- CreateMcpGroupDto
  - `slug` string, required
  - `name` string, required
  - `description` string, nullable
  - `credentialContractName` string, required
  - `credentialMapping` object, nullable
  - `defaultDockerImage` string, nullable
  - `enabled` boolean

## Response `201`

- McpGroupResponseDto
  - `id` string, required
  - `slug` string, required
  - `name` string, required
  - `description` string, nullable, required
  - `credentialContractName` string, required
  - `credentialMapping` object, nullable, required
  - `defaultDockerImage` string, nullable, required
  - `enabled` boolean, required
  - `templateHash` string, nullable
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Changes

- **2026-02-03** `1c925b8c211d` — 8 breaking, 9 info
  - the `credentialContractName` request property's minLength was increased from `0` to `1`
  - the `name` request property's minLength was increased from `0` to `1`
  - the `slug` request property's minLength was increased from `0` to `1`
  - added 'propertyNames' constraint to the request property `credentialMapping`
  - …13 more
- **2026-02-02** `0c1badf65004` — 1 info
  - endpoint added
- **2026-02-02** `321c48cce199` — 1 breaking
  - api path removed without deprecation
- **2026-02-02** `0c1badf65004` — 1 info
  - endpoint added
- **2025-10-24** `8db531c050e5` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/shipsecai/apis/shipsec-studio-api/changes/api/v1/mcp-groups/post.md)

---

[API](https://skmtc.dev/shipsecai/apis/shipsec-studio-api.md) · [All operations](https://skmtc.dev/shipsecai/apis/shipsec-studio-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/shipsecai/shipsec-studio-api/revisions/9b3bfcd1f476/schema)