Styx MCP server

⚡ Styx The MCP-Native AI Gateway Route requests to any AI provider through one universal endpoint. Self-hosted. Open source. BYOK.

<!-- Badges -->

What is Styx?

Styx is an open-source AI gateway that sits between your app and AI providers. Send requests to OpenAI, Anthropic, Google, or Mistral — all through one OpenAI-compatible endpoint. Bring your own API keys, self-host on your infra, and get full visibility into every request.

The first AI gateway with native MCP (Model Context Protocol) support.

from openai import OpenAI

client = OpenAI(
    api_key="your-styx-api-key",
    base_url="http://localhost:8080/v1",  # ← Only change needed
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello from Styx"}],
)

Features

• 🔌 MCP Native — Built-in MCP server. Connect Claude Code or Cursor in one command
• 🔀 Universal Routing — One OpenAI-compatible endpoint for all providers
• 🤖 styx:auto — Intelligent model routing: use "model": "styx:auto" and let Styx pick the right model based on request complexity
• 🔑 BYOK — Bring your own API keys, encrypted at rest (Fernet/AES)
• 📊 Dashboard — Track requests, costs, latency per project and model
• 🔄 Fallbacks — Auto-failover between providers with circuit breakers
• 💰 Billing — Built-in subscription and credit-based billing (Stripe)
• 🧠 Semantic Cache — Similar questions return cached responses instantly
• ⚡ Smart Routing — ML classifier routes to the optimal model for each request
• 🐳 Self-Hosted — Docker Compose, 5-minute setup
• 🔒 Secure — HMAC key hashing, Fernet encryption, rate limiting, TLS

Prerequisites

• Docker Engine 24+ and Docker Compose v2
• At least one AI provider API key (OpenAI, Anthropic, Google, or Mistral)
• Supabase account (free tier) — only for production mode (not needed for dev mode)

Quick Start

Option A: Setup Wizard (recommended)

git clone https://github.com/timmx7/styx.git
cd styx
./setup.sh                 # interactive wizard, generates .env
docker compose up -d --build   # first build: ~15-20 min; subsequent starts: ~60s

The wizard lets you choose between:

• Dev mode — No Supabase needed, no authentication, instant start
• Production mode — Full Supabase auth, account creation, API keys

Option B: Manual Setup

git clone https://github.com/timmx7/styx.git
cd styx
cp .env.example .env

Edit .env with:

1. Set SKIPAUTH=true for dev mode, or configure Supabase** for production
2. At least one AI provider key (e.g., OPENAIAPIKEY)

docker compose up -d --build   # first build: ~15-20 min; subsequent starts: ~60s

Access Points

• Dashboard: http://localhost:3000
• API Gateway: http://localhost:8080 (direct) or https://localhost/v1 (via nginx/TLS)
• Docs API: https://localhost/api (via nginx)

Connect Claude Code

claude mcp add styx -- npx styx-mcp

Connect Cursor

Add to .cursor/mcp.json:

{
  "styx": {
    "command": "npx",
    "args": ["styx-mcp"],
    "env": { "STYX_API_KEY": "your-key" }
  }
}

Send your first request

curl -X POST http://localhost:8080/v1/chat/completions \
  -H "Authorization: Bearer YOUR_STYX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello from Styx"}]
  }'

Shortened. The full README is on GitHub.