APISIX MCP Server

Manage Apache APISIX gateway resources through natural language via the Admin API.

Unverified

stdio (local)

API key

Stale

TypeScript

View repo 38 npm

Add to your client

Copy the config for your MCP client and paste it into its config file.

Install / run

npx -y @smithery/cli install @api7/apisix-mcp --client claude

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "apisix-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "apisix-mcp"
      ],
      "env": {
        "APISIX_SERVER_HOST": "your-apisix-server-host",
        "APISIX_SERVER_PORT": "your-apisix-server-port",
        "APISIX_ADMIN_API_PORT": "your-apisix-admin-api-port",
        "APISIX_ADMIN_API_PREFIX": "your-apisix-admin-api-prefix",
        "APISIX_ADMIN_KEY": "your-apisix-api-key"
      }
    }
  }
}

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

Before you start

A running Apache APISIX instance (see the APISIX Getting Started guide)
APISIX Admin API key (APISIX_ADMIN_KEY)
Node.js with npx (or pnpm if building from source)

About APISIX MCP Server

APISIX MCP server lets AI clients manage an Apache APISIX API gateway through natural language. It wraps the APISIX Admin API, exposing tools to create, read, update, and delete gateway resources (routes, services, upstreams, SSL, stream routes, protos), configure and inspect plugins, manage security objects (consumers, credentials, consumer groups, secrets), and send test requests to the gateway. Configure your AI client with the APISIX server host/port, Admin API port/prefix, and admin key via environment variables.

Tools & capabilities (18)

get_resource

Retrieve resources by type (routes, services, upstreams, etc.).

delete_resource

Remove resources by ID.

send_request_to_gateway

Send a request or multiple requests to the APISIX gateway.

create_route / update_route / delete_route

Manage routes.

create_service / update_service / delete_service

Manage services.

create_upstream / update_upstream / delete_upstream

Manage upstreams.

create_ssl / update_ssl / delete_ssl

Manage SSL certificates.

create_or_update_proto

Manage protobuf definitions.

create_or_update_stream_route

Manage stream routes.

get_all_plugin_names

Get all available plugin names.

get_plugin_info / get_plugins_by_type / get_plugin_schema

Retrieve plugins configuration.

create_plugin_config / update_plugin_config

Manage plugin configurations.

create_global_rule / update_global_rule

Manage plugin global rules.

get_plugin_metadata / create_or_update_plugin_metadata / delete_plugin_metadata

Manage plugin metadata.

get_secret_by_id / create_secret / update_secret

Manage secrets.

create_or_update_consumer / delete_consumer

Manage consumers.

get_credential / create_or_update_credential / delete_credential

Manage consumer credentials.

create_consumer_group / delete_consumer_group

Manage consumer groups.

What this server can do

APISIX MCP Server provides tools for these capabilities — tap one to see every MCP server that does the same:

Deploy & manage cloud infra

When to use it

Inspect and manage APISIX routes, services, and upstreams using natural language
Configure, inspect, and apply APISIX plugins and global rules from an AI client
Set up consumers, credentials, consumer groups, and secrets for gateway security
Manage SSL certificates and stream routes
Send test requests through the gateway to validate configuration changes

Security notes

Requires the APISIX Admin API key (APISIX_ADMIN_KEY). The default key shown in the docs (edd1c9f034335f136f87ad84b625c8f1) is APISIX's well-known default and must be changed in any real deployment. The server has full read/write access to your APISIX gateway configuration, so treat the admin key as a sensitive secret and restrict network access to the Admin API.

APISIX MCP Server FAQ

How do I install it for Claude Desktop?

Run `npx -y @smithery/cli install @api7/apisix-mcp --client claude` to install automatically via Smithery, or add the apisix-mcp mcpServers block manually to your client config.

What environment variables are required?

APISIX_SERVER_HOST (default http://127.0.0.1), APISIX_SERVER_PORT (9080), APISIX_ADMIN_API_PORT (9180), APISIX_ADMIN_API_PREFIX (/apisix/admin), and APISIX_ADMIN_KEY (the Admin API authentication key).

Do I need a running APISIX instance?

Yes. Follow the APISIX Getting Started guide to set up and run APISIX before configuring the MCP server, and ensure your machine can reach the APISIX Admin API.

Is this an official project?

Yes. It is built and maintained by API7.ai, the company behind Apache APISIX.

#apisix #api-gateway #api-management #admin-api #devops #typescript

Alternatives to APISIX MCP Server

Compare all alternatives →

GitHub MCP Server

DevOps & Cloud

31k

GitHub's official server for repos, issues, PRs, and Actions — local Docker or hosted remote.

Featured

Verified

stdio (local)

API key

7 tools

Updated 15 days agoRepo

AWS API MCP Server

DevOps & Cloud

9.3k

Official AWS Labs server that lets agents call any AWS API via the AWS CLI surface.

Verified

stdio (local)

API key

Python

3 tools

Updated 17 days agoRepo

kubefwd

DevOps & Cloud

4.1k

Bulk Kubernetes port forwarding with an MCP server that lets AI assistants forward services, inspect pods, and monitor traffic.

Unverified

stdio (local)

No auth

28 tools

Updated 9 days agoRepo

Compare APISIX MCP Server with:

vs GitHub MCP Server vs AWS API MCP Server vs kubefwd vs Radar