---
title: "Add a server to a group (admin only)"
method: POST
path: "/api/v1/mcp-groups/{id}/servers"
tags: ["mcp-groups"]
---

# Add a server to a group (admin only)

`POST /api/v1/mcp-groups/{id}/servers`

## Path parameters

- `id` string, required

## Request body

- AddServerToGroupDto
  - `serverId` string, uuid, required
  - `recommended` boolean
  - `defaultSelected` boolean

## Response `201`

- McpGroupServerResponseDto[]
  - `id` string, required
  - `name` string, required
  - `serverName` string, required
  - `description` string, nullable, required
  - `transportType` 'http' | 'stdio' | 'sse' | 'websocket', required
  - `endpoint` string, nullable, required
  - `command` string, nullable, required
  - `args` string[], nullable, required
  - `enabled` boolean, required
  - `healthStatus` 'healthy' | 'unhealthy' | 'unknown', required
  - `toolCount` number, required
  - `recommended` boolean, required
  - `defaultSelected` boolean, required

## Changes

- **2026-02-05** `d70838e27152` — 1 info
  - added the required property `items/args` to the response with the `201` status
- **2026-02-03** `1c925b8c211d` — 5 breaking, 3 warning, 4 info
  - added the pattern `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$` to the request property `serverId`
  - the `serverId` request property type/format changed from `string`/`` to `string`/`uuid`
  - the response property `items/command` became nullable for the status `201`
  - the response property `items/description` became nullable for the status `201`
  - …8 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

[Full history](https://skmtc.dev/shipsecai/apis/shipsec-studio-api/changes/api/v1/mcp-groups/:id/servers/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/cc60562ad9f3/schema)