Skip to main content
POST
Snapshot servers into a server group

Authorizations

Authorization
string
header
required

MCPJam API key (sk_…). Create one at Settings → API keys. Guest sessions cannot use the API, and API keys cannot manage other API keys.

Path Parameters

projectId
string
required

ID of the hosted project that contains the server.

Body

application/json
name
string
required

Unique among the project's live server groups.

Minimum string length: 1
serverIds
string[]
required
Minimum array length: 1
description
string

Response

The server group was created.

An immutable snapshot of a set of saved servers. Pin one on an environment so a run uses exactly these servers instead of following its host's live server list.

id
string
required
name
string
required
serverIds
string[]
required

The snapshotted server ids. Authoritative.

serverNames
string[]
required

Display names resolved at read time; a deleted server is labelled rather than dropped.

description
string | null
createdAt
number | null

Epoch milliseconds.

updatedAt
number | null