Servers

Update a saved server

Changed on

Sparse update: omitted fields are unchanged. Renaming re-checks per-workspace uniqueness (409 on a clash). Editing a server shared as an OAuth connection requires project admin. clientSecret and clearClientSecret are mutually exclusive.

patch/projects/{projectId}/servers/{serverId}

Request

  • Base URL
    https://app.mcpjam.com/api/v1
  • URL
    https://app.mcpjam.com/api/v1/projects/{projectId}/servers/{serverId}
  • Auth
    HTTP bearer

Path parameters

projectIdstring required

ID of the hosted project that contains the server.

serverIdstring required

ID of the server inside the project.

Request body

namestring
enabledboolean
transportType'stdio' | 'http'
commandstring

stdio transport only.

argsstring[]
envobject

Stored encrypted; never returned by any read.

urlstring uri

http transport only.

headersobject

Stored encrypted; never returned by any read.

hasBearerTokenboolean
timeoutnumber
clientCapabilitiesunknown
useOAuthboolean
oauthScopesstring[]
clientIdstring
oauthResourceUrlstring
oauthProtocolModestring
oauthProtocolVersionstring
oauthRegistrationStrategystring
xaaAuthzIssuerstring
xaaAllowPathScopedIssuerboolean
oauthAllowPathScopedIssuerboolean
useXaaboolean
authServerMode'mcpjam' | 'own'
xaaSubjectstring
xaaEmailstring
xaaIdentityAssertionFormatstring
xaaClientAuthstring
authMethodstring
registrationModestring
clientSecretstring

Stored encrypted; never returned. Reads expose only hasClientSecret.

clearClientSecretboolean

Removes the stored client secret. Mutually exclusive with clientSecret.

clearXaaConfigboolean

Response

The updated server.

idstring required
projectIdstring nullable
namestring required
enabledboolean required
transportTypestring required
urlstring nullable

Endpoint for HTTP-transport servers; null for stdio.

useOAuthboolean required
hasClientSecretboolean required
oauthScopesstring[]
createdAtnumber nullable

Epoch milliseconds.

updatedAtnumber nullable

Changes