kong konnect.com
kong konnect.com logo

Kong Konnect

Integrates with Kong API Gateway to enable management and analysis of API configurations, traffic patterns, and control...

Created byApr 22, 2025

Kong Konnect MCP Server

Static Badge
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.

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

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

Configuration

Set the following environment variables to configure the MCP server:

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.

Get Consumer Requests

Analyze API requests made by a specific consumer.

Configuration Tools

List Services

List all services associated with a control plane.

List Routes

List all routes associated with a control plane.

List Consumers

List all consumers associated with a control plane.

List Plugins

List all plugins associated with a control plane.

Control Planes Tools

List Control Planes

List all control planes in your organization.

Get Control Plane

Get detailed information about a specific control plane.

List Control Plane Group Memberships

List all control planes that are members of a specific group.

Check Control Plane Group Membership

Check if a control plane is a member of any group.

Usage with Claude

To use this MCP server with Claude for Desktop:
  1. Install Claude for Desktop
  1. Create or edit the Claude Desktop configuration file:
  1. Add the following configuration:
  1. Restart Claude for Desktop
  1. The Kong Konnect tools will now be available for Claude to use

Example Workflows

Analyzing API Traffic

  1. First, list all control planes:
  1. Then, list services for a specific control plane:
  1. Query API requests for a specific service:

Troubleshooting Consumer Issues

  1. List consumers for a control plane:
  1. Analyze requests for a specific consumer:
  1. Check for common errors or patterns:

Development

Adding New Tools

  1. Define the parameters in parameters.ts
  1. Add documentation in prompts.ts
  1. Create the operation logic in the appropriate file in operations/
  1. Register the tool in tools.ts
  1. 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

Static Badge
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.

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

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

Configuration

Set the following environment variables to configure the MCP server:

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.

Get Consumer Requests

Analyze API requests made by a specific consumer.

Configuration Tools

List Services

List all services associated with a control plane.

List Routes

List all routes associated with a control plane.

List Consumers

List all consumers associated with a control plane.

List Plugins

List all plugins associated with a control plane.

Control Planes Tools

List Control Planes

List all control planes in your organization.

Get Control Plane

Get detailed information about a specific control plane.

List Control Plane Group Memberships

List all control planes that are members of a specific group.

Check Control Plane Group Membership

Check if a control plane is a member of any group.

Usage with Claude

To use this MCP server with Claude for Desktop:
  1. Install Claude for Desktop
  1. Create or edit the Claude Desktop configuration file:
  1. Add the following configuration:
  1. Restart Claude for Desktop
  1. The Kong Konnect tools will now be available for Claude to use

Example Workflows

Analyzing API Traffic

  1. First, list all control planes:
  1. Then, list services for a specific control plane:
  1. Query API requests for a specific service:

Troubleshooting Consumer Issues

  1. List consumers for a control plane:
  1. Analyze requests for a specific consumer:
  1. Check for common errors or patterns:

Development

Adding New Tools

  1. Define the parameters in parameters.ts
  1. Add documentation in prompts.ts
  1. Create the operation logic in the appropriate file in operations/
  1. Register the tool in tools.ts
  1. 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.