styx-mcp-server

MCP server for Styx — the intelligent AI gateway that routes requests across OpenAI, Anthropic, Google, and Mistral from a single endpoint.

Connect Claude Code, Cursor, Windsurf, or any MCP-compatible client to your self-hosted Styx instance.

Quick start

# Add to Claude Code
claude mcp add styx -- npx styx-mcp-server

# Or run directly
npx styx-mcp-server

Requirements

• Node.js 18+
• Python 3.10+ with dependencies:

pip install mcp[cli] httpx pydantic

Configuration

Set environment variables before starting:

| Variable | Default | Description | |---|---|---| | STYX_API_URL | http://localhost:8000 | Styx backend URL | | STYX_PROXY_URL | http://localhost:8080 | Styx proxy URL | | STYX_API_KEY | — | API key (for styx_send_request) | | STYX_TOKEN | — | Auth token (for project/key management) |

Claude Code config

Add to .claude/mcp.json:

{
  "mcpServers": {
    "styx": {
      "command": "npx",
      "args": ["styx-mcp-server"],
      "env": {
        "STYX_API_URL": "http://localhost:8000",
        "STYX_PROXY_URL": "http://localhost:8080",
        "STYX_API_KEY": "sk-styx-...",
        "STYX_TOKEN": "your-token"
      }
    }
  }
}

Tools

| Tool | Description | |---|---| | styx_send_request | Route AI requests through the gateway | | styx_list_models | List all available models with pricing | | styx_switch_model | Set a default model | | styx_list_projects | List your projects | | styx_create_project | Create a new project | | styx_list_api_keys | List API keys | | styx_create_api_key | Create an API key | | styx_check_usage | View usage and cost statistics | | styx_manage_providers | Manage BYOK provider keys |

SSE transport

npx styx-mcp-server --sse   # starts on port 8090

License

Apache-2.0