4,000+ servers built on vurb.ts
Vinkius

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

MCP Inspector GDPR Free for Subscribers

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.

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
python
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())
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.

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

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

01

Install the SDK

Run pip install openai-agents in your Python environment
02

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.com
03

Run the script

Save the code above and run it: python agent.py
04

Explore tools

The agent will automatically discover 50 tools from Apache APISIX

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.

01

Native MCP integration via `MCPServerSse`, pass the URL and the SDK auto-discovers all tools with full type safety

02

Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure

03

Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate

04

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.

01

Automated workflows: build agents that query Apache APISIX, process the data, and trigger follow-up actions autonomously

02

Multi-agent orchestration: create specialist agents. one queries Apache APISIX, another analyzes results, a third generates reports

03

Data enrichment pipelines: stream data through Apache APISIX tools and transform it with OpenAI models in a single async loop

04

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.

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 OpenAI Agents SDK

Common issues when connecting Apache APISIX to OpenAI Agents SDK through Vinkius, and how to resolve them.

01

MCPServerStreamableHttp not found

Ensure you have the latest version: pip install --upgrade openai-agents
02

Agent not calling tools

Make sure your prompt explicitly references the task the tools can help with.

Apache APISIX + OpenAI Agents SDK FAQ

Common questions about integrating Apache APISIX MCP Server with OpenAI Agents SDK.

01

How does the OpenAI Agents SDK connect to MCP?

Use MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.
02

Can I use multiple MCP servers in one agent?

Yes. Pass a list of MCPServerSse instances to the agent constructor. The agent can use tools from all connected servers within a single run.
03

Does the SDK support streaming responses?

Yes. The SDK supports SSE and Streamable HTTP transports, both of which work natively with Vinkius.

Explore More MCP Servers

View all →