Kong Konnect Gateway

v1.0.0APIsstable

A Model Context Protocol server enabling AI assistants to interact with Kong Konnect's API Gateway, providing tools to query analytics data, inspect configurations, and manage control planes through natural language.

agentsaiapikongkonnect
Share:
42
Stars
0
Downloads
0
Weekly
0/5

What is Kong Konnect Gateway?

Kong Konnect Gateway is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol server enabling ai assistants to interact with kong konnect's api gateway, providing tools to query analytics data, inspect configurations, and manage control planes through nat...

A Model Context Protocol server enabling AI assistants to interact with Kong Konnect's API Gateway, providing tools to query analytics data, inspect configurations, and manage control planes through natural language.

This server falls under the APIs category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A Model Context Protocol server enabling AI assistants to in

Use Cases

API gateway management
Analytics queries
Control plane configuration
Kong

Maintainer

LicenseApache 2.0
Languagetypescript
Versionv1.0.0
UpdatedMay 19, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx kong-konnect-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Kong Konnect Gateway

The Kong Konnect MCP server connects AI assistants directly to Kong Konnect's API gateway, enabling natural-language queries against real-time analytics data and gateway configuration. You can ask it to surface failing requests, inspect route and service definitions, list consumers, and examine control plane configurations — all without leaving your AI chat interface. It is ideal for platform engineers and API teams who want to troubleshoot traffic issues or audit gateway config conversationally.

Prerequisites

  • Node.js 18 or later installed
  • A Kong Konnect account with an active API gateway
  • A Kong Konnect Personal Access Token (generated in the Konnect portal)
  • Claude Desktop or another MCP-compatible client
1

Clone the repository

Clone the mcp-konnect repository from GitHub and enter the project directory.

git clone https://github.com/Kong/mcp-konnect.git
cd mcp-konnect
2

Install dependencies

Install the Node.js dependencies required to run the server.

npm install
3

Run tests to verify setup

Run the test suite to confirm the installation is working before connecting it to a client.

npm test
4

Set your Kong Konnect credentials

The server requires a KONNECT_ACCESS_TOKEN environment variable. Optionally set KONNECT_REGION to target a specific data plane region (US, EU, AU, ME, or IN — defaults to US).

export KONNECT_ACCESS_TOKEN="your-personal-access-token"
export KONNECT_REGION="US"
5

Configure Claude Desktop

Add the server to your Claude Desktop MCP configuration file so it starts automatically when Claude launches.

6

Verify the connection

Open Claude Desktop and ask it to list your Kong Konnect control planes. If the server is configured correctly you will see a list returned from the API.

Kong Konnect Gateway Examples

Client configuration

Add this block to your claude_desktop_config.json to register the Kong Konnect MCP server. Replace the path and token with your real values.

{
  "mcpServers": {
    "kong-konnect": {
      "command": "node",
      "args": ["/path/to/mcp-konnect/dist/index.js"],
      "env": {
        "KONNECT_ACCESS_TOKEN": "your-personal-access-token",
        "KONNECT_REGION": "US"
      }
    }
  }
}

Prompts to try

Use these prompts in Claude Desktop after the server is connected to explore your Kong Konnect gateway.

- "List all control planes in my Kong Konnect account."
- "Show me all API requests for service <SERVICE_ID> in the last hour that returned 5xx status codes."
- "List all routes configured for control plane <CONTROL_PLANE_ID>."
- "Show me all requests made by consumer <CONSUMER_ID> in the last 24 hours, broken down by success and failure."
- "What plugins are configured on control plane <CONTROL_PLANE_ID>?"

Troubleshooting Kong Konnect Gateway

Authentication error: 401 Unauthorized when querying the API

Verify that KONNECT_ACCESS_TOKEN is set correctly and that the token has not expired. Generate a new Personal Access Token in the Kong Konnect portal under your account settings.

Server connects but returns empty results for control planes

Check that the KONNECT_REGION value matches the region where your control planes are deployed. Konnect data is region-specific — a token valid in US will not return EU data unless you change the region.

npm test fails with module not found errors

Ensure Node.js 18 or later is installed (run node --version to check) and that npm install completed without errors before running tests.

Frequently Asked Questions about Kong Konnect Gateway

What is Kong Konnect Gateway?

Kong Konnect Gateway is a Model Context Protocol (MCP) server that model context protocol server enabling ai assistants to interact with kong konnect's api gateway, providing tools to query analytics data, inspect configurations, and manage control planes through natural language. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Kong Konnect Gateway?

Follow the installation instructions on the Kong Konnect Gateway GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Kong Konnect Gateway?

Kong Konnect Gateway works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Kong Konnect Gateway free to use?

Yes, Kong Konnect Gateway is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.

Browse More APIs MCP Servers

Explore all apis servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "kong-konnect-mcp-server": { "command": "npx", "args": ["-y", "kong-konnect-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Kong Konnect Gateway?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides