---
title: "Changes to Create an MCP Server"
method: POST
path: "/v1/ai-gateways/{gatewayId}/mcp-servers"
---

# Changes to Create an MCP Server

`POST /v1/ai-gateways/{gatewayId}/mcp-servers`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 14 of 87 revisions.

- **2026-10-15** `7aab863a6daa`: 1 breaking, 2 warning
- **2026-10-05** `1efb48111817`: 9 breaking, 3 warning, 3 info
- **2026-09-25** `68d43091b84d`: 4 warning
- **2026-09-22** `f82fa1eee23a`: 10 info
- **2026-09-18** `f324fb7610e4`: 7 breaking, 10 warning, 42 info
- **2026-08-27** `7d3c634668f8`: 10 breaking, 161 warning, 9 info
- **2026-08-24** `46dabd88efd3`: 3 breaking, 61 warning, 24 info
- **2026-08-20** `b576ea92fca2`: 1 breaking, 8 warning, 1 info
- **2026-08-12** `b1ea6bd77dec`: 8 info
- **2026-08-11** `4fef3868064f`: 54 breaking, 54 info
- **2026-08-07** `0261aef4b1e2`: 6 breaking, 5 warning, 23 info
- **2026-07-24** `4e8bdd6e0e71`: 8 warning, 8 info
- **2026-07-17** `051ca2cf71d9`: 10 warning
- **2026-07-16** `a2e95e9f6c80`: 1 info

## Changes

- **2026-10-15** `7aab863a6daa`: 1 breaking, 2 warning
  - added `#/components/schemas/InvalidParameterMinimumTime, #/components/schemas/InvalidParameterMaximumTime` to the `invalid_parameters/items/` response property `oneOf` list for the response status `400`
  - added the new `key_invalid` enum value to the `invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
  - added the new `unique` enum value to the `invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
