query_api_requests

Query and analyze API requests managed by Kong Konnect Gateway using customizable filters for time range, status codes, HTTP methods, and more. Retrieve detailed request data including latency, consumer IDs, and service routes.

Instructions

Query and analyze Kong API Gateway requests with customizable filters. Before calling this it's necessary to have a controlPlaneID and a serviceID or routeID. These can be obtained using the list-control-planes, list-services, and list-routes tools.

INPUT:

timeRange: String - Time range for data retrieval (15M, 1H, 6H, 12H, 24H, 7D)
statusCodes: Number[] (optional) - Filter by specific HTTP status codes
excludeStatusCodes: Number[] (optional) - Exclude specific HTTP status codes
httpMethods: String[] (optional) - Filter by HTTP methods (e.g., GET, POST)
consumerIds: String[] (optional) - Filter by consumer IDs
serviceIds: String[] (optional) - Filter by service IDs. The format of this field must be "<controlPlaneID>:<serviceID>".
routeIds: String[] (optional) - Filter by route IDs. The format of this field must be "controlPlaneID:routeID"
maxResults: Number - Maximum number of results to return (1-1000)

OUTPUT:

metadata: Object - Contains totalRequests, timeRange, and applied filters
requests: Array - List of request objects with details including:
- requestId: String - Unique request identifier
- timestamp: String - When the request occurred
- httpMethod: String - HTTP method used (GET, POST, etc.)
- uri: String - Request URI path
- statusCode: Number - HTTP status code of the response
- consumerId: String - ID of the consumer making the request
- serviceId: String - ID of the service handling the request
- routeId: String - ID of the matched route
- latency: Object - Response time metrics
- clientIp: String - IP address of the client
- and many more detailed fields...

Input Schema

Name	Required	Description	Default
`consumerIds`	No	Filter by consumer IDs
`excludeStatusCodes`	No	Exclude specific HTTP status codes (e.g. [400, 401, 500])
`httpMethods`	No	Filter by HTTP methods (e.g. ['GET', 'POST', 'DELETE'])
`maxResults`	No	Number of items to return per page
`routeIds`	No	Filter by route IDs (from list-routes tool)
`serviceIds`	No	Filter by service IDs
`statusCodes`	No	Filter by specific HTTP status codes (e.g. [200, 201, 404])
`timeRange`	No	Time range for data retrieval (15M = 15 minutes, 1H = 1 hour, etc.)	1H

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "consumerIds": {
      "description": "Filter by consumer IDs",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "excludeStatusCodes": {
      "description": "Exclude specific HTTP status codes (e.g. [400, 401, 500])",
      "items": {
        "maximum": 599,
        "minimum": 100,
        "type": "integer"
      },
      "type": "array"
    },
    "httpMethods": {
      "description": "Filter by HTTP methods (e.g. ['GET', 'POST', 'DELETE'])",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "maxResults": {
      "default": 100,
      "description": "Number of items to return per page",
      "maximum": 1000,
      "minimum": 1,
      "type": "integer"
    },
    "routeIds": {
      "description": "Filter by route IDs (from list-routes tool)",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "serviceIds": {
      "description": "Filter by service IDs",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "statusCodes": {
      "description": "Filter by specific HTTP status codes (e.g. [200, 201, 404])",
      "items": {
        "maximum": 599,
        "minimum": 100,
        "type": "integer"
      },
      "type": "array"
    },
    "timeRange": {
      "default": "1H",
      "description": "Time range for data retrieval (15M = 15 minutes, 1H = 1 hour, etc.)",
      "enum": [
        "15M",
        "1H",
        "6H",
        "12H",
        "24H",
        "7D"
      ],
      "type": "string"
    }
  },
  "type": "object"
}

Kong Konnect MCP Server

query_api_requests

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Kong Konnect MCP Server

Related Tools