list_routes

Retrieve and manage routes linked to a control plane using controlPlaneId, size, and offset inputs. Output includes route details like protocols, methods, hosts, paths, and associated service IDs for effective configuration and analysis.

Instructions

List all routes associated with a control plane.

INPUT:

controlPlaneId: String - ID of the control plane
size: Number - Number of routes to return (1-1000, default: 100)
offset: String (optional) - Pagination offset token from previous response

OUTPUT:

metadata: Object - Contains controlPlaneId, size, offset, nextOffset, totalCount
routes: Array - List of routes with details for each including:
- routeId: String - Unique identifier for the route
- name: String - Display name of the route
- protocols: Array - Protocols this route accepts (http, https, grpc, etc.)
- methods: Array - HTTP methods this route accepts
- hosts: Array - Hostnames this route matches
- paths: Array - URL paths this route matches
- stripPath: Boolean - Whether to strip the matched path prefix
- preserveHost: Boolean - Whether to preserve the host header
- serviceId: String - ID of the service this route forwards to
- enabled: Boolean - Whether the route is enabled
- metadata: Object - Creation and update timestamps
relatedTools: Array - List of related tools for further analysis

Input Schema

Name	Required	Description
`controlPlaneId`	Yes	Control Plane ID (obtainable from list-control-planes tool)
`offset`	No	Offset token for pagination (from previous response)
`size`	No	Number of routes to return

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "controlPlaneId": {
      "description": "Control Plane ID (obtainable from list-control-planes tool)",
      "type": "string"
    },
    "offset": {
      "description": "Offset token for pagination (from previous response)",
      "type": "string"
    },
    "size": {
      "default": 100,
      "description": "Number of routes to return",
      "maximum": 1000,
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "controlPlaneId"
  ],
  "type": "object"
}

Kong Konnect MCP Server

list_routes

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Kong Konnect MCP Server

Related Tools