- **2026-10-05** `1efb48111817`: 9 breaking, 3 warning, 3 info
  - the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/access/oneOf[subschema #2: AIGatewayMCPServerBaseACLPropertiesOauth]/access_token_claim_field` request property's minLength was increased from `0` to `1`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/tools/items/name` request property's minLength was increased from `0` to `1`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/tools/items/name` request property's minLength was increased from `0` to `1`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerListener]/access/oneOf[subschema #2: AIGatewayMCPServerBaseACLPropertiesOauth]/access_token_claim_field` request property's minLength was increased from `0` to `1`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/access/oneOf[subschema #2: AIGatewayMCPServerBaseACLPropertiesOauth]/access_token_claim_field` request property's minLength was increased from `0` to `1`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/tools/items/name` request property's minLength was increased from `0` to `1`
  - added the pattern `^[A-Za-z0-9._-]+$` to the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/tools/items/name`
  - added the pattern `^[A-Za-z0-9._-]+$` to the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/tools/items/name`
  - added the pattern `^[A-Za-z0-9._-]+$` to the request property `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/tools/items/name`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/tools/items/name` request property's maxLength was set to `128`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/tools/items/name` request property's maxLength was set to `128`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/tools/items/name` request property's maxLength was set to `128`
  - the `oneOf[subschema #1: AIGatewayMCPServerConversionOnlyResponse]/tools/items/name` response's property pattern `^[A-Za-z0-9._-]+$` was added for the status `201`
  - the `oneOf[subschema #2: AIGatewayMCPServerConversionListenerResponse]/tools/items/name` response's property pattern `^[A-Za-z0-9._-]+$` was added for the status `201`
  - the `oneOf[subschema #5: AIGatewayMCPServerUpstreamServerResponse]/tools/items/name` response's property pattern `^[A-Za-z0-9._-]+$` was added for the status `201`
- **2026-09-25** `68d43091b84d`: 4 warning
  - added the new `400.00` enum value to the `status` response property for the response status `400`
  - added the new `403.00` enum value to the `status` response property for the response status `403`
  - added the new `404.00` enum value to the `status` response property for the response status `404`
  - added the new `409.00` enum value to the `status` response property for the response status `409`
- **2026-09-22** `f82fa1eee23a`: 10 info
  - added the new optional request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/allowed_versions`
  - added the new optional request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/cache`
  - added the new optional request property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/allowed_versions`
  - added the new optional request property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/cache`
  - added the new optional request property `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/config/server/upstream_protocol_version`
  - added the optional property `oneOf[subschema #2: AIGatewayMCPServerConversionListenerResponse]/config/allowed_versions` to the response with the `201` status
  - added the optional property `oneOf[subschema #2: AIGatewayMCPServerConversionListenerResponse]/config/cache` to the response with the `201` status
  - added the optional property `oneOf[subschema #3: AIGatewayMCPServerListenerResponse]/config/allowed_versions` to the response with the `201` status
  - added the optional property `oneOf[subschema #3: AIGatewayMCPServerListenerResponse]/config/cache` to the response with the `201` status
  - added the optional property `oneOf[subschema #5: AIGatewayMCPServerUpstreamServerResponse]/config/server/upstream_protocol_version` to the response with the `201` status
- **2026-09-18** `f324fb7610e4`: 7 breaking, 10 warning, 42 info
  - added `#/components/schemas/AIGatewayLoggingConfig, subschema #1, subschema #3` to the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/logging` request property `allOf` list
  - added `#/components/schemas/AIGatewayLoggingConfig, subschema #1, subschema #3` to the `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/logging` request property `allOf` list
  - the response's body type changed from no type to `object` for status `400`
  - the response's body type changed from no type to `object` for status `403`
  - the response's body type changed from no type to `object` for status `404`
  - the response's body type changed from no type to `object` for status `409`
  - the response's body type changed from no type to `object` for status `429`
  - changed the pattern of the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` from `^[A-Za-z0-9._:-]{1,256}$` to `^[A-Za-z0-9._:@-]{1,256}$`
  - changed the pattern of the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` from `^[A-Za-z0-9._:-]{1,256}$` to `^[A-Za-z0-9._:@-]{1,256}$`
  - changed the pattern of the request property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` from `^[A-Za-z0-9._:-]{1,256}$` to `^[A-Za-z0-9._:@-]{1,256}$`
  - changed the pattern of the request property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/sources/items/` from `^[A-Za-z0-9._:-]{1,256}$` to `^[A-Za-z0-9._:@-]{1,256}$`
  - changed the pattern of the request property `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` from `^[A-Za-z0-9._:-]{1,256}$` to `^[A-Za-z0-9._:@-]{1,256}$`
  - changed the pattern of the request property `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` from `^[A-Za-z0-9._:-]{1,256}$` to `^[A-Za-z0-9._:@-]{1,256}$`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/logging/audits`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/logging/payloads`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/logging/audits`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/logging/payloads`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `400`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `401`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `403`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `404`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `409`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `429`
  - added the optional property `type` to the response with the `400` status
  - added the optional property `type` to the response with the `403` status
  - added the optional property `type` to the response with the `404` status
  - added the optional property `type` to the response with the `409` status
  - added the optional property `type` to the response with the `429` status
  - the response property `detail` became required for the status `401`
  - the response property `instance` became required for the status `401`
  - the response property `status` became required for the status `401`
  - the response property `title` became required for the status `401`
  - the `oneOf[subschema #1: AIGatewayMCPServerConversionOnlyResponse]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` response's property pattern was changed from `^[A-Za-z0-9._:-]{1,256}$` to `^[A-Za-z0-9._:@-]{1,256}$` for the status `201`
  - the `oneOf[subschema #2: AIGatewayMCPServerConversionListenerResponse]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` response's property pattern was changed from `^[A-Za-z0-9._:-]{1,256}$` to `^[A-Za-z0-9._:@-]{1,256}$` for the status `201`
  - the `oneOf[subschema #3: AIGatewayMCPServerListenerResponse]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` response's property pattern was changed from `^[A-Za-z0-9._:-]{1,256}$` to `^[A-Za-z0-9._:@-]{1,256}$` for the status `201`
  - the `oneOf[subschema #3: AIGatewayMCPServerListenerResponse]/sources/items/` response's property pattern was changed from `^[A-Za-z0-9._:-]{1,256}$` to `^[A-Za-z0-9._:@-]{1,256}$` for the status `201`
  - the `oneOf[subschema #4: AIGatewayMCPServerPassthroughListenerResponse]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` response's property pattern was changed from `^[A-Za-z0-9._:-]{1,256}$` to `^[A-Za-z0-9._:@-]{1,256}$` for the status `201`
  - the `oneOf[subschema #5: AIGatewayMCPServerUpstreamServerResponse]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` response's property pattern was changed from `^[A-Za-z0-9._:-]{1,256}$` to `^[A-Za-z0-9._:@-]{1,256}$` for the status `201`
  - added the required property `detail` to the response with the `400` status
  - added the required property `detail` to the response with the `403` status
  - …19 more
- **2026-08-27** `7d3c634668f8`: 10 breaking, 161 warning, 9 info
  - added `#/components/schemas/AIGatewayRouteConfig, subschema #2` to the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/route` request property `allOf` list
  - added `#/components/schemas/AIGatewayRouteConfig, subschema #2` to the `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/config/route` request property `allOf` list
  - added `#/components/schemas/AIGatewayRouteConfig, subschema #2` to the `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/route` request property `allOf` list
  - added `#/components/schemas/AIGatewayRouteConfig, subschema #2` to the `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/config/route` request property `allOf` list
  - added `#/components/schemas/AIGatewayRouteConfig, subschema #2` to the `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/config/route` request property `allOf` list
  - the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/tools` became required
  - the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/tools` became required
  - the request property `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/tools/items/access` became required
  - the response property `oneOf[subschema #5: AIGatewayMCPServerUpstreamServerResponse]/tools/items/description` became optional for the status `201`
  - removed the required property `oneOf[subschema #4: AIGatewayMCPServerPassthroughListenerResponse]/tools/items/description` from the response with the `201` status
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/route/headers`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/route/hosts`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/route/https_redirect_status_code`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/route/methods`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/route/paths`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/route/preserve_host`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/route/protocols`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/route/regex_priority`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/route/request_buffering`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/route/response_buffering`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/route/strip_path`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/route/tags`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/config/route/headers`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/config/route/hosts`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/config/route/https_redirect_status_code`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/config/route/methods`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/config/route/paths`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/config/route/preserve_host`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/config/route/protocols`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/config/route/regex_priority`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/config/route/request_buffering`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/config/route/response_buffering`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/config/route/strip_path`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/config/route/tags`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/route/headers`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/route/hosts`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/route/https_redirect_status_code`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/route/methods`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/route/paths`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/route/preserve_host`
  - …140 more
- **2026-08-24** `46dabd88efd3`: 3 breaking, 61 warning, 24 info
  - the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/tools` request property's minItems was increased to `1`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/tools` request property's minItems was increased to `1`
  - added `#/components/schemas/AIGatewayMCPServerConversionOnlyResponse, #/components/schemas/AIGatewayMCPServerConversionListenerResponse, #/components/schemas/AIGatewayMCPServerListenerResponse, #/components/schemas/AIGatewayMCPServerPassthroughListenerResponse, #/components/schemas/AIGatewayMCPServerUpstreamServerResponse` to the response body `oneOf` list for the response status `201`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/max_request_body_size` request property's max was set to `2147483646.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/route/https_redirect_status_code` request property's max was set to `599.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/route/regex_priority` request property's max was set to `2147483647.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/server/session/redis/cluster/max_redirections` request property's max was set to `2147483646.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/server/session/redis/database` request property's max was set to `2147483646.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/server/session/session_ttl` request property's max was set to `2147483646.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/server/timeout` request property's max was set to `2147483646.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/config/route/https_redirect_status_code` request property's max was set to `599.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/config/route/regex_priority` request property's max was set to `2147483647.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/max_request_body_size` request property's max was set to `2147483646.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/route/https_redirect_status_code` request property's max was set to `599.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/route/regex_priority` request property's max was set to `2147483647.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/server/session/redis/cluster/max_redirections` request property's max was set to `2147483646.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/server/session/redis/database` request property's max was set to `2147483646.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/server/session/session_ttl` request property's max was set to `2147483646.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/server/timeout` request property's max was set to `2147483646.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/config/max_request_body_size` request property's max was set to `2147483646.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/config/route/https_redirect_status_code` request property's max was set to `599.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/config/route/regex_priority` request property's max was set to `2147483647.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/config/server/session/redis/cluster/max_redirections` request property's max was set to `2147483646.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/config/server/session/redis/database` request property's max was set to `2147483646.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/config/server/session/session_ttl` request property's max was set to `2147483646.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/config/server/timeout` request property's max was set to `2147483646.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/config/max_request_body_size` request property's max was set to `2147483646.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/config/route/https_redirect_status_code` request property's max was set to `599.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/config/route/regex_priority` request property's max was set to `2147483647.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/config/server/session/redis/cluster/max_redirections` request property's max was set to `2147483646.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/config/server/session/redis/database` request property's max was set to `2147483646.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/config/server/session/session_ttl` request property's max was set to `2147483646.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/config/server/timeout` request property's max was set to `2147483646.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/max_request_body_size` request property's min was set to `0.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/route/https_redirect_status_code` request property's min was set to `100.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/route/regex_priority` request property's min was set to `-2147483648.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/server/session/redis/cluster/max_redirections` request property's min was set to `0.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/server/session/redis/database` request property's min was set to `0.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/server/session/session_ttl` request property's min was set to `0.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/server/timeout` request property's min was set to `0.00`
  - …48 more
- **2026-08-20** `b576ea92fca2`: 1 breaking, 8 warning, 1 info
  - added the new required request property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/sources`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/server/label`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/server/label`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/config/server/label`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/config/server/label`
  - removed the optional property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/server/label` from the response with the `201` status
  - removed the optional property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/server/label` from the response with the `201` status
  - removed the optional property `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/config/server/label` from the response with the `201` status
  - removed the optional property `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/config/server/label` from the response with the `201` status
  - added the required property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/sources` to the response with the `201` status
- **2026-08-12** `b1ea6bd77dec`: 8 info
  - added the new optional request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/upstream`
  - added the new optional request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/config/upstream`
  - added the new optional request property `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/config/upstream`
  - added the new optional request property `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/config/upstream`
  - added the optional property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/upstream` to the response with the `201` status
  - added the optional property `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/config/upstream` to the response with the `201` status
  - added the optional property `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/config/upstream` to the response with the `201` status
  - added the optional property `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/config/upstream` to the response with the `201` status
- **2026-08-11** `4fef3868064f`: 54 breaking, 54 info
  - the `acl_attribute_type` request property const value `consumer` was added
  - the `acl_attribute_type` request property const value `consumer` was added
  - the `acl_attribute_type` request property const value `consumer` was added
  - the `acl_attribute_type` request property const value `consumer` was added
  - the `acl_attribute_type` request property const value `oauth_access_token` was added
  - the `acl_attribute_type` request property const value `oauth_access_token` was added
  - the `acl_attribute_type` request property const value `oauth_access_token` was added
  - the `acl_attribute_type` request property const value `oauth_access_token` was added
  - the `type` request property const value `aws` was added
  - the `type` request property const value `aws` was added
  - the `type` request property const value `aws` was added
  - the `type` request property const value `aws` was added
  - the `type` request property const value `azure` was added
  - the `type` request property const value `azure` was added
  - the `type` request property const value `azure` was added
  - the `type` request property const value `azure` was added
  - the `type` request property const value `conversion-listener` was added
  - the `type` request property const value `conversion-only` was added
  - the `type` request property const value `credentials` was added
  - the `type` request property const value `gcp` was added
  - the `type` request property const value `gcp` was added
  - the `type` request property const value `gcp` was added
  - the `type` request property const value `gcp` was added
  - the `type` request property const value `jwt` was added
  - the `type` request property const value `listener` was added
  - the `type` request property const value `passthrough-listener` was added
  - the `type` request property const value `upstream-server` was added
  - removed the enum value `aws` of the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/server/session/redis/cloud_authentication/oneOf[subschema #1: AIGatewayRedisAWSAuthentication]/type`
  - removed the enum value `aws` of the request property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/server/session/redis/cloud_authentication/oneOf[subschema #1: AIGatewayRedisAWSAuthentication]/type`
  - removed the enum value `aws` of the request property `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/config/server/session/redis/cloud_authentication/oneOf[subschema #1: AIGatewayRedisAWSAuthentication]/type`
  - removed the enum value `aws` of the request property `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/config/server/session/redis/cloud_authentication/oneOf[subschema #1: AIGatewayRedisAWSAuthentication]/type`
  - removed the enum value `azure` of the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/server/session/redis/cloud_authentication/oneOf[subschema #2: AIGatewayRedisAzureAuthentication]/type`
  - removed the enum value `azure` of the request property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/server/session/redis/cloud_authentication/oneOf[subschema #2: AIGatewayRedisAzureAuthentication]/type`
  - removed the enum value `azure` of the request property `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/config/server/session/redis/cloud_authentication/oneOf[subschema #2: AIGatewayRedisAzureAuthentication]/type`
  - removed the enum value `azure` of the request property `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/config/server/session/redis/cloud_authentication/oneOf[subschema #2: AIGatewayRedisAzureAuthentication]/type`
  - removed the enum value `consumer` of the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/access/oneOf[subschema #1: AIGatewayMCPServerBaseACLPropertiesConsumer]/acl_attribute_type`
  - removed the enum value `consumer` of the request property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/access/oneOf[subschema #1: AIGatewayMCPServerBaseACLPropertiesConsumer]/acl_attribute_type`
  - removed the enum value `consumer` of the request property `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/access/oneOf[subschema #1: AIGatewayMCPServerBaseACLPropertiesConsumer]/acl_attribute_type`
  - removed the enum value `consumer` of the request property `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/access/oneOf[subschema #1: AIGatewayMCPServerBaseACLPropertiesConsumer]/acl_attribute_type`
  - removed the enum value `conversion-listener` of the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/type`
  - …68 more
- **2026-08-07** `0261aef4b1e2`: 6 breaking, 5 warning, 23 info
  - removed `#/components/schemas/AIGatewayMCPServerBaseACLPropertiesConsumer, #/components/schemas/AIGatewayMCPServerBaseACLPropertiesOauth` from the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/access` request property `oneOf` list
  - removed `#/components/schemas/AIGatewayMCPServerBaseACLPropertiesConsumer, #/components/schemas/AIGatewayMCPServerBaseACLPropertiesOauth` from the `oneOf[#/components/schemas/AIGatewayMCPServerListener]/access` request property `oneOf` list
  - removed `#/components/schemas/AIGatewayMCPServerBaseACLPropertiesConsumer, #/components/schemas/AIGatewayMCPServerBaseACLPropertiesOauth` from the `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/access` request property `oneOf` list
  - added `#/components/schemas/AIGatewayMCPServerListenerConsumer, #/components/schemas/AIGatewayMCPServerListenerOauth` to the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/access` response property `oneOf` list for the response status `201`
  - added `#/components/schemas/AIGatewayMCPServerListenerConsumer, #/components/schemas/AIGatewayMCPServerListenerOauth` to the `oneOf[#/components/schemas/AIGatewayMCPServerListener]/access` response property `oneOf` list for the response status `201`
  - added `#/components/schemas/AIGatewayMCPServerListenerConsumer, #/components/schemas/AIGatewayMCPServerListenerOauth` to the `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/access` response property `oneOf` list for the response status `201`
  - changed the pattern of the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$`
  - changed the pattern of the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$`
  - changed the pattern of the request property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$`
  - changed the pattern of the request property `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$`
  - changed the pattern of the request property `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$`
  - mapped value for discriminator key `consumer` changed from `#/components/schemas/AIGatewayMCPServerBaseACLPropertiesConsumer` to `#/components/schemas/AIGatewayMCPServerListenerConsumer` for `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/access` request property
  - mapped value for discriminator key `consumer` changed from `#/components/schemas/AIGatewayMCPServerBaseACLPropertiesConsumer` to `#/components/schemas/AIGatewayMCPServerListenerConsumer` for `oneOf[#/components/schemas/AIGatewayMCPServerListener]/access` request property
  - mapped value for discriminator key `consumer` changed from `#/components/schemas/AIGatewayMCPServerBaseACLPropertiesConsumer` to `#/components/schemas/AIGatewayMCPServerListenerConsumer` for `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/access` request property
  - mapped value for discriminator key `oauth_access_token` changed from `#/components/schemas/AIGatewayMCPServerBaseACLPropertiesOauth` to `#/components/schemas/AIGatewayMCPServerListenerOauth` for `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/access` request property
  - mapped value for discriminator key `oauth_access_token` changed from `#/components/schemas/AIGatewayMCPServerBaseACLPropertiesOauth` to `#/components/schemas/AIGatewayMCPServerListenerOauth` for `oneOf[#/components/schemas/AIGatewayMCPServerListener]/access` request property
  - mapped value for discriminator key `oauth_access_token` changed from `#/components/schemas/AIGatewayMCPServerBaseACLPropertiesOauth` to `#/components/schemas/AIGatewayMCPServerListenerOauth` for `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/access` request property
  - added `#/components/schemas/AIGatewayMCPServerListenerConsumer, #/components/schemas/AIGatewayMCPServerListenerOauth` to the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/access` request property `oneOf` list
  - added `#/components/schemas/AIGatewayMCPServerListenerConsumer, #/components/schemas/AIGatewayMCPServerListenerOauth` to the `oneOf[#/components/schemas/AIGatewayMCPServerListener]/access` request property `oneOf` list
  - added `#/components/schemas/AIGatewayMCPServerListenerConsumer, #/components/schemas/AIGatewayMCPServerListenerOauth` to the `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/access` request property `oneOf` list
  - mapped value for discriminator key `consumer` changed from `#/components/schemas/AIGatewayMCPServerBaseACLPropertiesConsumer` to `#/components/schemas/AIGatewayMCPServerListenerConsumer` for `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/access` response property for the response status `201`
  - mapped value for discriminator key `consumer` changed from `#/components/schemas/AIGatewayMCPServerBaseACLPropertiesConsumer` to `#/components/schemas/AIGatewayMCPServerListenerConsumer` for `oneOf[#/components/schemas/AIGatewayMCPServerListener]/access` response property for the response status `201`
  - mapped value for discriminator key `consumer` changed from `#/components/schemas/AIGatewayMCPServerBaseACLPropertiesConsumer` to `#/components/schemas/AIGatewayMCPServerListenerConsumer` for `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/access` response property for the response status `201`
  - mapped value for discriminator key `oauth_access_token` changed from `#/components/schemas/AIGatewayMCPServerBaseACLPropertiesOauth` to `#/components/schemas/AIGatewayMCPServerListenerOauth` for `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/access` response property for the response status `201`
  - mapped value for discriminator key `oauth_access_token` changed from `#/components/schemas/AIGatewayMCPServerBaseACLPropertiesOauth` to `#/components/schemas/AIGatewayMCPServerListenerOauth` for `oneOf[#/components/schemas/AIGatewayMCPServerListener]/access` response property for the response status `201`
  - mapped value for discriminator key `oauth_access_token` changed from `#/components/schemas/AIGatewayMCPServerBaseACLPropertiesOauth` to `#/components/schemas/AIGatewayMCPServerListenerOauth` for `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/access` response property for the response status `201`
  - removed `#/components/schemas/AIGatewayMCPServerBaseACLPropertiesConsumer, #/components/schemas/AIGatewayMCPServerBaseACLPropertiesOauth` from the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/access` response property `oneOf` list for the response status `201`
  - removed `#/components/schemas/AIGatewayMCPServerBaseACLPropertiesConsumer, #/components/schemas/AIGatewayMCPServerBaseACLPropertiesOauth` from the `oneOf[#/components/schemas/AIGatewayMCPServerListener]/access` response property `oneOf` list for the response status `201`
  - removed `#/components/schemas/AIGatewayMCPServerBaseACLPropertiesConsumer, #/components/schemas/AIGatewayMCPServerBaseACLPropertiesOauth` from the `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/access` response property `oneOf` list for the response status `201`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` response's property pattern was changed from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$` for the status `201`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` response's property pattern was changed from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$` for the status `201`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerListener]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` response's property pattern was changed from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$` for the status `201`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` response's property pattern was changed from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$` for the status `201`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` response's property pattern was changed from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$` for the status `201`
- **2026-07-24** `4e8bdd6e0e71`: 8 warning, 8 info
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/server/tag`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/server/tag`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/config/server/tag`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/config/server/tag`
  - removed the optional property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/server/tag` from the response with the `201` status
  - removed the optional property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/server/tag` from the response with the `201` status
  - removed the optional property `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/config/server/tag` from the response with the `201` status
  - removed the optional property `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/config/server/tag` from the response with the `201` status
  - added the new optional request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/server/label`
  - added the new optional request property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/server/label`
  - added the new optional request property `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/config/server/label`
  - added the new optional request property `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/config/server/label`
  - added the optional property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/server/label` to the response with the `201` status
  - added the optional property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/server/label` to the response with the `201` status
  - added the optional property `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/config/server/label` to the response with the `201` status
  - added the optional property `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/config/server/label` to the response with the `201` status
- **2026-07-17** `051ca2cf71d9`: 10 warning
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/logging/statistics`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/config/logging/statistics`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/logging/statistics`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/config/logging/statistics`
  - removed the request property `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/config/logging/statistics`
  - removed the optional property `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/logging/statistics` from the response with the `201` status
  - removed the optional property `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/config/logging/statistics` from the response with the `201` status
  - removed the optional property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/logging/statistics` from the response with the `201` status
  - removed the optional property `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/config/logging/statistics` from the response with the `201` status
  - removed the optional property `oneOf[#/components/schemas/AIGatewayMCPServerUpstreamServer]/config/logging/statistics` from the response with the `201` status
- **2026-07-16** `a2e95e9f6c80`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/kong/apis/konnect-api-go-sdk/docs/v1/ai-gateways/:gatewayId/mcp-servers/post.md) · [API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) · [Page](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v1/ai-gateways/:gatewayId/mcp-servers/post)