Update MCP Server

PUT 
/v1/mcp-servers/:server_id

Update an existing MCP server.

Only private servers in your environment can be updated. Public servers cannot be updated.

⚠️ BETA FEATURES: The following fields are in beta and may change in future releases:

• configuration.healthCheck - Health check configuration structure
• validationMode: async - Async validation behavior and scheduling

Stable Features (backward compatible):

• Core server properties: name, url, description
• Authentication: auth (OIDC, API Key)
• visibility, validationMode: skip|immediate

Status Codes:

• 200: Server updated successfully
• 400: Invalid input (validation errors, bad auth config)
• 403: Forbidden (attempting to update public server or server from another environment)
• 404: Server not found
• 409: Conflict (duplicate name or URL after update)
• 500: Internal server error

Request

Responses

200

MCP server updated successfully

400

Validation Error

403

Forbidden - Not authorized to update this server (public servers cannot be updated)

404

Not Found - Server does not exist

409

Conflict - Server with updated name or URL already exists in your environment

500

Internal Server Error - Failed to update server