Apache APISIX MCP Server for OpenAI Agents SDKGive OpenAI Agents SDK instant access to 50 tools to Delete Consumer, Delete Consumer Group, Delete Global Rule, and more
The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect Apache APISIX through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.
Ask AI about this MCP Server for OpenAI Agents SDK
The Apache APISIX MCP Server for OpenAI Agents SDK 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
import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp
async def main():
# Your Vinkius token. get it at cloud.vinkius.com
async with MCPServerStreamableHttp(
url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
) as mcp_server:
agent = Agent(
name="Apache APISIX Assistant",
instructions=(
"You help users interact with Apache APISIX. "
"You have access to 50 tools."
),
mcp_servers=[mcp_server],
)
result = await Runner.run(
agent, "List all available tools from Apache APISIX"
)
print(result.final_output)
asyncio.run(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.
The OpenAI Agents SDK auto-discovers all 50 tools from Apache APISIX through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries Apache APISIX, another analyzes results, and a third generates reports, all orchestrated through Vinkius.
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 OpenAI Agents SDK 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 OpenAI Agents SDK
When OpenAI Agents SDK 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 OpenAI Agents SDK via MCP
Follow these steps to wire Apache APISIX into OpenAI Agents SDK. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install the SDK
pip install openai-agents in your Python environmentReplace the token
[YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.comRun the script
python agent.pyExplore tools
Why Use OpenAI Agents SDK with the Apache APISIX MCP Server
OpenAI Agents SDK provides unique advantages when paired with Apache APISIX through the Model Context Protocol.
Native MCP integration via `MCPServerSse`, pass the URL and the SDK auto-discovers all tools with full type safety
Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure
Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate
First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output
Apache APISIX + OpenAI Agents SDK Use Cases
Practical scenarios where OpenAI Agents SDK combined with the Apache APISIX MCP Server delivers measurable value.
Automated workflows: build agents that query Apache APISIX, process the data, and trigger follow-up actions autonomously
Multi-agent orchestration: create specialist agents. one queries Apache APISIX, another analyzes results, a third generates reports
Data enrichment pipelines: stream data through Apache APISIX tools and transform it with OpenAI models in a single async loop
Customer support bots: agents query Apache APISIX to resolve tickets, look up records, and update statuses without human intervention
Example Prompts for Apache APISIX in OpenAI Agents SDK
Ready-to-use prompts you can give your OpenAI Agents SDK 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 OpenAI Agents SDK
Common issues when connecting Apache APISIX to OpenAI Agents SDK through Vinkius, and how to resolve them.
MCPServerStreamableHttp not found
pip install --upgrade openai-agentsAgent not calling tools
Apache APISIX + OpenAI Agents SDK FAQ
Common questions about integrating Apache APISIX MCP Server with OpenAI Agents SDK.
How does the OpenAI Agents SDK connect to MCP?
MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.Can I use multiple MCP servers in one agent?
MCPServerSse instances to the agent constructor. The agent can use tools from all connected servers within a single run.Does the SDK support streaming responses?
Explore More MCP Servers
View all →
MediaSilo (Legacy)
11 toolsShare and review video content with creative teams using secure media workspaces, annotations, and approval workflows.

Remote
11 toolsHire and pay global employees and contractors with compliant payroll, benefits, and employment infrastructure across 60+ countries.

Planly
11 toolsSchedule and auto-publish social media posts across Instagram, TikTok, Twitter, and LinkedIn with a clean visual calendar.

DocuSeal
12 toolsAutomate document signing workflows via DocuSeal — manage templates, send signature requests, and track signers directly from any AI agent.
