Kong Konnect MCP Server

Instructions

Implementation Reference

• src/operations/controlPlanes.ts:70-104 (handler)

  Core handler function that executes the get_control_plane tool logic: fetches control plane details via API and transforms response for consistent output.
  export async function getControlPlane( api: KongApi, controlPlaneId: string ) { try { const result = await api.getControlPlane(controlPlaneId); // Transform the response to have consistent field names const cp = result.data; return { controlPlaneDetails: { controlPlaneId: cp.id, name: cp.name, description: cp.description, type: cp.type, clusterType: cp.cluster_type, controlPlaneEndpoint: cp.control_plane_endpoint, telemetryEndpoint: cp.telemetry_endpoint, hasCloudGateway: cp.has_cloud_gateway, labels: cp.labels, metadata: { createdAt: cp.created_at, updatedAt: cp.updated_at } }, relatedTools: [ "Use list-services to see services configured in this control plane", "Use list-routes to see routes configured in this control plane", "Use query-api-requests to analyze traffic for this control plane" ] }; } catch (error) { throw error; } }
• src/parameters.ts:144-147 (schema)

  Zod schema defining the input parameters for the get_control_plane tool: requires controlPlaneId string.
  export const getControlPlaneParameters = () => z.object({ controlPlaneId: z.string() .describe("Control Plane ID (obtainable from list-control-planes tool)"), });
• src/tools.ts:74-80 (registration)

  Tool definition object used for registering the get_control_plane tool, including method name, description, parameters schema, and category.
  { method: "get_control_plane", name: "Get Control Plane", description: prompts.getControlPlanePrompt(), parameters: parameters.getControlPlaneParameters(), category: "control_planes" },
• src/index.ts:124-129 (handler)

  Dispatcher logic in the main MCP tool handler that routes get_control_plane calls to the specific controlPlanes.getControlPlane implementation.
  case "get_control_plane": result = await controlPlanes.getControlPlane( this.api, args.controlPlaneId ); break;
• src/prompts.ts:178-197 (helper)

  Prompt template providing description and expected input/output format for the get_control_plane tool.
  export const getControlPlanePrompt = () => ` Get detailed information about a specific control plane. INPUT: - controlPlaneId: String - ID of the control plane to retrieve OUTPUT: - controlPlaneDetails: Object - Detailed information including: - controlPlaneId: String - Unique identifier for the control plane - name: String - Display name of the control plane - description: String - Description of the control plane - type: String - Type of the control plane - clusterType: String - Underlying cluster type - controlPlaneEndpoint: String - URL endpoint for the control plane - telemetryEndpoint: String - URL endpoint for telemetry - hasCloudGateway: Boolean - Whether cloud gateway is enabled - labels: Object - Labels assigned to this control plane - metadata: Object - Creation and update timestamps - relatedTools: Array - List of related tools for further analysis `;