Apache APISIX MCP Server for Mastra AIGive Mastra AI instant access to 50 tools to Delete Consumer, Delete Consumer Group, Delete Global Rule, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Apache APISIX through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The Apache APISIX MCP Server for Mastra AI is a standout in the Loved By Devs category — giving your AI agent 50 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Geminiimport { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"apache-apisix": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Apache APISIX Agent",
instructions:
"You help users interact with Apache APISIX " +
"using 50 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Apache APISIX?"
);
console.log(result.text);
}
main();
* 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.
Mastra's agent abstraction provides a clean separation between LLM logic and Apache APISIX tool infrastructure. Connect 50 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
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 Mastra AI 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 Mastra AI
When Mastra AI 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 consumer on Apache APISIX
Delete an APISIX Consumer
Delete consumer group on Apache APISIX
Delete an APISIX Consumer Group
Delete global rule on Apache APISIX
Delete an APISIX Global Rule
Delete plugin config on Apache APISIX
Delete an APISIX Plugin Config
Delete proto on Apache APISIX
Delete an APISIX Proto
Delete route on Apache APISIX
Delete an APISIX Route
Delete service on Apache APISIX
Delete an APISIX Service
Delete ssl on Apache APISIX
Delete an APISIX SSL certificate
Delete stream route on Apache APISIX
Delete an APISIX Stream Route
Delete upstream on Apache APISIX
Delete an APISIX Upstream
Dump control discovery on Apache APISIX
Memory dump of discovered service endpoints
Dump control plugin metadatas on Apache APISIX
Dump all plugin metadata from the Control API
Dump control routes on Apache APISIX
Dump all configured Routes from the Control API
Dump control services on Apache APISIX
Dump all configured Services from the Control API
Dump control upstreams on Apache APISIX
Dump all configured Upstreams from the Control API
Get consumer on Apache APISIX
Get a specific APISIX Consumer by username
Get consumer group on Apache APISIX
Get a specific APISIX Consumer Group by ID
Get control healthcheck on Apache APISIX
Get health status of all upstream nodes
Get control resource healthcheck on Apache APISIX
Get health status for a specific resource
Get control schema on Apache APISIX
Get JSON schemas for all resources and enabled plugins
Get global rule on Apache APISIX
Get a specific APISIX Global Rule by ID
Get plugin config on Apache APISIX
Get a specific APISIX Plugin Config by ID
Get proto on Apache APISIX
Get a specific APISIX Proto by ID
Get route on Apache APISIX
Get a specific APISIX Route by ID
Get service on Apache APISIX
Get a specific APISIX Service by ID
Get ssl on Apache APISIX
Get a specific APISIX SSL certificate by ID
Get stream route on Apache APISIX
Get a specific APISIX Stream Route by ID
Get upstream on Apache APISIX
Get a specific APISIX Upstream by ID
List consumer groups on Apache APISIX
List APISIX Consumer Groups
List consumers on Apache APISIX
List APISIX Consumers
List global rules on Apache APISIX
List APISIX Global Rules
List plugin configs on Apache APISIX
List APISIX Plugin Configs
List protos on Apache APISIX
List APISIX Protos (Protocol Buffers)
List routes on Apache APISIX
List APISIX Routes
List services on Apache APISIX
List APISIX Services
List ssls on Apache APISIX
List APISIX SSL certificates
List stream routes on Apache APISIX
List APISIX Stream Routes (L4 routing)
List upstreams on Apache APISIX
List APISIX Upstreams
Put consumer on Apache APISIX
Create or update an APISIX Consumer
Put consumer group on Apache APISIX
Create or update an APISIX Consumer Group
Put global rule on Apache APISIX
Create or update an APISIX Global Rule
Put plugin config on Apache APISIX
Create or update an APISIX Plugin Config
Put proto on Apache APISIX
Create or update an APISIX Proto
Put route on Apache APISIX
Create or update an APISIX Route
Put service on Apache APISIX
Create or update an APISIX Service
Put ssl on Apache APISIX
Create or update an APISIX SSL certificate
Put stream route on Apache APISIX
Create or update an APISIX Stream Route
Put upstream on Apache APISIX
Create or update an APISIX Upstream
Reload control plugins on Apache APISIX
Trigger a hot reload of plugins
Trigger control gc on Apache APISIX
Trigger full garbage collection in the HTTP Lua VM
Connect Apache APISIX to Mastra AI via MCP
Follow these steps to wire Apache APISIX into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the Apache APISIX MCP Server
Mastra AI provides unique advantages when paired with Apache APISIX through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Apache APISIX without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every Apache APISIX tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
Apache APISIX + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Apache APISIX MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Apache APISIX, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Apache APISIX as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Apache APISIX on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Apache APISIX tools alongside other MCP servers
Example Prompts for Apache APISIX in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Apache APISIX immediately.
"List all active routes in my APISIX gateway."
"Show me the configuration for upstream ID 'backend-cluster'."
"List all consumers to check who has access to the API."
Troubleshooting Apache APISIX MCP Server with Mastra AI
Common issues when connecting Apache APISIX to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpApache APISIX + Mastra AI FAQ
Common questions about integrating Apache APISIX MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
Findymail
12 toolsFind and verify verified B2B emails and direct phone numbers using natural language agents.
LeanCloud
10 toolsScalable backend-as-a-service platform — manage data classes, users, and push notifications via AI.
ClickFunnels
8 toolsManage sales funnels and contacts via ClickFunnels 2.0 — track performance, monitor leads, and manage orders directly from any AI agent.
Mighty Networks
12 toolsBuild thriving online communities with courses, events, and member networking features all under your own brand.