Skip to main content
PATCH
Update a saved server

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.

serverId
string
required

ID of the server inside the project.

Body

application/json

Sparse update — omitted fields are unchanged, and at least one field is required. Editing a server that is shared as an OAuth connection requires project admin.

name
string
Minimum string length: 1
enabled
boolean
transportType
enum<string>
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.

clearClientSecret
boolean

Removes the stored client secret. Mutually exclusive with clientSecret.

clearXaaConfig
boolean

Response

The updated server.

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