mcp-servers

Create Workspace Mcp Server

Changed on

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/api/v1/workspaces/{workspace_id}/mcp-servers

Request

  • The document declares no server URL.
  • Auth: one of:
    • API key in header Otari-Key
    • API key in header x-api-key

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

  • fbee488d4d9fRevision changes
    • info

      added the optional property to the response with the status

  • e27406481fffRevision changes
    • info

      api operation id create_workspace_mcp_server_api_v1_workspaces__workspace_id__mcp_servers_post removed and replaced with mcp-servers-create_workspace_mcp_server