v106

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-02160524464.6 KB

MCP Servers

Create MCP server

Creates a new MCP server definition. The id is the runtime MCP server name used in qualified tool names.

post/api/v1/mcp-servers

Request body

idstring required

Stable MCP server identifier, used as the runtime MCP server name in qualified tool names.

display_namestring required

Human-readable label for display in management UIs.

descriptionstring nullable

startup_timeout_secsinteger required

tool_timeout_secsinteger required

Example request

{
  "id": "sentry",
  "display_name": "Sentry",
  "description": "Production Sentry MCP server.",
  "startup_timeout_secs": 10,
  "tool_timeout_secs": 60
}

Response

MCP server created

idstring required

Stable MCP server identifier, used as the runtime MCP server name in qualified tool names.

revisionstring required

Stable revision used with If-Match for optimistic concurrency.

display_namestring required

Human-readable label for display in management UIs.

descriptionstring nullable required

startup_timeout_secsinteger required

Seconds to wait for the MCP server to become ready at connect time.

tool_timeout_secsinteger required

Seconds to allow each MCP tool call before timing out.

Example response

{
  "id": "sentry",
  "revision": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
  "display_name": "Sentry",
  "description": "Production Sentry MCP server.",
  "startup_timeout_secs": 10,
  "tool_timeout_secs": 60
}