Zerouter MCP

zerouter-mcp

Gateway de API de IA para MCP, compatível com Claude, GPT, Gemini, Grok e Kimi via Zerouter.

O zerouter-mcp conecta Claude Desktop, Cursor, Claude Code e outros clientes MCP ao Zerouter, um gateway de API de IA compatível com OpenAI. Com uma única chave de API, você pode conversar com qualquer modelo compatível, comparar respostas lado a lado ou consultar preços de API por 1M de tokens, sem sair do seu editor.

Por que Zerouter

• Uma chave de API para Claude, GPT, Gemini, Grok e Kimi. A mesma chave sk- roteia para todos os modelos. O Zerouter expõe endpoints compatíveis com Anthropic e OpenAI, então funciona com Claude Code, Codex e Cursor—altere a URL base e mantenha seus clientes existentes.
• Preços de API que você pode consultar no chat. Claude Opus 5.5 no Zerouter custa $1,16 de entrada / $5,81 de saída por 1M de tokens (preço de tabela da Anthropic: $4 / $20). Tarifas atualizadas para GPT, Gemini, Grok e Kimi estão na página de preços do Zerouter.
• Compare modelos antes de se comprometer. Envie um prompt para 2–4 modelos em paralelo e receba cada resposta com uso de tokens, latência e custo estimado.
• Roteamento estável, modelos reais. O ID do modelo que você envia é o modelo que executa e pelo qual você é cobrado. Os prompts não são reescritos e os modelos não são trocados.
• Hospede cota de assinatura não utilizada. Se você tem uma conta oficial de IA com capacidade que não usa, o programa de provedores do Zerouter roteia tráfego pago para ela e paga a você a maior parte de cada requisição, atualmente cerca de 80%, em USDC.

O que ele faz

Ferramenta	Para que serve	Precisa de chave?
get_pricing	Preços atuais da API Zerouter por 1M de tokens de entrada/saída, ao lado do preço de tabela oficial de cada fornecedor. Filtre por modelo ou provedor.	Não
list_models	IDs de modelos de IA que você pode chamar e qual endpoint cada um usa.	Não (usa /v1/models quando uma chave está definida)
chat	Envie um prompt ou uma lista de mensagens para qualquer modelo, com system, max_tokens e temperature opcionais.	Sim
compare_models	Envie o mesmo prompt para 2–4 modelos em paralelo. Você recebe cada resposta com uso de tokens, latência e custo estimado.	Sim

Você não precisa se preocupar com formatos de API. O chat envia cada requisição para o endpoint Zerouter correto para você:

• Claude e Kimi vão para POST /v1/messages (formato Anthropic)
• GPT, Codex e Grok vão para POST /v1/responses (OpenAI Responses)
• Gemini e os canais compatíveis (Qwen/Dashscope e outros) vão para POST /v1/chat/completions

Se precisar, você pode substituir isso com o argumento endpoint.

Obtenha uma chave

1. Entre em zerouter.ai e abra o painel.
2. Crie uma chave de API. As chaves começam com sk- e funcionam para todos os modelos.
3. Coloque-a na variável de ambiente ZEROUTER_API_KEY, como nas configurações abaixo.

Consulte a página de preços para preços atuais da API e o quickstart para detalhes de configuração.

Configuração

Você precisa de Node.js 18 ou mais recente com npm 10 ou mais recente (incluído nas versões atuais do Node 18/20/22). O npx busca o servidor diretamente do GitHub, compila uma vez e o executa. A primeira inicialização leva até um minuto enquanto instala; as inicializações seguintes usam o cache do npx.

O pacote não é publicado no npm, então use github:ZerouterAI/zerouter-mcp como mostrado abaixo (não zerouter-mcp). Prefere não usar npx? Veja Outras formas de instalar.

Claude Desktop

Edite claude_desktop_config.json. No macOS, está em ~/Library/Application Support/Claude/ e no Windows em %APPDATA%\Claude\:

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

Reinicie o Claude Desktop depois.

Cursor

Adicione isso a ~/.cursor/mcp.json para todos os projetos, ou a .cursor/mcp.json em um único projeto:

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

Claude Code

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

Adicione --scope user para disponibilizá-lo em todos os projetos.

Outras formas de instalar

Pacote MCPB (instalação com um clique no Claude Desktop). Baixe zerouter-mcp-0.1.0.mcpb da última versão e abra-o, ou arraste-o para o Claude Desktop em Configurações → Extensões. O Claude Desktop pede sua chave de API; não é necessária configuração do Node.js.

Clone e compile. Funciona com qualquer cliente MCP que possa executar um comando local:

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

Depois aponte seu cliente para o arquivo compilado, usando o caminho absoluto na sua máquina:

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

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

Docker

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

Variáveis de ambiente

Variável	Obrigatória	Padrão	Observações
ZEROUTER_API_KEY	Para chat e compare_models	nenhum	Sua chave de zerouter.ai
ZEROUTER_BASE_URL	Não	https://api.zerouter.ai	Altere apenas se você rotear por um proxy
ZEROUTER_TIMEOUT_MS	Não	120000	Tempo limite para cada requisição

Se nenhuma chave estiver definida, get_pricing e list_models ainda funcionam. chat e compare_models retornam um erro claro que informa onde obter uma chave.

Exemplos de prompts

• "Quanto custa o Claude Opus 5.5 no Zerouter comparado ao preço oficial da API?"
• "Peça ao gemini-3.8-flash para resumir este arquivo."
• "Compare claude-sonnet-5-5, gpt-6-sol e grok-4.6 nesta questão de regex e me diga qual resposta está correta."
• "Quais modelos no Zerouter custam menos de $0,50 por milhão de tokens de entrada?"

Desenvolvimento

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

Links

• Comece aqui: zerouter.ai — obtenha uma chave e veja como funciona
• Lista de modelos: zerouter.ai/models
• Preços da API: zerouter.ai/pricing
• Documentação: zerouter.ai/docs
• Programa de provedores: provider.zerouter.ai/docs
• Problemas: github.com/ZerouterAI/zerouter-mcp/issues

Licença

MIT. Desenvolvido pela equipe Zerouter.