---
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 2 of 30 revisions.

- **2026-09-01** `cef0f947e9c9`: 12 breaking, 126 warning, 30 info
- **2026-08-18** `658ffb748f95`: 1 info

## Changes

- **2026-09-01** `cef0f947e9c9`: 12 breaking, 126 warning, 30 info
  - added the new required request property `oneOf[#/components/schemas/AIGatewayMCPServerListener]/sources`
  - added `#/components/schemas/AIGatewayRouteConfig` to the `oneOf[#/components/schemas/AIGatewayMCPServerConversionListener]/config/route` request property `allOf` list
  - added `#/components/schemas/AIGatewayRouteConfig` to the `oneOf[#/components/schemas/AIGatewayMCPServerConversionOnly]/config/route` request property `allOf` list
  - added `#/components/schemas/AIGatewayRouteConfig` to the `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/route` request property `allOf` list
  - added `#/components/schemas/AIGatewayRouteConfig` to the `oneOf[#/components/schemas/AIGatewayMCPServerPassthroughListener]/config/route` request property `allOf` list
  - added `#/components/schemas/AIGatewayRouteConfig` 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 `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/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/AIGatewayMCPServerListener]/config/max_request_body_size` request property's max was set to `2147483646.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/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/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/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`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/max_request_body_size` request property's min was set to `0.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/server/session/redis/cluster/max_redirections` request property's min was set to `0.00`
  - the `oneOf[#/components/schemas/AIGatewayMCPServerListener]/config/server/session/redis/database` request property's min was set to `0.00`
  - …128 more
- **2026-08-18** `658ffb748f95`: 1 info
  - endpoint added

---

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