Sign in
mcp-servers

Create Workspace Mcp Server

Register an MCP server for a workspace. Organization owners/admins or this workspace's owners/admins.

The authorization token is encrypted at rest and never returned. The URL is checked for SSRF safety here as well as on the request path, and must use https when a token is set. A name already used in this workspace is refused with a 409.

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

Path parameters

workspace_idstring uuid required

Request body

allowed_toolsstring[] nullable

Allow-list of tool names; null exposes every tool the server offers

authorization_tokenstring nullable

Bearer token for the server; requires an https URL. Encrypted at rest, never returned

enabledboolean

Whether a request naming this server actually reaches it

namestring required

Label for the server, unique within the workspace

purpose_hintstring nullable

Hint prepended to the system message to help the model choose

urlstring required

Streamable HTTP MCP endpoint

Response

Successful Response

allowed_toolsstring[] nullable required
created_atstring required
enabledboolean required
has_tokenboolean required
idstring uuid required
namestring required
purpose_hintstring nullable required
updated_atstring required
urlstring required
workspace_idstring uuid required

Changes

Changed in 3 of the 134 revisions of this API.12