Sign in
v1
protected
mcp-servers

Create Mcp Server

post/v1/workspaces/{workspace}/mcp-servers/

Path parameters

workspacestring required

Slug of the workspace the request acts in

Slug of the workspace the request acts in

Request body

cmdstring[] nullable

Custom command override for container CMD (e.g. switching between stdio and HTTP modes).

descriptionstring required

Short summary of what this MCP server provides.

docker_image_urlstring nullable

Docker image URL for container-based MCP servers.

env_schemaobject[] nullable

Environment-variable schema entries (KeyValueInput from the MCP registry). Each item has at least 'name' and 'description'; mark secrets with 'isSecret: true'.

is_publicboolean

If true, the spec is visible across workspaces.

json_specobject nullable

Raw ServerJSON spec as published by the MCP registry.

namestring required

Human-readable MCP server name (unique per workspace).

registry_urlstring nullable

Source registry URL the spec was imported from.

remote_urlstring nullable

Remote endpoint URL for HTTP-based MCP servers.

tagsstring[]

Tags used for search and categorization.

versionstring

Semantic version of the MCP server spec.

Response

Successful Response

cmdstring[] nullable required
created_atstring required
descriptionstring required
docker_image_urlstring nullable
env_schemaobject[] required
idstring uuid required
is_publicboolean required
json_specobject nullable
namestring required
registry_urlstring nullable
remote_urlstring nullable
slugstring required
statusstring required
tagsstring[] required
updated_atstring required
versionstring required

Changes

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