{"openapi":"3.1.0","info":{"title":"Kong Konnect (BYOK) API","version":"0.1.0","description":"Kong Konnect (BYOK) lets an AI assistant read your own Kong Konnect data through the Kong Konnect API with a key you supply (Konnect personal or system account access token (US region)). Read-only: 8 tools (list_control_planes, get_control_plane, list_gateway_services, list_routes, list_upstreams, list_plugins, list_consumers, list_data_plane_nodes). The BYOK key travels with each request, is...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-kong-konnect.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-kong-konnect/docs"},"termsOfService":"https://connectorbay.com/byok-kong-konnect/terms"},"servers":[{"url":"https://byok-kong-konnect.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-kong-konnect/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_control_planes":{"post":{"operationId":"list_control_planes","summary":"List the Konnect control planes of the organization with name, description, labels, cluster type and timestamps. Use for","description":"List the Konnect control planes of the organization with name, description, labels, cluster type and timestamps. Use for \"Which Kong Konnect control planes do we have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many control planes per page.","title":"Page Size"},"page_number":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page Number"},"labels":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only control planes with these labels, for example 'env:prod,team' (key:value pairs or bare keys, comma-separated).","title":"Labels"},"sort":{"anyOf":[{"maxLength":50,"type":"string"},{"type":"null"}],"default":null,"description":"Sort attribute; created_at is supported.","title":"Sort"}},"title":"list_control_planesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_control_plane":{"post":{"operationId":"get_control_plane","summary":"Get one control plane: endpoints, cluster type, authentication type and proxy URLs. Use for \"What are the proxy URLs of ","description":"Get one control plane: endpoints, cluster type, authentication type and proxy URLs. Use for \"What are the proxy URLs of Kong control plane prod\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"control_plane_id":{"description":"Control plane id (UUID) from list_control_planes.","maxLength":64,"title":"Control Plane Id","type":"string"}},"required":["control_plane_id"],"title":"get_control_planeArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_gateway_services":{"post":{"operationId":"list_gateway_services","summary":"List gateway services (upstream targets) of a control plane with protocol, host, port, path, timeouts and enabled flag. ","description":"List gateway services (upstream targets) of a control plane with protocol, host, port, path, timeouts and enabled flag. Use for \"Which upstream services does Kong control plane prod route to\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"control_plane_id":{"description":"Control plane id (UUID) from list_control_planes.","maxLength":64,"title":"Control Plane Id","type":"string"},"name_contains":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only items whose name contains this text.","title":"Name Contains"},"size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many items to return (1 to 1000).","title":"Size"},"offset":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Offset from the previous answer's offset field, to get the next page.","title":"Offset"},"tags":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only items carrying these tags; ',' means AND and '/' means OR.","title":"Tags"}},"required":["control_plane_id"],"title":"list_gateway_servicesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_routes":{"post":{"operationId":"list_routes","summary":"List routes of a control plane with the hosts, paths, methods, protocols and the service each one points to. Use for \"Wh","description":"List routes of a control plane with the hosts, paths, methods, protocols and the service each one points to. Use for \"Which Kong routes match /api/orders\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"control_plane_id":{"description":"Control plane id (UUID) from list_control_planes.","maxLength":64,"title":"Control Plane Id","type":"string"},"name_contains":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only items whose name contains this text.","title":"Name Contains"},"size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many items to return (1 to 1000).","title":"Size"},"offset":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Offset from the previous answer's offset field, to get the next page.","title":"Offset"},"tags":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only items carrying these tags; ',' means AND and '/' means OR.","title":"Tags"}},"required":["control_plane_id"],"title":"list_routesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_upstreams":{"post":{"operationId":"list_upstreams","summary":"List upstream load balancer definitions with algorithm, hashing mode and slot count. Use for \"How are Kong upstreams loa","description":"List upstream load balancer definitions with algorithm, hashing mode and slot count. Use for \"How are Kong upstreams load balanced\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"control_plane_id":{"description":"Control plane id (UUID) from list_control_planes.","maxLength":64,"title":"Control Plane Id","type":"string"},"name_contains":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only items whose name contains this text.","title":"Name Contains"},"size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many items to return (1 to 1000).","title":"Size"},"offset":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Offset from the previous answer's offset field, to get the next page.","title":"Offset"},"tags":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only items carrying these tags; ',' means AND and '/' means OR.","title":"Tags"}},"required":["control_plane_id"],"title":"list_upstreamsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_plugins":{"post":{"operationId":"list_plugins","summary":"List plugin instances with name, enabled flag, protocols and the service, route or consumer they are attached to; plugin","description":"List plugin instances with name, enabled flag, protocols and the service, route or consumer they are attached to; plugin configuration values are not requested. Use for \"Which plugins are enabled on Kong control plane prod\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"control_plane_id":{"description":"Control plane id (UUID) from list_control_planes.","maxLength":64,"title":"Control Plane Id","type":"string"},"size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many items to return (1 to 1000).","title":"Size"},"offset":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Offset from the previous answer's offset field, to get the next page.","title":"Offset"},"tags":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only items carrying these tags; ',' means AND and '/' means OR.","title":"Tags"}},"required":["control_plane_id"],"title":"list_pluginsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_consumers":{"post":{"operationId":"list_consumers","summary":"List API consumers with username, custom id and tags (credentials are not requested). Use for \"Which consumers are defin","description":"List API consumers with username, custom id and tags (credentials are not requested). Use for \"Which consumers are defined in Kong control plane prod\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"control_plane_id":{"description":"Control plane id (UUID) from list_control_planes.","maxLength":64,"title":"Control Plane Id","type":"string"},"custom_id":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only the consumer with this custom_id.","title":"Custom Id"},"size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many items to return (1 to 1000).","title":"Size"},"offset":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Offset from the previous answer's offset field, to get the next page.","title":"Offset"},"tags":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only items carrying these tags; ',' means AND and '/' means OR.","title":"Tags"}},"required":["control_plane_id"],"title":"list_consumersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_data_plane_nodes":{"post":{"operationId":"list_data_plane_nodes","summary":"List the data plane nodes connected to a control plane with version, hostname, last ping, config sync state and errors. ","description":"List the data plane nodes connected to a control plane with version, hostname, last ping, config sync state and errors. Use for \"Are all Kong data plane nodes in control plane prod in sync\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"control_plane_id":{"description":"Control plane id (UUID) from list_control_planes.","maxLength":64,"title":"Control Plane Id","type":"string"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many nodes per page.","title":"Page Size"},"page_after":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from page.next of the previous answer.","title":"Page After"}},"required":["control_plane_id"],"title":"list_data_plane_nodesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}