v106

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

MCP Servers

Replace MCP server

Replaces an MCP server definition when If-Match matches the current MCP server revision.

put/api/v1/mcp-servers/{id}

Path parameters

idstring required

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

Headers

If-Matchstring required

Current resource revision used for optimistic concurrency, as returned in the ETag response header.

Request body

display_namestring required

Human-readable label for display in management UIs.

descriptionstring nullable

startup_timeout_secsinteger required

tool_timeout_secsinteger required

Example request

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

Response

MCP server replaced

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
}