v61

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-08-018131,3812.6 MB
AI Gateway MCP Servers

Update an MCP Server

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 body

OR
OR
OR
OR

Example request

{
  "config": {
    "route": {
      "headers": {
        "version": [
          "v1",
          "v2"
        ]
      },
      "hosts": [
        "foo.example.com"
      ]
    },
    "url": "https://mcp.internal.kongair.com"
  },
  "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.

OR
OR
OR
OR

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"
  },
  "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"
  }
}