Zerouter

io.github.ZerouterAIPublished by GitHub account ZerouterAIv0.1.0Updated Oct 25, 2026

AI API gateway MCP: Claude, GPT, Gemini, Grok & Kimi with one Zerouter API key, plus API pricing.

VerifiedSTDIODesktop onlyData & AnalyticsAI & ML

Overview

AI-generated overview

Zerouter is a local MCP server that lets an assistant chat with Claude, GPT, Gemini, Grok and Kimi through one AI API gateway key, compare models, and look up 1

What you can do
Chat with any supported model through one gateway, sending a prompt or message list with optional system prompt, max tokens and temperature, with the server picking the right endpoint format per model family. Send one prompt to 2 to 4 models in parallel and get each answer with token usage, latency and estimated cost. Look up current API pricing per million input and output tokens next to vendor list prices, filtered by model or provider. List available model IDs and which endpoint each one uses. Override the endpoint per request when needed.
When to use it
Useful when you want several model families reachable from one editor or desktop client with a single key, when you want to compare answers from different models before committing, or when you want to check gateway pricing against official list prices without leaving the chat.
Requirements
Runs locally over stdio. Node.js 18 or newer with npm 10 or newer for the npx install, or the MCPB bundle for Claude Desktop, or a clone-and-build or Docker setup. A Zerouter account and API key in the ZEROUTER_API_KEY environment variable for chat and compare_models; pricing and model listing work without it. Network access to the gateway, whose URL can be changed with ZEROUTER_BASE_URL.
Before you install
The API key in ZEROUTER_API_KEY is a billable credential; chat and compare_models send prompts to a third-party gateway and incur charges, and compare_models multiplies that across several models. Prompts leave your machine for Zerouter's servers. The README also describes a provider program that routes paid traffic to your own AI accounts and pays out in USDC, which involves account and payment arrangements outside this server.

Installation

In SourceWeft

  1. Open Zerouter in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

zerouter-mcp

[GitHub release] [MCP Registry] [License: MIT]

AI API gateway MCP for Claude, GPT, Gemini, Grok and Kimi via Zerouter.

zerouter-mcp connects Claude Desktop, Cursor, Claude Code and other MCP clients to Zerouter, an OpenAI-compatible AI API gateway. With one API key you can chat with any supported model, compare answers side by side, or look up API pricing per 1M tokens, without leaving your editor.

Why Zerouter

  • One API key for Claude, GPT, Gemini, Grok and Kimi. The same sk- key routes to every model. Zerouter exposes Anthropic-compatible and OpenAI-compatible endpoints, so it works with Claude Code, Codex and Cursor—change the base URL and keep your existing clients.
  • API pricing you can check in chat. Claude Opus 5.5 on Zerouter is $1.16 input / $5.81 output per 1M tokens (Anthropic list price $4 / $20). Live rates for GPT, Gemini, Grok and Kimi are on the Zerouter pricing page.
  • Compare models before you commit. Send one prompt to 2–4 models in parallel and get each answer with token usage, latency and estimated cost.
  • Stable routing, real models. The model ID you send is the model that runs and the one you're billed for. Prompts aren't rewritten and models aren't swapped.
  • Host unused subscription quota. If you have an official AI account with capacity you don't use, the Zerouter provider program routes paid traffic to it and pays you the larger share of each request, currently about 80%, in USDC.

What it does

ToolWhat it's forNeeds a key?
get_pricingCurrent Zerouter API pricing per 1M input/output tokens, next to each vendor's official list price. Filter by model or provider.No
list_modelsAI model IDs you can call, and which endpoint each one uses.No (uses /v1/models when a key is set)
chatSend a prompt or a message list to any model, with optional system, max_tokens and temperature.Yes
compare_modelsSend the same prompt to 2–4 models in parallel. You get each answer back with token usage, latency and an estimated cost.Yes

You don't have to think about API formats. chat sends each request to the right Zerouter endpoint for you:

  • Claude and Kimi go to POST /v1/messages (Anthropic format)
  • GPT, Codex and Grok go to POST /v1/responses (OpenAI Responses)
  • Gemini and the compatible channels (Qwen/Dashscope and others) go to POST /v1/chat/completions

