How to Use the Kong Gateway MCP in Windsurf

Let Windsurf's Cascade agent manage your Kong Gateway configuration from start to finish, all in a single step.

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 Windsurf

Create your Vinkius account to connect Kong Gateway to Windsurf 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Launch a Full Service in One Command

This toolset lets Cascade deploy a new microservice for you. Just tell it, "Deploy the 'user-api' and connect it to the upstream." Cascade figures out the right sequence of tools to call. It chains together `create_service`, `create_upstream`, and `create_route` in the background. You don't have to run them one-by-one. Your agent just plans the job, does the work, and tells you when the new endpoint is live. It's the fastest way to get from code to a running API.

Apply Gateway Policies Autonomously

Securing an endpoint is now a single instruction. Tell Cascade, "Add JWT auth and rate limiting to the billing service." It finds the right service and uses `create_plugin` to apply the policies you asked for. This is also how you handle incidents. When a service gets overloaded, you don't have time for GUIs. Just tell Cascade to apply a circuit-breaker plugin. It's done in seconds, not minutes.

Get Gateway State with this MCP Server

When something breaks, you need answers immediately. Ask Cascade, "What plugins are running on the payments-api?" It uses `get_service` and `list_plugins` to pull a report for you. This isn't just a simple data fetch. Cascade can cross-reference information from multiple tools. It can check the health of an upstream's targets with `list_targets` and then pull the main service configuration with `get_service` to give you the full picture.

Setup guide

Set up Kong Gateway MCP in Windsurf

Prerequisites

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

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Kong Gateway MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Kong Gateway payment history." If connected, Cascade will call the Kong Gateway tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.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 Windsurf

You add the Kong Gateway MCP server from the Vinkius Marketplace inside Windsurf. Once connected, the Cascade agent automatically discovers all the available tools like `create_route` and `list_services`.

Yes. You can describe the routing you need in plain English. Cascade will translate your request into the correct parameters for the `create_route` or `update_route` tool, handling things like headers, methods, and hosts.

It's as safe as the instructions you give it. Cascade executes your commands precisely. For production, it's best to start with read-only commands like `list_plugins` and then graduate to specific, authorized write commands like `update_plugin` for incident response.

Speed and composition. Instead of clicking through multiple screens to create a service and a route, you issue one command to your agent. Cascade does the work for you.

Windsurf only accesses your Kong Gateway's configuration data—things like service definitions, route paths, and plugin settings. All tool calls happen inside an ephemeral, zero-trust sandbox managed by Vinkius, and the connection is encrypted end-to-end.

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