Skip to main content
POST
Create Mcp Server

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Payload for creating an MCP server spec (catalog template).

Either docker_image_url (for container-based servers) or remote_url (for HTTP-based servers like GitHub Copilot) should be supplied. env_schema describes the variables an instance built from this spec needs to provide; secret entries (isSecret: true) are routed through the secret manager rather than stored in plaintext.

description
string
required

Short summary of what this MCP server provides.

name
string
required

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

Required string length: 1 - 255
cmd
string[] | null

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

docker_image_url
string | null

Docker image URL for container-based MCP servers.

env_schema
Env Schema · object[] | null

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

is_public
boolean
default:false

If true, the spec is visible across workspaces.

json_spec
Json Spec · object | null

Raw ServerJSON spec as published by the MCP registry.

registry_url
string | null

Source registry URL the spec was imported from.

remote_url
string | null

Remote endpoint URL for HTTP-based MCP servers.

tags
string[]

Tags used for search and categorization.

version
string
default:1.0.0

Semantic version of the MCP server spec.

Response

Successful Response

cmd
string[] | null
required
created_at
string
required
description
string
required
env_schema
Env Schema · object[]
required
id
string<uuid>
required
is_public
boolean
required
name
string
required
slug
string
required
status
string
required
tags
string[]
required
updated_at
string
required
version
string
required
docker_image_url
string | null
json_spec
Json Spec · object | null
registry_url
string | null
remote_url
string | null