mcp-servers

Update an MCP server configuration

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

Path parameters

idstring required

Request body

namestring

Human-readable unique name for the MCP server

descriptionstring

Optional description

transportType'http' | 'stdio' | 'sse' | 'websocket'

Transport type for connecting to the MCP server

endpointstring

URL endpoint for HTTP/SSE/WebSocket transports

commandstring

Command to run for stdio transport

argsstring[]

Arguments for stdio command

headersobject nullable

HTTP headers for authentication (will be encrypted). Set to null to clear.

healthCheckUrlstring

Custom health check URL (optional)

enabledboolean

Whether the server is enabled

Response

idstring required
namestring required
descriptionstring
transportType'http' | 'stdio' | 'sse' | 'websocket' required
endpointstring
commandstring
argsstring[]
hasHeadersboolean required

Whether encrypted headers are configured

headerKeysstring[] nullable

Header key names (values are encrypted server-side)

enabledboolean required
healthCheckUrlstring
lastHealthCheckstring
lastHealthStatus'healthy' | 'unhealthy' | 'unknown'
createdAtstring required
updatedAtstring required
groupIdstring

Group ID if this server belongs to a group

Changes