4,000+ servers built on vurb.ts
Vinkius

Apache APISIX MCP Server for WindsurfGive Windsurf instant access to 50 tools to Delete Consumer, Delete Consumer Group, Delete Global Rule, and more

MCP Inspector GDPR Free for Subscribers

Windsurf brings agentic AI coding to a purpose-built IDE. Connect Apache APISIX through Vinkius and Cascade will auto-discover every tool. ask questions, generate code, and act on live data without leaving your editor.

Ask AI about this MCP Server for Windsurf

The Apache APISIX MCP Server for Windsurf is a standout in the Loved By Devs category — giving your AI agent 50 tools to work with, ready to go from day one.

Built for AI Agents by Vinkius

Vinkius delivers Streamable HTTP and SSE to any MCP client

ClaudeClaude
ChatGPTChatGPT
CursorCursor
GeminiGemini
WindsurfWindsurf
VS CodeVS Code
JetBrainsJetBrains
VercelVercel
+ other MCP clients
Classic Setup·json
{
  "mcpServers": {
    "apache-apisix": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}
RecommendedModern Approach — Zero Configuration

Vinkius Desktop App

The modern way to manage MCP Servers — no config files, no terminal commands. Install Apache APISIX and 4,000+ MCP Servers from a single visual interface.

Vinkius Desktop InterfaceVinkius Desktop InterfaceVinkius Desktop InterfaceVinkius Desktop Interface
Download Free Open SourceNo signup required
Apache APISIX
Fully ManagedVinkius Servers
60%Token savings
High SecurityEnterprise-grade
IAMAccess control
EU AI ActCompliant
DLPData protection
V8 IsolateSandboxed
Ed25519Audit chain
<40msKill switch
Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About Apache APISIX MCP Server

Connect your Apache APISIX instance to any AI agent to orchestrate high-performance traffic management through natural language.

Windsurf's Cascade agent chains multiple Apache APISIX tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 50 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.

What you can do

  • Route Orchestration — List, inspect, create, or delete routes to match client requests and forward them to target upstreams.
  • Service Abstraction — Manage service entities that group common plugins and upstream configurations for easier API maintenance.
  • Upstream Management — Configure virtual host abstractions for load balancing, including node management and health checks.
  • Consumer Control — List and manage API consumers to handle authentication and per-user rate limiting.
  • Configuration as Conversation — Update complex JSON configurations for any gateway resource without manually using CURL or the Dashboard.

The Apache APISIX MCP Server exposes 50 tools through the Vinkius. Connect it to Windsurf in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

All 50 Apache APISIX tools available for Windsurf

When Windsurf connects to Apache APISIX through Vinkius, your AI agent gets direct access to every tool listed below — spanning api-gateway, traffic-management, cloud-native, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.

delete

Delete consumer on Apache APISIX

Delete an APISIX Consumer

delete

Delete consumer group on Apache APISIX

Delete an APISIX Consumer Group

delete

Delete global rule on Apache APISIX

Delete an APISIX Global Rule

delete

Delete plugin config on Apache APISIX

Delete an APISIX Plugin Config

delete

Delete proto on Apache APISIX

Delete an APISIX Proto

delete

Delete route on Apache APISIX

Delete an APISIX Route

delete

Delete service on Apache APISIX

Delete an APISIX Service

delete

Delete ssl on Apache APISIX

Delete an APISIX SSL certificate

delete

Delete stream route on Apache APISIX

Delete an APISIX Stream Route

delete

Delete upstream on Apache APISIX

Delete an APISIX Upstream

dump

Dump control discovery on Apache APISIX

Memory dump of discovered service endpoints

dump

Dump control plugin metadatas on Apache APISIX

Dump all plugin metadata from the Control API

dump

Dump control routes on Apache APISIX

Dump all configured Routes from the Control API

dump

Dump control services on Apache APISIX

Dump all configured Services from the Control API

dump

Dump control upstreams on Apache APISIX

Dump all configured Upstreams from the Control API

get

Get consumer on Apache APISIX

Get a specific APISIX Consumer by username

get

Get consumer group on Apache APISIX

Get a specific APISIX Consumer Group by ID

get

Get control healthcheck on Apache APISIX

Get health status of all upstream nodes

get

Get control resource healthcheck on Apache APISIX

Get health status for a specific resource

get

Get control schema on Apache APISIX

Get JSON schemas for all resources and enabled plugins

get

Get global rule on Apache APISIX

Get a specific APISIX Global Rule by ID

get

Get plugin config on Apache APISIX

Get a specific APISIX Plugin Config by ID

get

Get proto on Apache APISIX

Get a specific APISIX Proto by ID

get

Get route on Apache APISIX

Get a specific APISIX Route by ID

get

Get service on Apache APISIX

Get a specific APISIX Service by ID

get

Get ssl on Apache APISIX

Get a specific APISIX SSL certificate by ID

get

Get stream route on Apache APISIX

Get a specific APISIX Stream Route by ID

get

Get upstream on Apache APISIX

Get a specific APISIX Upstream by ID

list

List consumer groups on Apache APISIX

List APISIX Consumer Groups

list

List consumers on Apache APISIX

List APISIX Consumers

list

List global rules on Apache APISIX

List APISIX Global Rules

list

List plugin configs on Apache APISIX

List APISIX Plugin Configs

list

List protos on Apache APISIX

List APISIX Protos (Protocol Buffers)

list

List routes on Apache APISIX

List APISIX Routes

list

List services on Apache APISIX

List APISIX Services

list

List ssls on Apache APISIX

List APISIX SSL certificates

list

List stream routes on Apache APISIX

List APISIX Stream Routes (L4 routing)

list

List upstreams on Apache APISIX

List APISIX Upstreams

put

Put consumer on Apache APISIX

Create or update an APISIX Consumer

put

Put consumer group on Apache APISIX

Create or update an APISIX Consumer Group

put

Put global rule on Apache APISIX

Create or update an APISIX Global Rule

put

Put plugin config on Apache APISIX

Create or update an APISIX Plugin Config

put

Put proto on Apache APISIX

Create or update an APISIX Proto

put

Put route on Apache APISIX

Create or update an APISIX Route

put

Put service on Apache APISIX

Create or update an APISIX Service

put

Put ssl on Apache APISIX

Create or update an APISIX SSL certificate

put

Put stream route on Apache APISIX

Create or update an APISIX Stream Route

put

Put upstream on Apache APISIX

Create or update an APISIX Upstream

reload

Reload control plugins on Apache APISIX

Trigger a hot reload of plugins

trigger

Trigger control gc on Apache APISIX

Trigger full garbage collection in the HTTP Lua VM

Connect Apache APISIX to Windsurf via MCP

Follow these steps to wire Apache APISIX into Windsurf. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.

01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
02

Add the server

Paste the JSON configuration above into mcp_config.json
03

Save and reload

Windsurf will detect the new server automatically
04

Start using Apache APISIX

Open Cascade and ask: "Using Apache APISIX, help me...". 50 tools available

Why Use Windsurf with the Apache APISIX MCP Server

Windsurf provides unique advantages when paired with Apache APISIX through the Model Context Protocol.

01

Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention

02

Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively

03

JSON-based configuration means zero code changes: paste a URL, reload, and all 50 tools are immediately available

04

Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts

Apache APISIX + Windsurf Use Cases

Practical scenarios where Windsurf combined with the Apache APISIX MCP Server delivers measurable value.

01

Automated code generation: ask Cascade to fetch data from Apache APISIX and generate models, types, or handlers based on real API responses

02

Live debugging: query Apache APISIX tools mid-session to inspect production data while debugging without leaving the editor

03

Documentation generation: pull schema information from Apache APISIX and have Cascade generate comprehensive API docs automatically

04

Rapid prototyping: combine Apache APISIX data with Cascade's code generation to scaffold entire features in minutes

Example Prompts for Apache APISIX in Windsurf

Ready-to-use prompts you can give your Windsurf agent to start working with Apache APISIX immediately.

01

"List all active routes in my APISIX gateway."

02

"Show me the configuration for upstream ID 'backend-cluster'."

03

"List all consumers to check who has access to the API."

Troubleshooting Apache APISIX MCP Server with Windsurf

Common issues when connecting Apache APISIX to Windsurf through Vinkius, and how to resolve them.

01

Server not connecting

Check Settings → MCP for the server status. Try toggling it off and on.

Apache APISIX + Windsurf FAQ

Common questions about integrating Apache APISIX MCP Server with Windsurf.

01

How does Windsurf discover MCP tools?

Windsurf reads the mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.
02

Can Cascade chain multiple MCP tool calls?

Yes. Cascade is an agentic system. it can plan and execute multi-step workflows, calling several tools in sequence to accomplish complex tasks without manual prompting between steps.
03

Does Windsurf support multiple MCP servers?

Yes. Add as many servers as needed in mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.

Explore More MCP Servers

View all →