ZROUTER DOCUMENTATION

From first key
to first request.

Connect your application, create a virtual model, and understand usage and charges. Manage your workspace in the dashboard, automate it with zctl, or connect an AI assistant through MCP.

Start with the quickstart

zctl CLI

Who should use the CLI, when to use it, installation on Linux, macOS, and Windows, router commands, and account automation.

Install and use zctl
START HERE

Your first ZRouter request

Create an account with an available sign-in method, choose your funding method, generate an API key, and connect your application.

Quickstart

API guide

Authentication, supported endpoints, provider-qualified models, streaming, and common errors.

Explore the API

Bring your own keys

Connect supported provider credentials and use your own keys on individual requests.

Set up BYOK

Virtual models and routers

What they are, who they help, and how to create private routes in the dashboard, CLI, or MCP.

Create a virtual model ↗

Super Intelligence Router

Easy prompts to fast, cheap models. Hard reasoning to your strongest one. Decided per request.

Route by difficulty

Scheduled routing

Send peak hours to your fastest model and off-peak hours to a cheaper one, behind one model name.

Route by time

Manage with AI (MCP)

Let Claude Code, Cursor, or any MCP client manage your routers, keys, usage, budgets, and limits.

Connect an agent

Credits and billing

Purchases, current token rates, credit reservations, actual charges, and your ledger.

Understand billing

KNOW YOUR WORKSPACE

The dashboard,
at a glance.

Sign in to see your available models, account features, and usage. CLI and MCP access manage the same account as your dashboard.

Overview & usageToken totals, model activity, and provider cost estimates.
Request logsYour available request history and details, subject to logging settings.
API keys & BYOKYour account API keys and encrypted provider connections.
Billing & creditsYour shared credit balance and latest 100 ledger entries.
Budgets & rate limitsYour scoped rules when enabled. Resets do not clear credit charges.
Models & playgroundDiscover available models and test requests with an account API key.

CONNECT YOUR TOOLS

Make ZRouter part
of your workflow.

Step-by-step setup, copyable configuration, BYOK, and connection checks. Each guide explains prepaid and standalone requirements.

WORK WHERE YOU BUILD

One account.
Three ways to manage it.

Use the dashboard for a visual view, zctl for repeatable commands, or MCP to work with your AI assistant.

See it in the dashboard

Compare usage, inspect available request logs, manage credits, and test models in the playground. Start here when you want to see the whole account.

Open the quickstart ↗

Automate it with zctl

Create and edit virtual routers, manage keys, and review usage from your terminal. JSON output and router exports make account tasks easier to repeat in scripts.

Install the zctl CLI ↗

Ask your agent through MCP

Connect Claude Code, Cursor, or another compatible MCP client. Ask about usage, investigate errors, and manage routers, API keys, and enabled account limits.

Connect an MCP client ↗

CLI and MCP management access is limited to your account. Connecting MCP does not change your agent's inference provider. See each tool's integration guide for model-request support.

YOUR NEXT REQUEST STARTS HERE

Build with AI.
Keep the controls.

One account for model access, routing, and usage. Manage it from your dashboard, terminal, or AI assistant.

Create your account Read the quickstart No card needed to create an account.