Updates an MCP server.
Operation description
You can only update the listening Ingress configuration for sources of the ACK type.
Debugging
Authorization information
Request syntax
PUT /v1/mcp-servers/{mcpServerId} HTTP/1.1
Request parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| body | object | No | The request body. | |
| description | string | No | The description. | Updated MCP server description |
| domainIds | array | No | The domain IDs. | |
| string | No | The domain ID. | d-cr62ts5lhtgln*** | |
| match | HttpRouteMatch | No | The route match rule. | |
| backendConfig | object | No | The backend service configurations for the route. | |
| scene | string | No | The backend service scenario. | SingleService |
| services | array<object> | No | The backend services. | |
| object | No | The backend service. | ||
| protocol | string | No | The service protocol. Valid values:
| HTTP |
| port | integer | No | The service port (omit for dynamic ports). | 8080 |
| weight | integer | No | The traffic weight percentage. | 49 |
| serviceId | string | No | The service ID. | svc-cr6pk4tlhtgm58e*** |
| version | string | No | The service version. | v1 |
| exposedUriPath | string | No | The exposed URI path. This parameter is required when the protocol parameter is set to SSE or StreamableHTTP and the type parameter is set to RealMCP. | /sse |
| assembledSources | array<object> | No | The list of assembly sources. This parameter is required when the type parameter is set to AssemblyMCP. | |
| object | No | The assembly source. This parameter is required when the type parameter is set to AssemblyMCP. | ||
| mcpServerName | string | No | The name of the MCP server. | test-mcp |
| mcpServerId | string | No | The MCP server ID. | mcp-afaefaefaf |
| tools | array | No | The MCP tools. | |
| string | No | The MCP tool. | tool-1 | |
| mcpStatisticsEnable | boolean | No | Specifies if MCP observability is enabled. Default value: false. | false |
| type | string | Yes | The MCP server type. Valid values: RealMCP and AssemblyMCP. | RealMCP |
| protocol | string | Yes | The service protocol. Valid values: HTTP, HTTPS, SSE, and StreamableHTTP. | HTTP |
| createFromType | string | No | Specifies the type of source for MCP server creation. Enumeration Value:
| ApiGatewayMcpHosting |
| grayMcpServerConfigs | array<object> | No | The gray MCP server configurations | |
| object | No | object | ||
| routeId | string | No | The route ID | route-123 |
| match | HttpRouteMatch | No | The route match rules | |
| backendConfig | object | No | The backend configuration | |
| scene | string | No | The backend scene | SingleService |
| services | array<object> | No | The list of backend services | |
| object | No | object | ||
| protocol | string | No | The service protocol | HTTP |
| port | integer | No | The service port | 8080 |
| weight | integer | No | The service weight | 100 |
| serviceId | string | No | The service ID | gray-svc-123 |
| version | string | No | The service version | v1 |
| mcpServerConfig | object | No | The MCP server configuration | |
| swaggerConfig | string | No | The raw swagger/openapi document | swagger-content |
| mcpServerSpec | string | No | The converted mcp server spec yaml | mcp-server-spec-yaml |
| mcpServerId | string | No | The MCP server ID. | mcp-adfefz24afg |
Response parameters
Examples
Sample success responses
JSONformat
{
"requestId": "3ACFC7A7-45A9-58CF-B2D5-765B60254695",
"code": "Ok",
"message": "success"
}Error codes
For a list of error codes, visit the Service error codes.
Change history
| Change time | Summary of changes | Operation |
|---|---|---|
| 2026-01-22 | The internal configuration of the API is changed, but the call is not affected | View Change Details |
| 2025-12-05 | The internal configuration of the API is changed, but the call is not affected | View Change Details |
| 2025-11-06 | The internal configuration of the API is changed, but the call is not affected | View Change Details |