How to Use the Kong Gateway MCP in Cursor

Q: How do I add the Kong Gateway MCP Server to my Cursor project?

Create a .cursor/mcp.json file in your workspace root and declare the server details under the mcpServers key. Once saved, enable Agent mode in the Cursor chat pane to start calling tools like listservices.

Build and debug your API routes directly inside Cursor while your agent writes code using real-time gateway data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Kong Gateway MCP to Cursor

Create your Vinkius account to connect Kong Gateway to Cursor and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Kong Gateway with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Instant Route Generation in the Code Editor

`create_route` registers new entry points on your gateway directly from the Cursor agent interface. As you write backend code, your editor sets up the routing path on your running Kong instance automatically. You can query current route structures with `get_route` to ensure your local code matches the gateway rules. This eliminates the feedback loop of manual configuration changes during active coding sessions.

Real-time Gateway Auditing in Cursor

`list_services` pulls active backend definitions straight into your Cursor workspace to guide your development. Your agent reads this live configuration to generate matching client libraries or integration tests. You can verify target health using `list_targets` to trace routing issues without leaving your code file. If a backend service is misconfigured, your editor highlights the discrepancy based on live gateway data.

Agentic Consumer and Plugin Injection

`create_consumer` provisions API clients and credentials right from your Cursor terminal workspace. Your agent generates the consumer, runs `create_plugin` to attach key-auth, and inserts the keys directly into your local `.env` file. You can manage these entities during testing using `delete_consumer` or `update_plugin` to simulate different access levels. This lets you test security scenarios without manual postman requests.

Setup guide

Set up Kong Gateway MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Kong Gateway MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Kong Gateway transactions." If the MCP tools are loaded correctly, Cursor will call the Kong Gateway tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "kong-gateway-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Kong Gateway. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Kong Gateway now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Kong Gateway MCP in Cursor

Create a `.cursor/mcp.json` file in your workspace root and declare the server details under the `mcpServers` key. Once saved, enable Agent mode in the Cursor chat pane to start calling tools like `list_services`.

Yes, when you ask the Cursor agent to expose a new endpoint, it calls `create_route` and links it to your target service. It reads the local file structure to determine the correct path rules before executing.

Ask the Cursor agent to check the upstream state, which triggers `list_targets` to inspect backend nodes. The agent parses the status output and suggests code fixes for any failing health checks.

Yes, the server connects directly to your local Kong Admin API port over localhost. This allows you to run `update_service` and modify routing rules instantly while testing your code locally.

Your API gateway configurations and route definitions are processed locally through Cursor's isolated runtime. The editor never sends your admin credentials or route schemas to external servers, keeping your routing architecture private.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript