Kong Konnect MCP Server
by
Enables AI assistants to query and analyze Kong Konnect API Gateway configurations, traffic, and analytics through a Model Context Protocol server.
Kong Konnect MCP Server Overview
What is Kong Konnect MCP Server?
Kong Konnect MCP Server provides a set of tools that let AI assistants interact with Kong Konnect’s API Gateway. It exposes operations for querying request analytics, inspecting services, routes, consumers, plugins, and managing control planes, all via natural‑language calls.
How to use Kong Konnect MCP Server?
- Clone and build the repository.
- Set environment variables:
export KONNECT_ACCESS_TOKEN=kpat_api_key_here export KONNECT_REGION=us # optional, defaults to US - Start the server (e.g.,
node build/index.js). - Configure your MCP‑compatible AI client (such as Claude for Desktop) to point to the server by adding an entry in the client’s
claude_desktop_config.json. - Invoke the desired tool by asking the AI assistant natural‑language questions; the assistant will call the corresponding MCP tool on the server.
Key Features of Kong Konnect MCP Server
- Analytics Tools: query API request logs with filters for time range, status codes, HTTP methods, consumers, services, routes, and limit results.
- Configuration Tools: list services, routes, consumers, and plugins for a specific control plane with pagination support.
- Control Plane Management: list all control planes, retrieve detailed information, view group memberships, and check membership status.
- Claude Integration: ready‑to‑use configuration for Claude Desktop, enabling seamless conversational interaction.
- Extensible Architecture: cleanly separated operations, parameter schemas (Zod), and tool definitions for easy addition of new capabilities.
Use Cases of Kong Konnect MCP Server
- Traffic Analysis: ask an AI assistant to surface recent 5xx errors for a service, helping operators quickly spot issues.
- Consumer Troubleshooting: retrieve all requests made by a specific consumer and identify common failure patterns.
- Configuration Audits: list all plugins attached to a control plane to verify compliance or detect misconfigurations.
- Control Plane Inventory: generate a catalog of all control planes across an organization, filtered by region or label.
- Developer Support: embed the server into internal tooling so developers can ask natural‑language questions about API gateway setup without navigating the Konnect UI.
FAQ from the Kong Konnect MCP Server
Q: Which Node.js version is required? A: Node.js 20 or higher.
Q: How do I obtain the KONNECT_ACCESS_TOKEN?
A: Generate a personal access token (PAT) in the Kong Konnect portal under API Access.
Q: What regions are supported?
A: US, EU, AU, ME, IN. The default region is US if KONNECT_REGION is not set.
Q: How are pagination parameters used?
A: Tools that return large lists accept size/pageSize and offset/pageAfter (cursor) parameters to page through results.
Q: Can I add custom tools?
A: Yes. Define new Zod schemas in parameters.ts, add documentation in prompts.ts, implement the logic under operations/, register the tool in tools.ts, and expose it via index.ts.
Q: What should I do if I get connection or authentication errors? A: Verify that the access token is valid and has the required scopes, ensure the correct region is set, and confirm network connectivity to the Konnect API endpoints.
Q: Is there a pre‑built npm package to run the server?
A: The project is intended to be built from source. If a published package becomes available, you could invoke it with npx.
Kong Konnect MCP Server's README
Kong Konnect MCP Server
A Model Context Protocol (MCP) server for interacting with Kong Konnect APIs, allowing AI assistants to query and analyze Kong Gateway configurations, traffic, and analytics.
https://github.com/user-attachments/assets/19c2f716-49b5-46c3-9457-65b3784e2111
Table of Contents
- Overview
- Project Structure
- Installation
- Configuration
- Available Tools
- Usage with Claude
- Example Workflows
- Development
- Troubleshooting
Overview
This project provides a Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with Kong Konnect's API Gateway. It offers a set of tools to query analytics data, inspect configuration details, and manage control planes through natural language conversation.
Key features:
- Query API request analytics with customizable filters
- List and inspect gateway services, routes, consumers, and plugins
- Manage control planes and control plane groups
- Integration with Claude and other MCP-compatible AI assistants
Konnect MCP is a work in progress and we will be adding additional functionality and improvements with each release.
Project Structure
src/
├── index.ts # Main entry point
├── api.ts # Kong API client
├── tools.ts # Tool definitions
├── parameters.ts # Zod schemas for tool parameters
├── prompts.ts # Detailed tool documentation
├── operations/
│ ├── analytics.ts # API request analytics operations
│ ├── configuration.ts # Services, routes, consumers, plugins
│ └── controlPlanes.ts # Control plane management
└── types.ts # Common type definitions
Installation
Prerequisites
- Node.js 20 or higher
- A Kong Konnect account with API access
- A client with MCP capabilities (e.g. Claude Desktop, Cursor, etc...)
Setup
# Clone the repository
git clone https://github.com/Kong/mcp-konnect.git
cd mcp-konnect
# Install dependencies
npm install
# Build the project
npm run build
Configuration
Set the following environment variables to configure the MCP server:
# Required: Your Kong Konnect API key
export KONNECT_ACCESS_TOKEN=kpat_api_key_here
# Optional: The API region to use (defaults to US)
# Possible values: US, EU, AU, ME, IN
export KONNECT_REGION=us
Available Tools
The server provides tools organized in three categories:
Analytics Tools
Query API Requests
Query and analyze Kong API Gateway requests with customizable filters.
Inputs:
- timeRange: Time range for data retrieval (15M, 1H, 6H, 12H, 24H, 7D)
- statusCodes: Filter by specific HTTP status codes
- excludeStatusCodes: Exclude specific HTTP status codes
- httpMethods: Filter by HTTP methods
- consumerIds: Filter by consumer IDs
- serviceIds: Filter by service IDs
- routeIds: Filter by route IDs
- maxResults: Maximum number of results to return
Get Consumer Requests
Analyze API requests made by a specific consumer.
Inputs:
- consumerId: ID of the consumer to analyze
- timeRange: Time range for data retrieval
- successOnly: Show only successful (2xx) requests
- failureOnly: Show only failed (non-2xx) requests
- maxResults: Maximum number of results to return
Configuration Tools
List Services
List all services associated with a control plane.
Inputs:
- controlPlaneId: ID of the control plane
- size: Number of services to return
- offset: Pagination offset token
List Routes
List all routes associated with a control plane.
Inputs:
- controlPlaneId: ID of the control plane
- size: Number of routes to return
- offset: Pagination offset token
List Consumers
List all consumers associated with a control plane.
Inputs:
- controlPlaneId: ID of the control plane
- size: Number of consumers to return
- offset: Pagination offset token
List Plugins
List all plugins associated with a control plane.
Inputs:
- controlPlaneId: ID of the control plane
- size: Number of plugins to return
- offset: Pagination offset token
Control Planes Tools
List Control Planes
List all control planes in your organization.
Inputs:
- pageSize: Number of control planes per page
- pageNumber: Page number to retrieve
- filterName: Filter control planes by name
- filterClusterType: Filter by cluster type
- filterCloudGateway: Filter by cloud gateway capability
- labels: Filter by labels
- sort: Sort field and direction
Get Control Plane
Get detailed information about a specific control plane.
Inputs:
- controlPlaneId: ID of the control plane to retrieve
List Control Plane Group Memberships
List all control planes that are members of a specific group.
Inputs:
- groupId: Control plane group ID
- pageSize: Number of members to return per page
- pageAfter: Cursor for pagination
Check Control Plane Group Membership
Check if a control plane is a member of any group.
Inputs:
- controlPlaneId: Control plane ID to check
Usage with Claude
To use this MCP server with Claude for Desktop:
-
Install Claude for Desktop
-
Create or edit the Claude Desktop configuration file:
- MacOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- MacOS:
-
Add the following configuration:
{
"mcpServers": {
"kong-konnect": {
"command": "node",
"args": [
"/absolute/path/to/mcp-konnect/build/index.js"
],
"env": {
"KONNECT_ACCESS_TOKEN": "kpat_api_key_here",
"KONNECT_REGION": "us"
}
}
}
}
- Restart Claude for Desktop
- The Kong Konnect tools will now be available for Claude to use
Example Workflows
Analyzing API Traffic
-
First, list all control planes:
Please list all control planes in my Kong Konnect organization. -
Then, list services for a specific control plane:
List all services for control plane [CONTROL_PLANE_NAME/ID]. -
Query API requests for a specific service:
Show me all API requests for service [SERVICE_NAME/ID] in the last hour that had 5xx status codes.
Troubleshooting Consumer Issues
-
List consumers for a control plane:
List all consumers for control plane [CONTROL_PLANE_NAME/ID]. -
Analyze requests for a specific consumer:
Show me all requests made by consumer [CONSUMER_NAME/ID] in the last 24 hours. -
Check for common errors or patterns:
What are the most common errors experienced by this consumer?
Development
Adding New Tools
- Define the parameters in
parameters.ts - Add documentation in
prompts.ts - Create the operation logic in the appropriate file in
operations/ - Register the tool in
tools.ts - Handle the tool execution in
index.ts
Troubleshooting
Common Issues
Connection Errors
- Verify your API key is valid and has the necessary permissions
- Check that the API region is correctly specified
- Ensure your network can connect to the Kong Konnect API
Authentication Errors
- Regenerate your API key in the Kong Konnect portal
- Check that environment variables are correctly set
Data Not Found
- Verify the IDs used in requests are correct
- Check that the resources exist in the specified control plane
- Ensure time ranges are valid for analytics queries
Credits
Built by Kong. Inspired by Stripe's Agent Toolkit.
Kong Konnect MCP Server Reviews
Login Required
Please log in to share your review and rating for this MCP.
Actions
Kong Konnect MCP Server's Information
Configuration
{
"mcpServers": {
"kong-konnect": {
"command": "node",
"args": [
"/absolute/path/to/mcp-konnect/build/index.js"
],
"env": {
"KONNECT_ACCESS_TOKEN": "kpat_api_key_here",
"KONNECT_REGION": "us"
}
}
}
}Configure Clients
Similar MCP Servers like Kong Konnect MCP Server
Explore related MCPs that share similar capabilities and solve comparable challenges
Sequential Thinking
Officialby modelcontextprotocol
An MCP server implementation that provides a tool for dynamic and reflective problem-solving through a structured thinking process.
LibreChat
OfficialClientby danny-avila
Provides a self‑hosted ChatGPT‑style interface supporting numerous AI models, agents, code interpreter, image generation, multimodal interactions, and secure multi‑user authentication.
Goose
by block
Automates engineering tasks on local machines, executing code, building projects, debugging, orchestrating workflows, and interacting with external APIs using any LLM.
Roo Code
OfficialClientby RooCodeInc
Provides an autonomous AI coding partner inside the editor that can understand natural language, manipulate files, run commands, browse the web, and be customized via modes and instructions.
Pydantic AI
by pydantic
A Python framework that enables seamless integration of Pydantic validation with large language models, providing type‑safe agent construction, dependency injection, and structured output handling.
Mcp Agent
Clientby lastmile-ai
Build effective agents using Model Context Protocol and simple, composable workflow patterns.
Mcp Use
Clientby mcp-use
A Python SDK that simplifies interaction with MCP servers and enables developers to create custom agents with tool‑calling capabilities.
5ire
Clientby nanbingxyz
A cross‑platform desktop AI assistant that connects to major LLM providers, supports a local knowledge base, and enables tool integration via MCP servers.
Gptme
Clientby gptme
Provides a personal AI assistant that runs directly in the terminal, capable of executing code, manipulating files, browsing the web, using vision, and interfacing with various LLM providers.