Skip to main content
POST
Register an MCP server from an uploaded OpenAPI spec

Authorizations

Authorization
string
header
required

JWT token (USER, AGENT, or SERVICE auth)

Body

application/json
name
string
required
spec
string
required

Raw OpenAPI 3.x document (JSON or YAML).

auth
object
required

Resolved auth credentials for a subscription. Secret values are encrypted at rest.

description
string
baseUrlOverride
string

Overrides the spec's servers[] base URL when supplied.

visibility
enum<string>
Available options:
PUBLIC,
INTERNAL,
PRIVATE
selectedOperationIds
string[]

Restricts exposed operations to these operationIds; all are exposed when empty.

documentationUrl
string
healthCheckUrl
string
version
string

Caller-supplied semver for the initial version row; defaults to 1.0.0 when omitted

tags
string[]

Optional user-defined tags for discovery and organization

Response

201 - */*

Created

mcpServerId
string<uuid>