Sign in

v24

OpenAPI 3.1.0raw.githubusercontent.com2026-08-066580241.1 KB
Servers

Save a server into a project

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

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
{"stackTrail":"components:schemas:ProjectServerCreateRequest:properties:clientCapabilities","oasType":"schema","type":"unknown","description":"Opaque MCP client capabilities bag."}
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