MCP Servers

Replace MCP server

Changed on

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

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

Request

  • The document declares no server URL.
  • Auth
    • HTTP bearer
    • or API key in cookie __fabro_session

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
}

Changes

  • efc644ab09d4Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • 78c6acdb22fbRevision changes
    • info

      endpoint added