v12

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01251238661.6 KB

protected

mcp-server-instances

Create Mcp Server Instance

Create a new MCP server instance.

Returns 201 for url (synchronous verification completed). Returns 202 for docker/command (background verification in progress).

post/v1/mcp-server-instances/

auth_config_idstring nullable

ID of an MCP auth config (OAuth/credentials) to attach.

descriptionstring nullable

Optional human-readable description of the instance.

json_specobject required

Connection configuration. Must include 'type' ('url' | 'docker' | 'command'); other keys depend on type.

namestring required

Display name for this MCP server instance (unique per workspace).

server_spec_idstring required

ID of an existing MCP server spec to derive defaults from (env_schema, secret routing, etc.).

Successful Response

created_atstring required

descriptionstring nullable required

idstring uuid required

json_specobject required

last_dispatchobject nullable

namestring required

server_spec_idstring required

toolsobject[] nullable

updated_atstring required

verificationobject required