ZRouter MCP server

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

Shortened. The full README is on GitHub.