list_services

Retrieve and manage a list of services associated with a control plane, including details like ID, host, port, protocol, and timeouts. Supports pagination for efficient data handling.

Instructions

List all services associated with a control plane.

INPUT:

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

OUTPUT:

metadata: Object - Contains controlPlaneId, size, offset, nextOffset, totalCount
services: Array - List of services with details for each including:
- serviceId: String - Unique identifier for the service
- name: String - Display name of the service
- host: String - Target host for the service
- port: Number - Target port for the service
- protocol: String - Protocol used (http, https, grpc, etc.)
- path: String - Path prefix for the service
- retries: Number - Number of retries on failure
- connectTimeout: Number - Connection timeout in milliseconds
- writeTimeout: Number - Write timeout in milliseconds
- readTimeout: Number - Read timeout in milliseconds
- tags: Array - Tags associated with the service
- enabled: Boolean - Whether the service 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 services 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 services to return",
      "maximum": 1000,
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "controlPlaneId"
  ],
  "type": "object"
}

Kong Konnect MCP Server

list_services

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Kong Konnect MCP Server

Related Tools