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/workspaces/{workspace}/mcp-server-instances/

Path parameters

workspacestring required

Slug of the workspace the request acts in

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 uuid 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

Changed in 1 of the 50 revisions of this API.1

Sep 26, 2026d3ad8e1a36811See the full diff
- ○
  endpoint added
  endpoint-added

Of the 50 revisions, 1 has no diff computed.