Kong Konnect MCP Server tools

Uses: Kong Gateway AI Gateway

Kong’s MCP Server provides a suite of APIs, called MCP tools, for analytics, configuration queries, and Control Plane management. Clients like Claude connect to these APIs through a conversational interface. Instead of writing raw API calls, you describe what you need—such as “show API request trends for the past 24 hours” or “list services in the US-east Control Plane”—and Claude generates the requests and returns structured results.

These tools support filters, flexible time ranges, and detailed queries, giving you precise control over gateway traffic analysis, configuration inventory, and multi-cluster operations. Using Claude, you can troubleshoot issues, audit deployments, and orchestrate Control Planes by simply describing tasks in natural language. See the get started with Kong MCP guide to learn more.

Analytics tools

Analytics tools allow you to query and analyze API request data collected from Kong Gateway deployments connected to MCP. These tools support detailed filtering and flexible time ranges for insight generation.

Tool

Description

Query API Requests Retrieve historical request data across gateways with multiple filters. Analyze trends, diagnose issues, or monitor performance.

Inputs:

  • timeRange: Range of data to query (e.g., 15M, 1H, 24H)
  • statusCodes, excludeStatusCodes: Filter specific HTTP codes
  • httpMethods: Limit to certain methods (e.g., GET, POST)
  • consumerIds, serviceIds, routeIds: Scope data to entities
  • maxResults: Cap the number of returned entries
Get Consumer Requests Analyze API requests made by a specific Consumer, with filters for success/failure and time range.

Inputs:

  • consumerId: Target Consumer
  • timeRange: Time window for analysis
  • successOnly, failureOnly: Optional filters by result type
  • maxResults: Result count limit

Configuration tools

Configuration tools provide read-access to the Kong Gateway resource objects associated with a Control Plane. This allows you to do inventory audits, automation, or UI rendering for dashboards.

Tool

Description

List Services Enumerates all Gateway Services within a specific Control Plane.

Inputs:

  • controlPlaneId: Target Control Plane ID
  • size, offset: Pagination controls
List Routes Lists all Route configurations deployed within a Control Plane.

Inputs:

  • controlPlaneId, size, offset
List Consumers Fetches all Consumer records within a Control Plane.

Inputs:

  • controlPlaneId, size, offset
List Plugins Retrieves all plugins configured under the specified Control Plane.

Inputs:

  • controlPlaneId, size, offset

Control Plane tools

These tools help users manage multiple Control Planes and their organizational relationships. This is useful for environments with many clusters and regional deployments.

Tool

Description

List Control Planes Lists all Control Planes in the organization, with options to filter and sort.

Inputs:

  • pageSize, pageNumber: Pagination
  • filterName, filterClusterType, filterCloudGateway, labels, sort: Query refinement options
Get Control Plane Retrieves detailed metadata about a specific Control Plane.

Inputs:

  • controlPlaneId: Unique ID of the Control Plane
List Control Plane Group Memberships Lists all Control Planes that belong to a specified group.

Inputs:

  • groupId, pageSize, pageAfter
Check Control Plane Group Membership Verifies whether a given Control Plane belongs to any group.

Inputs:

  • controlPlaneId: Control Plane to check
Something wrong?

Help us make these docs great!

Kong Developer docs are open source. If you find these useful and want to make them better, contribute today!