Zerouter MCP

Puerta de enlace de API de IA MCP para Claude, GPT, Gemini, Grok y Kimi a través de Zerouter.

Documentación

zerouter-mcp

Puerta de enlace de API de IA para MCP, compatible con Claude, GPT, Gemini, Grok y Kimi a través de Zerouter.

zerouter-mcp conecta Claude Desktop, Cursor, Claude Code y otros clientes MCP con Zerouter, una puerta de enlace de API de IA compatible con OpenAI. Con una sola clave de API puedes chatear con cualquier modelo compatible, comparar respuestas lado a lado o consultar los precios de la API por cada 1M de tokens, sin salir de tu editor.

Por qué Zerouter

Una sola clave de API para Claude, GPT, Gemini, Grok y Kimi. La misma clave sk- enruta a todos los modelos. Zerouter expone endpoints compatibles con Anthropic y OpenAI, por lo que funciona con Claude Code, Codex y Cursor: cambia la URL base y conserva tus clientes existentes.
Precios de API que puedes consultar en el chat. Claude Opus 5.5 en Zerouter cuesta $1.16 de entrada / $5.81 de salida por 1M de tokens (precio de lista de Anthropic: $4 / $20). Las tarifas actualizadas para GPT, Gemini, Grok y Kimi están en la página de precios de Zerouter.
Compara modelos antes de comprometerte. Envía un mismo prompt a 2–4 modelos en paralelo y recibe cada respuesta con uso de tokens, latencia y costo estimado.
Enrutamiento estable, modelos reales. El ID de modelo que envías es el modelo que se ejecuta y por el que se te factura. Los prompts no se reescriben ni los modelos se intercambian.
Hospeda cuota de suscripción no utilizada. Si tienes una cuenta oficial de IA con capacidad que no usas, el programa de proveedores de Zerouter enruta tráfico pagado hacia ella y te paga la mayor parte de cada solicitud, actualmente alrededor del 80%, en USDC.

Qué hace

Herramienta	Para qué sirve	¿Necesita clave?
`get_pricing`	Precios actuales de la API de Zerouter por 1M de tokens de entrada/salida, junto al precio de lista oficial de cada proveedor. Filtra por modelo o proveedor.	No
`list_models`	IDs de modelos de IA que puedes usar y qué endpoint utiliza cada uno.	No (usa `/v1/models` cuando hay una clave configurada)
`chat`	Envía un prompt o una lista de mensajes a cualquier modelo, con `system`, `max_tokens` y `temperature` opcionales.	Sí
`compare_models`	Envía el mismo prompt a 2–4 modelos en paralelo. Recibes cada respuesta con uso de tokens, latencia y un costo estimado.	Sí

No tienes que pensar en formatos de API. chat envía cada solicitud al endpoint correcto de Zerouter por ti:

Claude y Kimi van a POST /v1/messages (formato Anthropic)
GPT, Codex y Grok van a POST /v1/responses (OpenAI Responses)
Gemini y los canales compatibles (Qwen/Dashscope y otros) van a POST /v1/chat/completions

Si lo necesitas, puedes anular esto con el argumento endpoint.

Obtén una clave

Inicia sesión en zerouter.ai y abre el panel de control.
Crea una clave de API. Las claves comienzan con sk- y funcionan para todos los modelos.
Colócala en la variable de entorno ZEROUTER_API_KEY, como en las configuraciones a continuación.

Consulta la página de precios para conocer los precios actuales de la API y la guía de inicio rápido para los detalles de configuración.

Configuración

Necesitas Node.js 18 o superior con npm 10 o superior (incluido con las versiones actuales de Node 18/20/22). npx descarga el servidor directamente desde GitHub, lo compila una vez y lo ejecuta. El primer inicio tarda hasta un minuto mientras se instala; los inicios posteriores usan la caché de npx.

El paquete no está publicado en npm, así que usa github:ZerouterAI/zerouter-mcp como se muestra a continuación (no zerouter-mcp). ¿Prefieres no usar npx? Consulta Otras formas de instalar.

Claude Desktop

Edita claude_desktop_config.json. En macOS está en ~/Library/Application Support/Claude/ y en Windows en %APPDATA%\Claude\:

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

Reinicia Claude Desktop después.

Cursor

Añade esto a ~/.cursor/mcp.json para todos los proyectos, o a .cursor/mcp.json en un solo proyecto:

{
  "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

Añade --scope user para que esté disponible en todos los proyectos.

Otras formas de instalar

Paquete MCPB (instalación de un clic en Claude Desktop). Descarga zerouter-mcp-0.1.0.mcpb desde la última versión y ábrelo, o arrástralo a Claude Desktop en Configuración → Extensiones. Claude Desktop te pedirá tu clave de API; no necesitas configurar Node.js.

Clonar y compilar. Funciona con cualquier cliente MCP que pueda ejecutar un comando local:

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

Luego apunta tu cliente al archivo compilado, usando la ruta absoluta en tu 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

Variables de entorno

Variable	Obligatoria	Predeterminada	Notas
`ZEROUTER_API_KEY`	Para `chat` y `compare_models`	ninguna	Tu clave de zerouter.ai
`ZEROUTER_BASE_URL`	No	`https://api.zerouter.ai`	Cámbiala solo si enrutas a través de un proxy
`ZEROUTER_TIMEOUT_MS`	No	`120000`	Tiempo de espera para cada solicitud

Si no hay clave configurada, get_pricing y list_models siguen funcionando. chat y compare_models devuelven un error claro que te indica dónde obtener una clave.

Ejemplos de prompts

"¿Cuánto cuesta Claude Opus 5.5 en Zerouter comparado con el precio oficial de la API?"
"Pide a gemini-3.8-flash que resuma este archivo."
"Compara claude-sonnet-5-5, gpt-6-sol y grok-4.6 en esta pregunta de regex y dime qué respuesta es correcta."
"¿Qué modelos en Zerouter cuestan menos de $0.50 por millón de tokens de entrada?"

Desarrollo

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

Enlaces

Empieza aquí: zerouter.ai — obtén una clave y mira cómo funciona
Lista de modelos: zerouter.ai/models
Precios de API: zerouter.ai/pricing
Documentación: zerouter.ai/docs
Programa de proveedores: provider.zerouter.ai/docs
Problemas: github.com/ZerouterAI/zerouter-mcp/issues

Licencia

MIT. Creado por el equipo de Zerouter.