---
title: "Konnect MCP Servers"
url: "https://nov18-dev.movespot.fyi/apis/konnect-mcp-servers-1/versions/46303cfc-2309-46ba-b51e-d1460f58df80"
---

# Konnect MCP Servers

OpenAPI specification document.

```json
{"openapi":"3.0.0","info":{"title":"Konnect MCP Servers","version":"1.0.0","description":"The endpoints for managing MCP Servers in Konnect.\n","contact":{"name":"Kong","url":"https://cloud.konghq.com"}},"servers":[{"url":"https://us.api.konghq.com/v1","description":"United-States Production region"},{"url":"https://eu.api.konghq.com/v1","description":"Europe Production region"},{"url":"https://au.api.konghq.com/v1","description":"Australia Production region"},{"url":"https://me.api.konghq.com/v1","description":"Middle-East Production region"},{"url":"https://in.api.konghq.com/v1","description":"India Production region"},{"url":"https://sg.api.konghq.com/v1","description":"Singapore Production region"}],"paths":{"/mcp-servers":{"get":{"operationId":"list-mcp-server-configs","summary":"List all MCP Servers","description":"**Pre-release Endpoint**\nThis endpoint is currently in beta and is subject to change.\n\nReturns an array of MCP server objects.","parameters":[{"$ref":"#/components/parameters/PageSize"},{"$ref":"#/components/parameters/PageAfter"},{"$ref":"#/components/parameters/MCPServerCommonFilter"}],"responses":{"200":{"$ref":"#/components/responses/ListMCPServersResponse"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}},"tags":["MCP Servers"]},"post":{"operationId":"create-mcp-server-config","summary":"Create an MCP Server","description":"**Pre-release Endpoint**\nThis endpoint is currently in beta and is subject to change.\n\nCreate an MCP Server in the Konnect Organization.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMCPServerRequest"}}}},"responses":{"201":{"$ref":"#/components/responses/CreateMCPServerResponse"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"}},"tags":["MCP Servers"]}},"/mcp-servers/{mcpServerId}":{"parameters":[{"$ref":"#/components/parameters/mcpServerId"}],"get":{"operationId":"get-mcp-server-config","summary":"Get MCP Server","description":"**Pre-release Endpoint**\nThis endpoint is currently in beta and is subject to change.\n\nReturns information about an individual MCP server.","responses":{"200":{"description":"A response to retrieving a single MCP server.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPServerInfo"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}},"tags":["MCP Servers"]},"put":{"operationId":"update-mcp-server-config","summary":"Update MCP Server","description":"**Pre-release Endpoint**\nThis endpoint is currently in beta and is subject to change.\n\nUpdate an individual MCP server.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateMCPServerRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/UpdateMCPServerResponse"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}},"tags":["MCP Servers"]},"patch":{"operationId":"patch-mcp-server-config","summary":"Partially Update MCP Server","description":"**Pre-release Endpoint**\nThis endpoint is currently in beta and is subject to change.\n\nPartially update an individual MCP server.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchMCPServerRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/UpdateMCPServerResponse"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}},"tags":["MCP Servers"]},"delete":{"operationId":"delete-mcp-server-config","summary":"Delete MCP Server","description":"**Pre-release Endpoint**\nThis endpoint is currently in beta and is subject to change.\n\nDelete an MCP server.","responses":{"204":{"description":"Successfully deleted MCP server."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}},"tags":["MCP Servers"]}},"/mcp-servers/{mcpServerId}/status":{"parameters":[{"$ref":"#/components/parameters/mcpServerId"}],"get":{"operationId":"get-mcp-server-status","summary":"Get MCP Server deployment status","description":"**Pre-release Endpoint**\nThis endpoint is currently in beta and is subject to change.\n\nReturns the current aggregated deployment status of an MCP server.","responses":{"200":{"description":"Deployment status of the MCP server.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPServerStatusResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}},"tags":["MCP Servers"]}},"/mcp-servers/{mcpServerId}/tools":{"parameters":[{"$ref":"#/components/parameters/mcpServerId"}],"get":{"operationId":"list-mcp-server-tools","summary":"List MCP Server Tools","description":"**Pre-release Endpoint**\nThis endpoint is currently in beta and is subject to change.\n\nReturns an array of MCP server tool objects.","parameters":[{"$ref":"#/components/parameters/includeLayoutMetadata"},{"$ref":"#/components/parameters/PageSize"},{"$ref":"#/components/parameters/PageAfter"},{"$ref":"#/components/parameters/MCPServerCommonFilter"}],"responses":{"200":{"description":"A response to listing MCP server tools.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListMCPServerToolsResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}},"tags":["MCP Servers"]},"post":{"operationId":"create-mcp-server-tool","summary":"Create MCP Server Tool","description":"**Pre-release Endpoint**\nThis endpoint is currently in beta and is subject to change.\n\nCreate an MCP server tool under the specified MCP server.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPServerToolInput"}}}},"responses":{"201":{"description":"A response to creating an MCP server tool.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPServerTool"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}},"tags":["MCP Servers"]}},"/mcp-servers/{mcpServerId}/tools/{toolId}":{"parameters":[{"$ref":"#/components/parameters/mcpServerId"},{"$ref":"#/components/parameters/mcpServerToolId"}],"get":{"operationId":"get-mcp-server-tool","summary":"Get MCP Server Tool","description":"**Pre-release Endpoint**\nThis endpoint is currently in beta and is subject to change.\n\nReturns information about an individual MCP server tool.","responses":{"200":{"description":"A response to retrieving a single MCP server tool.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPServerTool"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}},"tags":["MCP Servers"]},"put":{"operationId":"update-mcp-server-tool","summary":"Update MCP Server Tool","description":"**Pre-release Endpoint**\nThis endpoint is currently in beta and is subject to change.\n\nUpdate an individual MCP server tool.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPServerToolInput"}}}},"responses":{"200":{"description":"A response to updating an MCP server tool.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPServerTool"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}},"tags":["MCP Servers"]},"patch":{"operationId":"patch-mcp-server-tool","summary":"Partially Update MCP Server Tool","description":"**Pre-release Endpoint**\nThis endpoint is currently in beta and is subject to change.\n\nPartially update an individual MCP server tool.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchMCPServerToolRequest"}}}},"responses":{"200":{"description":"A response to partially updating an MCP server tool.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPServerTool"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}},"tags":["MCP Servers"]},"delete":{"operationId":"delete-mcp-server-tool","summary":"Delete MCP Server Tool","description":"**Pre-release Endpoint**\nThis endpoint is currently in beta and is subject to change.\n\nDelete an MCP server tool under the specified MCP server.","responses":{"204":{"description":"Successfully deleted MCP server tool."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}},"tags":["MCP Servers"]}},"/mcp-cp/{controlPlaneId}/signals":{"parameters":[{"$ref":"#/components/parameters/controlPlaneId"}],"get":{"operationId":"get-mcp-server-signals","summary":"Get MCP Server Signals","description":"**Pre-release Endpoint**\nThis endpoint is currently in beta and is subject to change.\n\nClient-initiated signals fetch with long-polling capabilities.\nThe client supplies `capabilities` as a deepObject query parameter:\n  - Keys are capability names (e.g. `mcp`)\n  - Values contain the capability request fields (`version`)\n\nExample:\n  GET /mcp-cp/{controlPlaneId}/signals?capabilities[mcp][version]=5\n\nThe CP responds with a JSON payload containing zero or more signals that the client should process.\nIf no signals are available, the CP responds with HTTP 304 Not Modified.","parameters":[{"$ref":"#/components/parameters/MCPCapabilities"}],"responses":{"200":{"$ref":"#/components/responses/MCPServerSignalsResponse"},"304":{"description":"No signals available (client is up to date)"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}},"tags":["MCP Servers"]}},"/mcp-cp/{controlPlaneId}/mcp-servers":{"parameters":[{"$ref":"#/components/parameters/controlPlaneId"}],"get":{"operationId":"list-mcp-servers-by-control-plane","summary":"List MCP Servers by Control Plane","description":"**Pre-release Endpoint**\nThis endpoint is currently in beta and is subject to change.\n\nReturns an array of MCP server objects for the specified control plane.","parameters":[{"$ref":"#/components/parameters/PageSize"},{"$ref":"#/components/parameters/PageAfter"},{"$ref":"#/components/parameters/MCPServerCommonFilter"}],"responses":{"200":{"$ref":"#/components/responses/ListMCPServersCPInfoResponse"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}},"tags":["MCP Servers"]}},"/mcp-cp/{controlPlaneId}/mcp-servers/{mcpServerId}":{"parameters":[{"$ref":"#/components/parameters/controlPlaneId"},{"$ref":"#/components/parameters/mcpServerId"}],"get":{"operationId":"get-mcp-server-by-control-plane","summary":"Get MCP Server by Control Plane","description":"**Pre-release Endpoint**\nThis endpoint is currently in beta and is subject to change.\n\nRetrieves an MCP server by its ID within a specific control plane context.","responses":{"200":{"description":"A response to retrieving a single MCP server within a control plane context.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPServerCPInfo"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}},"tags":["MCP Servers"]}},"/mcp-cp/{controlPlaneId}/mcp-servers/{mcpServerId}/kong-entities":{"parameters":[{"$ref":"#/components/parameters/controlPlaneId"},{"$ref":"#/components/parameters/mcpServerId"}],"get":{"operationId":"get-mcp-server-kong-entities","summary":"Get Kong entities for the MCP Server Gateway","description":"**Pre-release Endpoint**\nThis endpoint is currently in beta and is subject to change.\n\nRetrieves Kong entities (Routes, Services, Plugins) for the Gateway in front of the MCP Server.","parameters":[{"name":"runtime_version","in":"query","description":"Kong Gateway runtime version to generate entities for","required":false,"schema":{"type":"string","example":"3.13.0.0"}}],"responses":{"200":{"description":"Kong entities for the MCP server","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KongEntitiesResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}},"tags":["MCP Servers"]}},"/mcp-cp/{controlPlaneId}/mcp-servers/{mcpServerId}/status":{"parameters":[{"$ref":"#/components/parameters/controlPlaneId"},{"$ref":"#/components/parameters/mcpServerId"}],"post":{"operationId":"post-mcp-server-status","summary":"Report MCP Server deployment status","description":"**Pre-release Endpoint**\nThis endpoint is currently in beta and is subject to change.\n\nReports the current deployment status of an MCP server, including replica counts and per-version pod statuses.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPServerStatusRequest"}}}},"responses":{"204":{"description":"Status accepted."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}},"tags":["MCP Servers"]}},"/mcp-cp/{controlPlaneId}/mcp-servers/{mcpServerId}/code":{"parameters":[{"$ref":"#/components/parameters/controlPlaneId"},{"$ref":"#/components/parameters/mcpServerId"}],"get":{"operationId":"get-mcp-server-code","summary":"Get generated Python code for the MCP Server","description":"**Pre-release Endpoint**\nThis endpoint is currently in beta and is subject to change.\n\nGenerates MCP server Python code from the OpenAPI specifications associated with the MCP server.","responses":{"200":{"description":"Generated Python code for the MCP server","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPServerCodeResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}},"tags":["MCP Servers"]}}},"components":{"parameters":{"controlPlaneId":{"name":"controlPlaneId","in":"path","required":true,"schema":{"type":"string","format":"uuid","example":"9524ec7d-36d9-465d-a8c5-83a3c9390458"},"description":"The UUID of your control plane. This variable is available in the Konnect manager."},"includeLayoutMetadata":{"name":"include_layout_metadata","in":"query","required":false,"description":"Determines whether layout metadata is included in the response.","schema":{"type":"boolean","default":false}},"MCPCapabilities":{"name":"capabilities","in":"query","style":"deepObject","explode":true,"description":"Capability requests as a deepObject map.\n- Keys are capability names (e.g. `mcp`).\n- Values contain the capability request fields (`version`).\n","schema":{"$ref":"#/components/schemas/MCPCapabilitiesMap"},"example":{"mcp":{"version":"5"}}},"MCPServerCommonFilter":{"schema":{"type":"object","properties":{"name":{"$ref":"#/components/schemas/StringFieldContainsFilter"}}},"in":"query","name":"filter","description":"Filter documents returned in the response.","required":false,"style":"deepObject"},"mcpServerId":{"name":"mcpServerId","in":"path","required":true,"description":"The ID of the MCP server.","schema":{"type":"string","format":"uuid"}},"mcpServerToolId":{"name":"toolId","in":"path","required":true,"description":"The ID of the MCP server tool.","schema":{"type":"string","format":"uuid"}},"PageAfter":{"name":"page[after]","description":"Request the next page of data, starting with the item after this parameter.","required":false,"in":"query","allowEmptyValue":true,"schema":{"type":"string","example":"ewogICJpZCI6ICJoZWxsbyB3b3JsZCIKfQ"}},"PageSize":{"name":"page[size]","description":"The maximum number of items to include per page. The last page of a collection may include fewer items.","required":false,"in":"query","allowEmptyValue":true,"schema":{"type":"integer","example":10}}},"schemas":{"MCPServerPodsStatus":{"type":"object","properties":{"ready":{"description":"Number of pods in the ready state.","type":"integer","example":2,"minimum":0},"starting":{"description":"Number of pods in the starting state.","type":"integer","example":0,"minimum":0},"failing":{"description":"Number of pods in the failing state.","type":"integer","example":0,"minimum":0}},"required":["ready","starting","failing"]},"MCPServerVersionStatus":{"type":"object","properties":{"version":{"description":"The version identifier of the MCP server deployment.","type":"string","example":"v1"},"desired_replicas":{"description":"The desired number of replicas for this version.","type":"integer","example":2,"minimum":0},"created_replicas":{"description":"The number of replicas that have been created for this version.","type":"integer","example":2,"minimum":0},"pods_status":{"$ref":"#/components/schemas/MCPServerPodsStatus"}},"required":["version","desired_replicas","created_replicas","pods_status"]},"MCPServerStatusRequest":{"description":"List of per-version deployment statuses for the MCP server.\n","type":"array","items":{"$ref":"#/components/schemas/MCPServerVersionStatus"}},"MCPServerStatusResponse":{"type":"object","properties":{"status":{"description":"Aggregated deployment status of the MCP server.\n- `deploying` — single version with desired replicas not yet fully ready.\n- `healthy` — single version running with no failing pods.\n- `pending` — no deployment status has been reported yet.\n- `unhealthy` — one or more failing pods across any version.\n- `upgrading` — multiple versions running with no failing pods.","type":"string","example":"healthy","enum":["deploying","healthy","pending","unhealthy","upgrading"]}},"required":["status"]},"MCPServerInfo":{"type":"object","properties":{"id":{"description":"The unique identifier for the MCP server.","type":"string","format":"uuid"},"name":{"description":"The name of the MCP server.","type":"string","maxLength":256,"minLength":1},"description":{"description":"A description of the MCP server.","type":"string","maxLength":1024},"labels":{"description":"Labels for the MCP server.","type":"object","additionalProperties":{"type":"string"}},"deployed_at":{"description":"The timestamp when the MCP server was deployed.","type":"string","format":"date-time"},"control_plane_id":{"description":"The control plane ID associated with the MCP server.","type":"string","format":"uuid","nullable":true},"resource_id":{"description":"The MCP resource ID associated with the MCP server.","type":"string","format":"uuid","nullable":true},"version":{"description":"The version of the MCP server.","type":"string"},"created_at":{"$ref":"#/components/schemas/CreatedAt"},"updated_at":{"$ref":"#/components/schemas/UpdatedAt"}},"required":["id","name","created_at","updated_at","version"]},"ContainerSpec":{"type":"object","properties":{"image":{"description":"The container image to use.","type":"string"}}},"MCPServerCPInfo":{"allOf":[{"$ref":"#/components/schemas/MCPServerInfo"},{"type":"object","properties":{"container":{"allOf":[{"$ref":"#/components/schemas/ContainerSpec"},{"description":"Configuration for the main container."}]},"init_container":{"allOf":[{"$ref":"#/components/schemas/ContainerSpec"},{"description":"Configuration for the init container."}]}}}]},"CreateMCPServerRequest":{"type":"object","properties":{"name":{"description":"The name of the MCP server.","type":"string","maxLength":256,"minLength":1},"description":{"description":"A description of the MCP server.","type":"string","maxLength":1024},"labels":{"description":"Labels for the MCP server.","type":"object","additionalProperties":{"type":"string"}},"control_plane_id":{"description":"The control plane ID associated with the MCP server.","type":"string","format":"uuid","nullable":true},"resource_id":{"description":"The MCP resource ID associated with the MCP server.","type":"string","format":"uuid","nullable":true}},"required":["name"]},"UpdateMCPServerRequest":{"type":"object","properties":{"name":{"description":"The name of the MCP server.","type":"string","maxLength":256,"minLength":1},"description":{"description":"A description of the MCP server.","type":"string","maxLength":1024},"labels":{"description":"Labels for the MCP server.","type":"object","additionalProperties":{"type":"string"}},"control_plane_id":{"description":"The control plane ID associated with the MCP server.","type":"string","format":"uuid","nullable":true},"resource_id":{"description":"The MCP resource ID associated with the MCP server.","type":"string","format":"uuid","nullable":true}},"required":["name"]},"PatchMCPServerRequest":{"type":"object","properties":{"name":{"description":"The name of the MCP server.","type":"string","maxLength":256,"minLength":1},"description":{"description":"A description of the MCP server.","type":"string","maxLength":1024,"nullable":true},"labels":{"description":"Labels for the MCP server.","type":"object","additionalProperties":{"type":"string"},"nullable":true},"deployed_at":{"description":"The timestamp when the MCP server was deployed.","type":"string","format":"date-time","nullable":true},"control_plane_id":{"description":"The control plane ID associated with the MCP server.","type":"string","format":"uuid","nullable":true},"resource_id":{"description":"The MCP resource ID associated with the MCP server.","type":"string","format":"uuid","nullable":true}}},"ListMCPServersResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/MCPServerInfo"}},"meta":{"$ref":"#/components/schemas/CursorMeta"}},"required":["data","meta"]},"ListMCPServersCPInfoResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/MCPServerCPInfo"}},"meta":{"$ref":"#/components/schemas/CursorMeta"}},"required":["data","meta"]},"ListMCPServerToolsResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/MCPServerTool"}},"meta":{"$ref":"#/components/schemas/CursorMeta"}},"required":["data","meta"]},"MCPServerToolInput":{"type":"object","properties":{"name":{"description":"The unique name of the MCP server tool.","type":"string","maxLength":255,"minLength":1,"pattern":"^[\\w_-]+$"},"state":{"$ref":"#/components/schemas/MCPServerToolState"},"definition":{"$ref":"#/components/schemas/MCPToolDefinition"},"definition_draft":{"$ref":"#/components/schemas/MCPToolDefinition"},"layout_metadata":{"description":"Layout metadata for the MCP server tool.","type":"object","additionalProperties":true}},"required":["name"]},"PatchMCPServerToolRequest":{"type":"object","properties":{"name":{"description":"The unique name of the MCP server tool.","type":"string","maxLength":255,"minLength":1,"pattern":"^[\\w_-]+$"},"state":{"$ref":"#/components/schemas/MCPServerToolState"},"definition":{"$ref":"#/components/schemas/MCPToolDefinition"},"definition_draft":{"$ref":"#/components/schemas/MCPToolDefinition"},"layout_metadata":{"description":"Layout metadata for the MCP server tool.","type":"object","additionalProperties":true,"nullable":true}}},"MCPToolDefinition":{"type":"array","items":{"type":"object","additionalProperties":true}},"MCPServerTool":{"allOf":[{"$ref":"#/components/schemas/MCPServerToolInput"},{"type":"object","required":["id","created_at","updated_at"],"properties":{"id":{"description":"The unique identifier for the MCP server tool.","type":"string","format":"uuid"},"created_at":{"$ref":"#/components/schemas/CreatedAt"},"updated_at":{"$ref":"#/components/schemas/UpdatedAt"}}}]},"MCPServerToolState":{"description":"The state of the MCP server tool.","type":"string","default":"draft","enum":["draft","published"]},"KongEntitiesResponse":{"type":"object","properties":{"routes":{"type":"array","items":{"$ref":"#/components/schemas/KongRoute"}},"services":{"type":"array","items":{"$ref":"#/components/schemas/KongService"}}},"required":["routes","services"]},"KongService":{"type":"object","properties":{"id":{"description":"Service ID","type":"string","format":"uuid"},"name":{"description":"Service name","type":"string","example":"mcp-test-service"},"protocol":{"description":"The protocol used to communicate with the Service.","type":"string","example":"https"},"host":{"description":"Service host","type":"string","example":"mcp-test-service.svc.cluster.local"},"port":{"description":"Service port","type":"integer","example":80,"maximum":65535,"minimum":1},"path":{"description":"Service path","type":"string","example":"/"}},"required":["name","protocol","host","port","path"]},"KongRoute":{"type":"object","properties":{"id":{"description":"Route ID","type":"string","format":"uuid"},"name":{"description":"Route name","type":"string","example":"mcp-test-route-jsonrpc"},"service":{"description":"Reference to the service","type":"object","properties":{"id":{"type":"string","format":"uuid"}}},"paths":{"description":"Request paths","type":"array","items":{"type":"string"},"example":["/mcp/test-service"]},"methods":{"description":"HTTP methods","type":"array","items":{"type":"string"},"example":["POST"]}},"required":["name","paths","methods"]},"MCPServerCodeResponse":{"type":"object","properties":{"code":{"description":"Generated Python code for the MCP server implementation","type":"string","example":"print(\"Hello MCP\")"}},"required":["code"]},"MCPCapabilitiesMap":{"description":"Map of capability name -> capability request fields.\n\nExample:\n  {\n    \"mcp\": { \"version\": \"v1\", \"offset\": \"5\" }\n  }\n","type":"object","properties":{"mcp":{"$ref":"#/components/schemas/MCPCapabilityRequest"}}},"MCPCapabilityRequest":{"type":"object","properties":{"version":{"description":"The version of the capability schema (e.g., v1).","type":"string"},"offset":{"description":"The version of the control plane known by the client.","type":"string"}},"additionalProperties":false,"required":["version"]},"MCPServerSignalV1":{"description":"Signal notifying the client that the MCP control plane config has changed.\n","type":"object","properties":{"type":{"type":"string","enum":["mcp"]},"version":{"description":"The current version of the MCP control plane.","type":"string"},"offset":{"description":"The offset for the MCP signal.","type":"string"}},"example":{"type":"mcp","version":"v1","offset":"6"},"additionalProperties":false,"required":["type","version","offset"]},"MCPServerSignal":{"description":"A single signal envelope containing exactly one typed capability signal.","discriminator":{"propertyName":"type","mapping":{"mcp":"#/components/schemas/MCPServerSignalV1"}},"oneOf":[{"$ref":"#/components/schemas/MCPServerSignalV1"}]},"MCPServerSignals":{"description":"The MCP server signals response.","type":"object","properties":{"signals":{"description":"A list of signals for the MCP server.","type":"array","items":{"$ref":"#/components/schemas/MCPServerSignal"}}},"required":["signals"]},"StringFieldContainsFilter":{"description":"Filters on the given string field value by fuzzy match.","type":"object","properties":{"contains":{"type":"string"}},"additionalProperties":false,"required":["contains"],"title":"StringFieldContainsFilter","x-examples":{"example-1":{"contains":"some-value"}}},"CreatedAt":{"description":"An ISO-8601 timestamp representation of entity creation date.","type":"string","format":"date-time","example":"2022-11-04T20:10:06.927Z","readOnly":true},"UpdatedAt":{"description":"An ISO-8601 timestamp representation of entity update date.","type":"string","format":"date-time","example":"2022-11-04T20:10:06.927Z","readOnly":true},"CursorMetaPage":{"type":"object","properties":{"first":{"description":"URI to the first page","type":"string","format":"path"},"last":{"description":"URI to the last page","type":"string","format":"path"},"next":{"description":"URI to the next page","type":"string","format":"path","nullable":true},"previous":{"description":"URI to the previous page","type":"string","format":"path","nullable":true},"size":{"description":"Requested page size","type":"number","example":10}},"required":["size","next","previous"]},"CursorMeta":{"description":"Pagination metadata.","type":"object","properties":{"page":{"$ref":"#/components/schemas/CursorMetaPage"}},"required":["page"]},"BaseError":{"description":"standard error","type":"object","properties":{"status":{"description":"The HTTP status code of the error. Useful when passing the response\nbody to child properties in a frontend UI. Must be returned as an integer.\n","type":"integer","readOnly":true},"title":{"description":"A short, human-readable summary of the problem. It should not\nchange between occurences of a problem, except for localization.\nShould be provided as \"Sentence case\" for direct use in the UI.\n","type":"string","readOnly":true},"type":{"description":"The error type.","type":"string","readOnly":true},"instance":{"description":"Used to return the correlation ID back to the user, in the format\nkong:trace:<correlation_id>. This helps us find the relevant logs\nwhen a customer reports an issue.\n","type":"string","readOnly":true},"detail":{"description":"A human readable explanation specific to this occurence of the problem.\nThis field may contain request/entity data to help the user understand\nwhat went wrong. Enclose variable values in square brackets. Should be\nprovided as \"Sentence case\" for direct use in the UI.\n","type":"string","readOnly":true}},"required":["status","title","instance","detail"],"title":"Error"},"InvalidRules":{"description":"invalid parameters rules","type":"string","enum":["required","is_array","is_base64","is_boolean","is_date_time","is_integer","is_null","is_number","is_object","is_string","is_uuid","is_fqdn","is_arn","unknown_property","missing_reference","is_label","matches_regex","invalid","is_supported_network_availability_zone_list","is_supported_network_cidr_block","is_supported_provider_region","type"],"nullable":true,"readOnly":true},"InvalidParameterStandard":{"type":"object","properties":{"field":{"type":"string","example":"name","readOnly":true},"rule":{"$ref":"#/components/schemas/InvalidRules"},"source":{"type":"string","example":"body"},"reason":{"type":"string","example":"is a required field","readOnly":true}},"additionalProperties":false,"required":["field","reason"]},"InvalidParameterMinimumLength":{"type":"object","properties":{"field":{"type":"string","example":"name","readOnly":true},"rule":{"description":"invalid parameters rules","type":"string","enum":["min_length","min_digits","min_lowercase","min_uppercase","min_symbols","min_items","min"],"nullable":false,"readOnly":true},"minimum":{"type":"integer","example":8},"source":{"type":"string","example":"body"},"reason":{"type":"string","example":"must have at least 8 characters","readOnly":true}},"additionalProperties":false,"required":["field","reason","rule","minimum"]},"InvalidParameterMaximumLength":{"type":"object","properties":{"field":{"type":"string","example":"name","readOnly":true},"rule":{"description":"invalid parameters rules","type":"string","enum":["max_length","max_items","max"],"nullable":false,"readOnly":true},"maximum":{"type":"integer","example":8},"source":{"type":"string","example":"body"},"reason":{"type":"string","example":"must not have more than 8 characters","readOnly":true}},"additionalProperties":false,"required":["field","reason","rule","maximum"]},"InvalidParameterChoiceItem":{"type":"object","properties":{"field":{"type":"string","example":"name","readOnly":true},"rule":{"description":"invalid parameters rules","type":"string","enum":["enum"],"nullable":false,"readOnly":true},"reason":{"type":"string","example":"is a required field","readOnly":true},"choices":{"type":"array","items":{},"minItems":1,"nullable":false,"readOnly":true,"uniqueItems":true},"source":{"type":"string","example":"body"}},"additionalProperties":false,"required":["field","reason","rule","choices"]},"InvalidParameterDependentItem":{"type":"object","properties":{"field":{"type":"string","example":"name","readOnly":true},"rule":{"description":"invalid parameters rules","type":"string","enum":["dependent_fields"],"nullable":true,"readOnly":true},"reason":{"type":"string","example":"is a required field","readOnly":true},"dependents":{"type":"array","items":{},"nullable":true,"readOnly":true,"uniqueItems":true},"source":{"type":"string","example":"body"}},"additionalProperties":false,"required":["field","rule","reason","dependents"]},"InvalidParameters":{"description":"invalid parameters","type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/InvalidParameterStandard"},{"$ref":"#/components/schemas/InvalidParameterMinimumLength"},{"$ref":"#/components/schemas/InvalidParameterMaximumLength"},{"$ref":"#/components/schemas/InvalidParameterChoiceItem"},{"$ref":"#/components/schemas/InvalidParameterDependentItem"}]},"minItems":1,"nullable":false,"uniqueItems":true},"BadRequestError":{"allOf":[{"$ref":"#/components/schemas/BaseError"},{"type":"object","required":["invalid_parameters"],"properties":{"invalid_parameters":{"$ref":"#/components/schemas/InvalidParameters"}}}]},"UnauthorizedError":{"allOf":[{"$ref":"#/components/schemas/BaseError"},{"type":"object","properties":{"status":{"example":401},"title":{"example":"Unauthorized"},"type":{"example":"https://httpstatuses.com/401"},"instance":{"example":"kong:trace:1234567890"},"detail":{"example":"Invalid credentials"}}}]},"ForbiddenError":{"allOf":[{"$ref":"#/components/schemas/BaseError"},{"type":"object","properties":{"status":{"example":403},"title":{"example":"Forbidden"},"type":{"example":"https://httpstatuses.com/403"},"instance":{"example":"kong:trace:1234567890"},"detail":{"example":"Forbidden"}}}]},"ConflictError":{"allOf":[{"$ref":"#/components/schemas/BaseError"},{"type":"object","properties":{"status":{"example":409},"title":{"example":"Conflict"},"type":{"example":"https://httpstatuses.com/409"},"instance":{"example":"kong:trace:1234567890"},"detail":{"example":"Conflict"}}}]},"NotFoundError":{"allOf":[{"$ref":"#/components/schemas/BaseError"},{"type":"object","properties":{"status":{"example":404},"title":{"example":"Not Found"},"type":{"example":"https://httpstatuses.com/404"},"instance":{"example":"kong:trace:1234567890"},"detail":{"example":"Not found"}}}]}},"examples":{"UnauthorizedExample":{"value":{"status":401,"title":"Unauthorized","instance":"kong:trace:8347343766220159418","detail":"Unauthorized"}},"ForbiddenExample":{"value":{"status":403,"title":"Forbidden","instance":"kong:trace:2723154947768991354","detail":"You do not have permission to perform this action"}},"NotFoundExample":{"value":{"status":404,"title":"Not Found","instance":"kong:trace:6816496025408232265","detail":"Not Found"}}},"responses":{"MCPServerSignalsResponse":{"description":"The MCP server signals response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPServerSignals"}}}},"ListMCPServersResponse":{"description":"A response to listing MCP servers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListMCPServersResponse"}}}},"CreateMCPServerResponse":{"description":"A response to creating an MCP server.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPServerInfo"}}}},"ListMCPServersCPInfoResponse":{"description":"A response to listing MCP servers with CP info.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListMCPServersCPInfoResponse"}}}},"UpdateMCPServerResponse":{"description":"A response to updating an MCP server.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPServerInfo"}}}},"BadRequest":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"Unauthorized":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"},"examples":{"UnauthorizedExample":{"$ref":"#/components/examples/UnauthorizedExample"}}}}},"Forbidden":{"description":"Forbidden","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"},"examples":{"UnauthorizedExample":{"$ref":"#/components/examples/ForbiddenExample"}}}}},"Conflict":{"description":"Conflict","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ConflictError"}}}},"NotFound":{"description":"Not Found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/NotFoundError"},"examples":{"NotFoundExample":{"$ref":"#/components/examples/NotFoundExample"}}}}}},"securitySchemes":{"personalAccessToken":{"type":"http","scheme":"bearer","bearerFormat":"Token","description":"The personal access token is meant to be used as an alternative to basic-auth when accessing Konnect via APIs.\nYou can generate a Personal Access Token (PAT) from the [personal access token page](https://cloud.konghq.com/global/account/tokens/) in the Konnect dashboard.\nThe PAT token must be passed in the header of a request, for example:\n`curl -X GET 'https://global.api.konghq.com/v2/users/' --header 'Authorization: Bearer kpat_xgfT...'`\n"},"systemAccountAccessToken":{"type":"http","scheme":"bearer","bearerFormat":"Token","description":"The system account access token is meant for automations and integrations that are not directly associated with a human identity.\nYou can generate a system account Access Token by creating a system account and then obtaining a system account access token for that account.\nThe access token must be passed in the header of a request, for example:\n`curl -X GET 'https://global.api.konghq.com/v2/users/' --header 'Authorization: Bearer spat_i2Ej...'`\n"}}},"tags":[{"name":"MCP Servers"}],"security":[{"personalAccessToken":[]},{"systemAccountAccessToken":[]}]}
```