If you need to, you can override this with the endpoint argument.

Get a key

  1. Sign in at zerouter.ai and open the dashboard.
  2. Create an API key. Keys start with sk- and work for every model.
  3. Put it in the ZEROUTER_API_KEY environment variable, as in the configs below.

See the pricing page for current API pricing and the quickstart for setup details.

Setup

You need Node.js 18 or newer with npm 10 or newer (bundled with current Node 18/20/22 releases). npx fetches the server straight from GitHub, builds it once and runs it. The first start takes up to a minute while it installs; later starts use the npx cache.

The package isn't published to npm, so use github:ZerouterAI/zerouter-mcp as shown below (not zerouter-mcp). Prefer not to use npx? See Other ways to install.

Claude Desktop

Edit claude_desktop_config.json. On macOS it's in ~/Library/Application Support/Claude/ and on Windows in %APPDATA%\Claude\:

json
{  "mcpServers": {    "zerouter": {      "command": "npx",      "args": ["-y", "github:ZerouterAI/zerouter-mcp"],      "env": {        "ZEROUTER_API_KEY": "sk-xxxx"      }    }  }}

Restart Claude Desktop afterwards.

Cursor

Add this to ~/.cursor/mcp.json for all projects, or to .cursor/mcp.json in a single project:

json
{  "mcpServers": {    "zerouter": {      "command": "npx",      "args": ["-y", "github:ZerouterAI/zerouter-mcp"],      "env": {        "ZEROUTER_API_KEY": "sk-xxxx"      }    }  }}

Claude Code

bash
claude mcp add zerouter --env ZEROUTER_API_KEY=sk-xxxx -- npx -y github:ZerouterAI/zerouter-mcp

Add --scope user to make it available in every project.

Other ways to install

MCPB bundle (Claude Desktop one-click). Download zerouter-mcp-0.1.0.mcpb from the latest release and open it, or drag it into Claude Desktop under Settings → Extensions. Claude Desktop asks for your API key; no Node.js setup needed.

Clone and build. Works with any MCP client that can run a local command:

bash
git clone https://github.com/ZerouterAI/zerouter-mcp.gitcd zerouter-mcpnpm install        # also builds dist/ via the prepare script

Then point your client at the built file, using the absolute path on your machine:

json
{  "mcpServers": {    "zerouter": {      "command": "node",      "args": ["/absolute/path/to/zerouter-mcp/dist/index.js"],      "env": {        "ZEROUTER_API_KEY": "sk-xxxx"      }    }  }}

For Claude Code: claude mcp add zerouter --env ZEROUTER_API_KEY=sk-xxxx -- node /absolute/path/to/zerouter-mcp/dist/index.js

Docker

bash
docker build -t zerouter-mcp .docker run -i --rm -e ZEROUTER_API_KEY=sk-xxxx zerouter-mcp

Environment variables

VariableRequiredDefaultNotes
ZEROUTER_API_KEYFor chat and compare_modelsnoneYour key from zerouter.ai
ZEROUTER_BASE_URLNohttps://api.zerouter.aiChange it only if you route through a proxy
ZEROUTER_TIMEOUT_MSNo120000Timeout for each request

If no key is set, get_pricing and list_models still work. chat and compare_models return a clear error that tells you where to get a key.

Example prompts

  • "What does Claude Opus 5.5 cost on Zerouter compared with the official API pricing?"
  • "Ask gemini-3.8-flash to summarise this file."
  • "Compare claude-sonnet-5-5, gpt-6-sol and grok-4.6 on this regex question and tell me which answer is right."
  • "Which models on Zerouter cost less than $0.50 per million input tokens?"

Development

bash
git clone https://github.com/ZerouterAI/zerouter-mcp.gitcd zerouter-mcpnpm install       # runs the build through the prepare scriptnpm test          # spawns the server over stdio and calls every tool (no key needed)npx @modelcontextprotocol/inspector node dist/index.js

Links

License

MIT. Built by the Zerouter team.

Source: README.md at commit b5eb0d7

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestOct 17, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts