Servers

Save a server into a project

Changed on

Creates a saved MCP server and responds 201 with its detail. This is the provisioning entry point: every eval, host and environment route addresses servers that were created here. Names are unique per workspace, so a clash responds 409 rather than silently returning the existing row. Secret-bearing fields (env, headers, clientSecret) are encrypted at rest and never returned by any read.

post/projects/{projectId}/servers

Request

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

Path parameters

projectIdstring required

ID of the hosted project that contains the server.

Request body

namestring required
enabledboolean required
transportType'stdio' | 'http' required
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.

Response

The server was created.

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