# ZRouter

> ZRouter is a paid MCP server for ai models and llm tooling. Manage a ZRouter AI gateway account by chat: usage, logs, routers, budgets and limits. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, Web, CLI
- **Website:** https://zrouter.si/docs/mcp
- **Repository:** https://github.com/nexusrun/zrouter
- **MCP Registry name:** io.github.nexusrun/zrouter
- **Categories:** AI models and LLM tooling
- **Listing updated:** 2026-11-16

## About

This is the management side of ZRouter, a gateway that offers one OpenAI-compatible key across models and providers. The MCP server does not route your model requests or change your assistant's provider; it lets an assistant inspect and administer the ZRouter account itself, within the same rules as the dashboard.

Its 24 tools cover spend summaries by day and by model, request log search and statistics, virtual model routers that can split traffic across models, and budgets and rate limits that can be listed, created, reset or deleted. The README counts 14 read-only tools, 4 write tools and 6 marked destructive. Example asks include spend by model this week, requests that failed with a 429 today, or a daily cap on a staging path.

Sign-in is OAuth with a URL-only setup in Claude, ChatGPT and Grok, or a separate MCP token created under CLI and MCP access that expires after 30 days. Ordinary API keys cannot manage the account, so a leaked key cannot change budgets. Gateway usage is prepaid credit from $5 or your own provider keys.

## Features

- **Usage reporting:** Summaries by day and model plus a request-level usage log.
- **Log search:** Search, fetch and summarise request logs, such as failed 429s.
- **Model routers:** Create and edit virtual models that split traffic across models.
- **Budgets:** List, set, delete and reset spend caps.
- **Rate limits:** List, set, delete and reset request limits.
- **Scoped tokens:** Separate MCP tokens keep model API keys from managing the account.

## Good for

- Find which model drove this week's spend
- Investigate failed requests in the logs
- Create a router that splits traffic between two models
- Cap a staging environment's daily spend

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://zrouter.si/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "zrouter": {
      "serverUrl": "https://zrouter.si/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "zrouter": {
      "type": "http",
      "url": "https://zrouter.si/mcp"
    }
  }
}
```

## Tools

- `usage_summary`: Usage summary
- `usage_daily`: Daily usage
- `usage_by_model`: Usage by model
- `usage_log`: Usage log
- `logs_search`: Search request logs
- `logs_get`: Get one log entry
- `logs_stats`: Log statistics
- `models_list`: List models
- `virtual_models_list`: List virtual model routers
- `virtual_models_upsert`: Create or update a router
- `virtual_models_delete`: Delete a router
- `budgets_list`: List budgets
- `budgets_upsert`: Create or update a budget
- `budgets_delete`: Delete a budget
- `budgets_reset`: Reset a budget
- `rate_limits_list`: List rate limits
- `rate_limits_upsert`: Create or update a rate limit
- `rate_limits_delete`: Delete a rate limit
- `rate_limits_reset`: Reset a rate limit

## FAQ

### Does it change my assistant's model provider?

No. It only manages the ZRouter account, not model requests.

### Can an API key be used?

No. A separate MCP token or OAuth sign-in is needed.

### How long does a token last?

30 days, and it can be revoked from the dashboard.

### Can it touch other accounts?

No. Each tool runs inside the authenticated account.

### Is ZRouter free?

No. ZRouter is a paid product.

### How do I add ZRouter to Claude Code?

Run this command in your terminal: claude mcp add --transport http zrouter https://zrouter.si/mcp

### What are the best alternatives to ZRouter?

The closest alternatives to ZRouter are Claude Code Ultimate Guide, signafAIde, Toolkien, Lugh and HypePaper.

## Alternatives

- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [signafAIde](https://ai-powered.com/mcp/signafaide): signafAIde is a freemium MCP server for security.
- [Toolkien](https://ai-powered.com/mcp/toolkien): Toolkien is an open-source MCP server for ai models and llm tooling.
- [Lugh](https://ai-powered.com/mcp/lugh): Lugh is an open-source MCP server for ai models and llm tooling.
- [HypePaper](https://ai-powered.com/mcp/hypepaper): HypePaper is a freemium MCP server for ai models and llm tooling.
- [Agent Data Tools: Compact (find, describe, run)](https://ai-powered.com/mcp/agent-data-tools-compact-find-describe-run): Agent Data Tools: Compact (find, describe, run) is a freemium MCP server for developer tools.
- [Angel Agent Guard: pre-purchase check + prompt-injection scan](https://ai-powered.com/mcp/angel-agent-guard-pre-purchase-check-prompt-injection-scan): Angel Agent Guard: pre-purchase check + prompt-injection scan is a freemium MCP server for ai models and llm tooling.
- [Mizan Calibration](https://ai-powered.com/mcp/mizan-calibration): Mizan Calibration is a free MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/zrouter
