API ReferenceIntegrations

Deploy MCP proxy

Creates a server and queues deployment. deploymentId identifies the created server; use /api/servers/{id} and its jobs to follow progress. Manifest defaults and entitlements apply.

Requires every scope: deployments:write.

Authentication

AuthorizationBearer

JWT returned by POST /api/auth/token-exchange. Amazon and authorization invitations require API-key-derived tokens.

Request

This endpoint expects an object.
environmentIddoubleRequired
serverNamestringRequired>=1 character
Trimmed name.
backendslist of objectsRequired
Backend names must be unique.
cpudoubleOptional
memorydoubleOptional
desiredCountdoubleOptional1-10Defaults to 1
introspectionUrlstringOptionalformat: "uri"
portdoubleOptional1-65535

Response

Success
successboolean
deploymentIdinteger
jobIdinteger
statusenum
messagestring
integrationobjectOptional
hasSecretsbooleanOptional
backendsCountintegerOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
500
Internal Server Error
503
Service Unavailable Error