Skip to main content
POST
Save a server into a project

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

Creates a saved server in the project. Server names are unique per workspace — a clash responds 409. Scope comes from the path: projectId, serverId and workspaceId are rejected in the body.

name
string
required
Minimum string length: 1
enabled
boolean
required
transportType
enum<string>
required
Available options:
stdio,
http
command
string

stdio transport only.

args
string[]
env
object

Stored encrypted; never returned by any read.

url
string<uri>

http transport only.

headers
object

Stored encrypted; never returned by any read.

hasBearerToken
boolean
timeout
number
clientCapabilities
any

Opaque MCP client capabilities bag.

useOAuth
boolean
oauthScopes
string[]
clientId
string
oauthResourceUrl
string
oauthProtocolMode
string
oauthProtocolVersion
string
oauthRegistrationStrategy
string
xaaAuthzIssuer
string
xaaAllowPathScopedIssuer
boolean
oauthAllowPathScopedIssuer
boolean
useXaa
boolean
authServerMode
enum<string>
Available options:
mcpjam,
own
xaaSubject
string
xaaEmail
string
xaaIdentityAssertionFormat
string
xaaClientAuth
string
authMethod
string
registrationMode
string
clientSecret
string

Stored encrypted; never returned. Reads expose only hasClientSecret.

Response

The server was created.

A saved MCP server, projected toward the hosted (HTTP) shape. STDIO command/args/env and raw headers are never exposed.

id
string
required
name
string
required
enabled
boolean
required
transportType
string
required
useOAuth
boolean
required
hasClientSecret
boolean
required
projectId
string | null
url
string | null

Endpoint for HTTP-transport servers; null for stdio.

oauthScopes
string[]
createdAt
number | null

Epoch milliseconds.

updatedAt
number | null