How to Use the Apache APISIX MCP in Cline

Q: How does Cline handle conflicting Apache APISIX route IDs?

The agent runs getroute to check if an ID exists before attempting a write. If it finds a conflict, it alerts you or updates the existing route depending on your instructions.

Q: Can I delete consumer configurations using Cline?

Yes, you can use deleteconsumer and deleteconsumergroup to remove API clients directly from the sidebar. Cline will execute these cleanups and verify the removal from the live gateway.

Let Cline write configuration code, run local gateway tests, and deploy Apache APISIX routes directly from VS Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Apache APISIX MCP to Cline

Create your Vinkius account to connect Apache APISIX to Cline 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 Apache APISIX with Cline

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Audit Apache APISIX Configurations inside Cline

This MCP Server uses `dump_control_routes` and `dump_control_services` to pull your live production gateway state into Cline. The agent reads this configuration, compares it against your local workspace files, and highlights any drift. You can instruct Cline to synchronize the states, and it will generate the necessary JSON payloads and execute `put_route` to match your local repository. It displays a clean diff in VS Code before applying the changes.

Automated Plugin Configuration Testing

The `put_plugin_config` and `get_control_schema` tools allow Cline to write and test your gateway plugin setups locally. The agent writes your plugin configurations to disk, validates them against the live schemas, and runs local curl tests to ensure they work. If a test fails, Cline modifies the plugin parameters in your workspace and redeploys them. You see the entire trial-and-error loop resolve directly inside your VS Code terminal.

L4 and L7 Stream Route Provisioning

You can configure low-level network rules using `put_stream_route` and `put_ssl` through the MCP Server in Cline. The agent analyzes your TCP/UDP traffic requirements, generates the correct stream configurations, and binds the certificates. Cline handles the entire setup, from writing the YAML definitions to executing the Admin API calls. It ensures your Layer 4 and Layer 7 gateway settings remain perfectly aligned.

Setup guide

Set up Apache APISIX MCP in Cline

Prerequisites

VS Code with Cline extension installed
Active Vinkius subscription with a valid endpoint token

1

Open Cline MCP settings

Click the Cline icon in the VS Code sidebar to open the Cline panel. Then click the MCP Servers icon (server stack) at the top-right corner of the panel.
2

Add a remote server

Click "Remote Servers" at the top, then click "Add Remote MCP". In the Name field, type apache-apisix-mcp. In the URL field, paste your Vinkius endpoint: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp. Get your token from cloud.vinkius.com.
3

Enable the server

After saving, the server appears in the Cline MCP panel. Toggle the switch to enable it. The status indicator turns green when the connection is live.
4

Start using tools

Return to the Cline chat and ask: "Check my latest Apache APISIX refund status." Cline will discover the available tools and request your approval before invoking each one — giving you full control over every action.

Cline MCP Settings

{
  "mcpServers": {
    "apache-apisix-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 Apache APISIX. 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 Apache APISIX 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 Apache APISIX MCP in Cline

Open the Cline sidebar, click the MCP Servers icon, and paste the Vinkius connection URL into the Remote Servers tab. Cline will immediately register the fifty administration tools for your workspace.

Yes, Cline can write your declarative configurations to local files, run tests, and then call `put_route` or `put_upstream` to push those changes to your live gateway.

The agent runs `get_route` to check if an ID exists before attempting a write. If it finds a conflict, it alerts you or updates the existing route depending on your instructions.

Yes, you can use `delete_consumer` and `delete_consumer_group` to remove API clients directly from the sidebar. Cline will execute these cleanups and verify the removal from the live gateway.

All communication goes through the Vinkius V8 Isolate Sandbox, which handles the authentication headers securely. Your raw admin keys and sensitive consumer credentials are never written to your local workspace files or shared with the AI model.

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