AccessAudit4

AccessRole4

AccessRoleBinding4

Add-Ons4

AI Gateway Agents4

AI Gateway Auth Strategies4

AI Gateway CA Certificates4

AI Gateway Certificates4

AI Gateway Config Stores8

AI Gateway Consumer Groups6

AI Gateway Consumers7

AI Gateway DataPlane Certificates3

AI Gateway Identity Providers4

AI Gateway MCP Servers4

AI Gateway Model Providers4

AI Gateway Models4

AI Gateway Policies4

AI Gateway SNIs4

AI Gateway Vaults4

AI Gateways4

API4

API Documentation4

API Implementation3

API Publication3

API Specification4

API Version4

Application Registrations4

Applications4

Assets4

Auth Server4

Auth Server Claims4

Auth Server Clients8

Auth Server Scopes4

Auth Server Trusted IdPs3

Dashboards4

Event Gateway Backend Clusters4

Event Gateway DataPlane Certificates4

Event Gateway Listener Policies8

Event Gateway Listeners4

Event Gateway Schema Registries4

Event Gateway Static Keys3

Event Gateway TLS Trust Bundles4

Event Gateway Vaults4

Event Gateway Virtual Cluster Consume Policies20

Event Gateway Virtual Cluster Policies4

Event Gateway Virtual Cluster Produce Policies16

Event Gateway Virtual Clusters4

Event Gateways4

HostnameGenerator4

Kong Identity Directories4

Mesh9

MeshAccessLog4

MeshCircuitBreaker4

MeshExternalService4

MeshFaultInjection4

MeshGateway4

MeshGlobalRateLimit4

MeshHealthCheck4

MeshHTTPRoute4

MeshIdentity4

MeshLoadBalancingStrategy4

MeshMetric4

MeshMultiZoneService4

MeshOPA4

MeshOpenTelemetryBackend4

MeshPassthrough4

MeshProxyPatch4

MeshRateLimit4

MeshRetry4

MeshService4

MeshTCPRoute4

MeshTimeout4

MeshTLS4

MeshTrace4

MeshTrafficPermission4

MeshTrust4

MeshZoneAddress4

Pages4

Personal Access Tokens2

Portal Audit Logs3

Portal Auth Settings9

Portal Custom Domains4

Portal Customization2

Portal Developers4

Portal Team Roles2

Portal Teams4

Portals5

Portals IP Allow List4

Secret4

Snippets4

Workload4

ZoneEgress4

ZoneIngress4

AI Gateway MCP Servers

Update an MCP Server

Changed on Sep 1, 2026

Pre-release Endpoint This endpoint is currently in beta and is subject to change.

Updates the configuration of an existing MCP Server.

put/v1/ai-gateways/{gatewayId}/mcp-servers/{mcpServerIdOrName}

Request

Base URL
https://global.api.konghq.com
Auth
- HTTP bearer
- or HTTP bearer
- or HTTP bearer
- or HTTP bearer
TypeScript
https://skmtc.dev/kong/apis/konnect-api-beta/docs/v1/ai-gateways/:gatewayId/mcp-servers/:mcpServerIdOrName/put.ts
A function with typed inputs. Its response is checked against the schema.

Request body

Example request

{
  "config": {
    "route": {
      "headers": {
        "version": [
          "v1",
          "v2"
        ]
      },
      "hosts": [
        "foo.example.com"
      ]
    },
    "url": "https://mcp.internal.kongair.com",
    "upstream": {
      "auth": {
        "type": "aws",
        "region": "us-east-1",
        "access_key_id": "AKIAIOSFODNN7EXAMPLE"
      }
    }
  },
  "tools": [
    {
      "access": {
        "acls": {
          "allow": [
            "gold-partner"
          ],
          "deny": [
            "bronze-partner"
          ]
        }
      },
      "description": "Search for available flights",
      "parameters": [
        {
          "name": "origin",
          "in": "query",
          "description": "The origin airport code.",
          "required": true
        }
      ]
    }
  ],
  "display_name": "Kong Air Flights",
  "name": "my-entity-name",
  "enabled": true,
  "labels": {
    "category": "finance"
  },
  "managed_by": {
    "owner": "terraform"
  }
}

Response

MCP Server updated successfully.

Example response

{
  "id": "5f9fd312-a987-4628-b4c5-bb4f4fddd5f7",
  "created_at": "2022-11-04T20:10:06.927Z",
  "updated_at": "2022-11-04T20:10:06.927Z",
  "config": {
    "route": {
      "headers": {
        "version": [
          "v1",
          "v2"
        ]
      },
      "hosts": [
        "foo.example.com"
      ]
    },
    "url": "https://mcp.internal.kongair.com",
    "upstream": {
      "auth": {
        "type": "aws",
        "region": "us-east-1",
        "access_key_id": "AKIAIOSFODNN7EXAMPLE"
      }
    }
  },
  "tools": [
    {
      "access": {
        "acls": {
          "allow": [
            "gold-partner"
          ],
          "deny": [
            "bronze-partner"
          ]
        }
      },
      "description": "Search for available flights",
      "parameters": [
        {
          "name": "origin",
          "in": "query",
          "description": "The origin airport code.",
          "required": true
        }
      ]
    }
  ],
  "display_name": "Kong Air Flights",
  "name": "my-entity-name",
  "enabled": true,
  "labels": {
    "category": "finance"
  },
  "managed_by": {
    "owner": "terraform"
  }
}

