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).
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Payload for creating an MCP server instance.
json_spec carries the connection configuration. Common shapes:
{"type": "url", "endpoint_url": "https://..."}{"type": "docker", "environment": {...}, "env_vars": [...]}{"type": "command", "command": [...], "environment": {...}}For URL-type instances the service synchronously verifies the endpoint; docker/command kick off background verification.
Connection configuration. Must include 'type' ('url' | 'docker' | 'command'); other keys depend on type.
Display name for this MCP server instance (unique per workspace).
1 - 255ID of an existing MCP server spec to derive defaults from (env_schema, secret routing, etc.).
ID of an MCP auth config (OAuth/credentials) to attach.
Optional human-readable description of the instance.
Response
Successful Response