ZRouter MCP Server

Manage your ZRouter account from any AI assistant. Check spend, search request logs, create virtual model routers, issue API keys, and set budgets and rate limits in plain language.

https://zrouter.si/mcp

ZRouter is the Super Intelligence Router: one OpenAI-compatible API key for chat, images, audio, and video, routed to the right model and provider. This MCP server is the management side of your account. It runs as a hosted remote server, so there is nothing to install.

• Transport: Streamable HTTP
• Sign-in: OAuth 2.1 with PKCE and dynamic client registration, or a bearer token
• Scope: your own account only, with the same rules as the dashboard
• Tools: 24 (14 read-only, 4 write, 6 marked destructive)

Contents

• Quick start
• Connect a client
• Use a token instead of sign-in
• What you can ask
• Tools
• Security
• Authentication details
• Troubleshooting
• FAQ
• Links

Quick start

1. Create a free account at zrouter.si.
2. Add https://zrouter.si/mcp as a remote MCP server in your client.
3. Approve access on the ZRouter page that opens.
4. Ask: "How much did I spend this week, by model?"

Clients that support MCP sign-in only need the URL. There is no token to copy or renew.

Connect a client

Claude (claude.ai and Claude Desktop)

Settings → Connectors → Add custom connector. Paste https://zrouter.si/mcp, then select Connect and approve access.

ChatGPT

Settings → Apps & Connectors → create a connector with the URL https://zrouter.si/mcp and OAuth authentication. Custom connectors may require developer mode, depending on your plan.

Claude Code

claude mcp add --transport http zrouter https://zrouter.si/mcp

Then run /mcp inside Claude Code and choose Authenticate.

Cursor

This repository is also a Cursor plugin (.cursor-plugin/plugin.json). Or add the server to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "zrouter": {
      "url": "https://zrouter.si/mcp"
    }
  }
}

VS Code

Add the server to .vscode/mcp.json or your user configuration:

{
  "servers": {
    "zrouter": {
      "type": "http",
      "url": "https://zrouter.si/mcp"
    }
  }
}

Other clients

Add a remote MCP server with the URL https://zrouter.si/mcp and the Streamable HTTP transport. Choose OAuth sign-in when the client asks.

Client configuration formats change between versions. If a snippet above does not match your client, follow its own MCP documentation and use the same URL.

Use a token instead of sign-in

For scripts and clients without MCP sign-in, use an MCP token.

1. Open CLI and MCP access in your ZRouter dashboard.
2. Name the token after your client and select Create MCP token.
3. Copy it right away. It is shown once and expires after 30 days.

Send it as a bearer token:

claude mcp add --transport http zrouter https://zrouter.si/mcp \
  --header "Authorization: Bearer YOUR_MCP_TOKEN"

{
  "mcpServers": {
    "zrouter": {
      "url": "https://zrouter.si/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}

Use an MCP token, not an account API key. API keys only send model requests and cannot manage your account, so a leaked API key cannot create keys or change budgets. Keep MCP tokens out of shared repository configuration, and revoke tokens you no longer use from the same dashboard page.

What you can ask

• "How much did I spend this week, by model?"
• "Show the requests that failed with 429 today."
• "Why did my last request to the support bot fail?"
• "Create a router called support-bot that splits traffic between two models."
• "Route easy prompts to a cheap model and hard ones to my strongest model."
• "Create an API key for staging and cap my spend at $10 a day."
• "Limit the staging user path to 60 requests a minute."

Connecting this server does not change your assistant's own model provider. To send model requests through ZRouter, set up an API key with one of the integration guides.

Tools

Every tool runs inside the authenticated account. Read-only tools are annotated readOnlyHint. Deletes and resets are annotated destructiveHint, so clients that confirm risky actions ask you first.

Account

Usage

Usage tools accept days (default 30), start_date and end_date (YYYY-MM-DD), user_path, model, and provider.

Logs

Models and routers

A router is a stable model name your app calls. The super_intelligence strategy scores each request by difficulty and sends it to simple_targets, standard_targets, or complex_targets.

API keys

Budgets

Rate limits

Budgets apply to a user_path or label. Rate limits apply to a user_path, provider, or model. Set per_child to apply a rule separately to each child user path.

Security

• Your account only. Each tool call goes through the same customer API as the dashboard, with your credential, so authentication, account scoping, and validation are identical.
• Separate credentials. MCP access uses OAuth tokens or MCP tokens. Account API keys cannot manage the account.
• Revocable. Disconnect apps under CLI and MCP access → Connected apps, and revoke MCP tokens on the same page.
• Bounded results. A single tool result is capped at 256 KB so a large log page cannot flood your assistant's context.
• Secrets in history. A new API key's secret appears in the api_keys_create result, and so in your assistant's conversation history. Treat that history accordingly, or create keys in the dashboard.

Authentication details

For client developers. The server follows the MCP authorization specification.

A request without a valid token gets 401 with:

WWW-Authenticate: Bearer resource_metadata="https://zrouter.si/.well-known/oauth-protected-resource/mcp", scope="account"

Quick check with an MCP token:

curl -s https://zrouter.si/mcp \
  -H "Authorization: Bearer YOUR_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Troubleshooting

FAQ

Is there anything to install or host? No. ZRouter hosts the server at https://zrouter.si/mcp.

Does it cost anything? No. Account management through MCP is free. Model requests you send with your API keys draw from your prepaid credit as usual.

Can the assistant reach another account? No. Every tool runs inside the account that signed in.

Does connecting MCP change which model my assistant uses? No. It only adds account management tools.

Can I manage the account from a terminal instead? Yes, with the zctl CLI.

Links

• Website: https://zrouter.si
• MCP guide: https://zrouter.si/docs/mcp
• API guide: https://zrouter.si/docs/api
• Integrations: https://zrouter.si/docs/integrations
• zctl CLI: https://zrouter.si/cli
• Status: https://zrouter.si/status
• Smithery https://smithery.ai/badge/sali/zrouter

License

The contents of this directory are available under the MIT License.