Changes

Sep 1, 2026cef0f947e9c9 Revision changes
- breaking
  added the new required request property ////
- breaking
  added to the ///// request property allOf list
- breaking
  added to the ///// request property allOf list
- breaking
  added to the ///// request property allOf list
- breaking
  added to the ///// request property allOf list
- breaking
  added to the ///// request property allOf list
- breaking
  the request property //// became required
- breaking
  the request property //// became required
- breaking
  the request property ////// became required
- breaking
  the //// request property's minItems was increased to 1
- breaking
  the //// request property's minItems was increased to 1
- breaking
  added to the response body oneOf list for the response status
- warning
  the ///// request property's max was set to 2147483646.00
- warning
  the ///////// request property's max was set to 2147483646.00
- warning
  the //////// request property's max was set to 2147483646.00
- warning
  the /////// request property's max was set to 2147483646.00
- warning
  the ////// request property's max was set to 2147483646.00
- warning
  the ///// request property's max was set to 2147483646.00
- warning
  the ///////// request property's max was set to 2147483646.00
- warning
  the //////// request property's max was set to 2147483646.00
- warning
  the /////// request property's max was set to 2147483646.00
- warning
  the ////// request property's max was set to 2147483646.00
- warning
  the ///// request property's max was set to 2147483646.00
- warning
  the ///////// request property's max was set to 2147483646.00
- warning
  the //////// request property's max was set to 2147483646.00
- warning
  the /////// request property's max was set to 2147483646.00
- warning
  the ////// request property's max was set to 2147483646.00
- warning
  the ///// request property's max was set to 2147483646.00
- warning
  the ///////// request property's max was set to 2147483646.00
- warning
  the //////// request property's max was set to 2147483646.00
- warning
  the /////// request property's max was set to 2147483646.00
- warning
  the ////// request property's max was set to 2147483646.00
- warning
  the ///// request property's min was set to 0.00
- warning
  the ///////// request property's min was set to 0.00
- warning
  the //////// request property's min was set to 0.00
- warning
  the /////// request property's min was set to 0.00
- warning
  the ////// request property's min was set to 0.00
- warning
  the ///// request property's min was set to 0.00
- warning
  the ///////// request property's min was set to 0.00
- warning
  the //////// request property's min was set to 0.00
- warning
  the /////// request property's min was set to 0.00
- warning
  the ////// request property's min was set to 0.00
- warning
  the ///// request property's min was set to 0.00
- warning
  the ///////// request property's min was set to 0.00
- warning
  the //////// request property's min was set to 0.00
- warning
  the /////// request property's min was set to 0.00
- warning
  the ////// request property's min was set to 0.00
- warning
  the ///// request property's min was set to 0.00
- warning
  the ///////// request property's min was set to 0.00
- warning
  the //////// request property's min was set to 0.00
- warning
  the /////// request property's min was set to 0.00
- warning
  the ////// request property's min was set to 0.00
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property ////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property ////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- warning
  removed the request property //////
- info
  added the new optional request property //////
- info
  added the new optional request property //////
- info
  added the new optional request property //////
- info
  added the new optional request property //////
- info
  added the new optional request property //////
- info
  added the new optional request property //////
- info
  the request property ////// became nullable
- info
  the request property ////// became nullable
- info
  the request property ////// became nullable
- info
  the request property ////// became nullable
- info
  the request property ////// became nullable
- info
  the request property ////// became optional
- info
  request property ////// deprecated
- info
  request property /////// deprecated
- info
  request property ////// deprecated
- info
  request property /////// deprecated
- info
  request property ////// deprecated
- info
  request property /////// deprecated
- info
  request property ////// deprecated
- info
  request property /////// deprecated
- info
  request property ////// deprecated
- info
  request property /////// deprecated
- info
  request property ////// deprecated
- info
  request property /////// deprecated
- info
  mapped value for key conversion-listener changed from to from the response discriminator for the response status
- info
  mapped value for key conversion-only changed from to from the response discriminator for the response status
- info
  mapped value for key listener changed from to from the response discriminator for the response status
- info
  mapped value for key passthrough-listener changed from to from the response discriminator for the response status
- info
  mapped value for key upstream-server changed from to from the response discriminator for the response status
- info
  removed from the response body oneOf list for the response status
Aug 18, 2026658ffb748f95 Revision changes
- info
  endpoint added

Operation history