OpenRouter MCP: configuración, llamadas a modelos y concesiones reales

OpenRouter MCP es un servidor alojado del Model Context Protocol pensado para investigar y probar modelos. Un agente puede consultar precios, benchmarks, endpoints y documentación actualizados antes de comprometerse con un modelo. Eso sí: no sustituye a la API de OpenRouter en producción.

En pocas palabras: qué aporta OpenRouter MCP

El servidor oficial está disponible en https://mcp.openrouter.ai/mcp. Un cliente compatible, como Claude Code, Cursor o Claude Desktop, se conecta mediante HTTP remoto y permite que el agente invoque herramientas de OpenRouter dentro de la conversación. Sirve para investigar y probar el catálogo; cuando toca integrar llamadas en una aplicación o trabajar con una cuenta concreta, la opción adecuada sigue siendo la API de producción o el MCP del propio proveedor.

El anuncio oficial de OpenRouter describe sus datos en vivo sobre modelos, rankings, precios, documentación e inferencia de prueba. La documentación de MCP es la referencia para conocer el endpoint, las herramientas y el funcionamiento de la autenticación.

Empieza por el flujo de trabajo, no por la URL del servidor

El patrón más útil es descubrir, comparar, probar y revisar. Así, la pregunta «¿Cuál es el mejor modelo?» se convierte en una decisión basada en requisitos concretos.

1. Descubre: pide modelos que cumplan determinados requisitos de tarea, precio, contexto, modalidad o proveedor. Usa list-models y list-benchmarks para consultar el catálogo y los benchmarks actuales.
2. Compara: llama a list-model-endpoints para cada candidato y consulta, cuando estén disponibles, los precios por proveedor, la latencia, el rendimiento y las políticas de datos.
3. Prueba: ejecuta el mismo prompt con send-message y un slug de modelo concreto. La inferencia puede generar un cargo.
4. Revisa: pasa cada ID de generación a get-generation para consultar tokens, coste y proveedor que sirvió la petición.

Puedes usar este prompt en Claude Code o Cursor:

Usa OpenRouter MCP para encontrar tres modelos que sirvan para extraer datos estructurados de
 documentos legales. Requisitos: al menos 100k de contexto, llamadas a herramientas y el
 menor precio de entrada disponible. Compara los proveedores y sus políticas de datos. Después usa
 send-message para ejecutar este prompt exacto con los dos mejores candidatos:

"Extrae todas las fechas de renovación del contrato del texto siguiente. Devuelve únicamente JSON
con un array llamado renewals; cada elemento debe contener party, date y evidence."

Cuando terminen las pruebas, usa get-generation con cada ID de generación e informa del
coste real y del proveedor que sirvió la respuesta. No llames a ningún modelo hasta que apruebe los
candidatos.

Exige aprobación antes de probar: las búsquedas del catálogo son de solo lectura, pero send-message puede generar un cargo de inferencia. Para evaluaciones repetibles, especifica el modelo y el proveedor; sufijos como :free, :floor, :nitro y :online expresan preferencias de enrutamiento cuando están disponibles, no garantías fijas de calidad.

Conecta el servidor remoto oficial

No hace falta instalar nada en local. Añade el endpoint remoto, completa la autenticación OAuth desde el navegador y autoriza una clave de OpenRouter exclusiva, separada del resto. La configuración predeterminada documentada establece una caducidad de 7 días y un límite de gasto de $10, que puedes editar en la pantalla de aprobación. OpenRouter documenta OAuth con PKCE, así que la autorización se realiza en el navegador en lugar de pegar una clave API normal en la configuración del cliente.

Claude Code

Ejecuta:

claude mcp add --transport http openrouter https://mcp.openrouter.ai/mcp
claude mcp login openrouter

El primer comando registra el servidor HTTP remoto; el segundo abre el flujo OAuth. Dentro de una sesión de Claude Code, la documentación de MCP de Claude Code también permite usar /mcp: selecciona el servidor OpenRouter y autentícate.

Comprueba la conexión con una petición de solo lectura, por ejemplo: «Usa OpenRouter MCP para listar dos modelos actuales con al menos 128k de contexto y mostrar sus precios de entrada».

Cursor

Añade el servidor remoto a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "openrouter": {
      "url": "https://mcp.openrouter.ai/mcp"
    }
  }
}

Si el servidor no aparece, vuelve a cargar Cursor. La autenticación se inicia desde los ajustes de MCP de Cursor o la primera vez que se utiliza una herramienta. El CLI documentado es cursor-agent; verifica la entrada con:

cursor-agent mcp list

La documentación de MCP de Cursor explica su configuración a nivel de usuario y de proyecto. Coloca la entrada en el nivel que necesites y no subas a un repositorio compartido una configuración de autenticación personal.

Claude Desktop y Claude Web

Si OpenRouter no aparece en el directorio de conectores de Claude, la guía de conexión de OpenRouter indica que debes añadir un conector remoto personalizado:

1. Abre Settings > Connectors > Customize > Connectors.
2. Haz clic en + y elige Add custom connector.
3. Llámalo OpenRouter MCP.
4. Introduce https://mcp.openrouter.ai/mcp como URL del servidor MCP remoto.
5. Deja vacíos los campos de OAuth, añade el conector, ábrelo y haz clic en Connect.
6. Completa la aprobación de OpenRouter en el navegador.

Algunas organizaciones desactivan los conectores personalizados. Si la opción no aparece en una cuenta gestionada, consulta al administrador. La documentación de MCP de Anthropic cubre los conceptos del protocolo en el cliente.

Qué puedes pedirle sin asumir riesgos innecesarios

La mayoría de las herramientas oficiales de OpenRouter MCP son consultas en vivo. Resulta más práctico clasificarlas por sus efectos que memorizar todo el inventario.

Para elegir, formula claramente el criterio: «Encuentra el modelo más barato con llamadas a herramientas y una ventana de contexto de 64k; después muestra el endpoint disponible más rápido». Los filtros documentados incluyen precio, contexto mínimo, familia del modelo, autor, proveedor, modalidad, parámetros compatibles, rangos de benchmarks, tasa de éxito de las llamadas a herramientas, disponibilidad de retención cero de datos y región.

Para una prueba controlada, especifica el slug y haz que el prompt sea reproducible:

Usa OpenRouter MCP send-message con el modelo "openai/gpt-4o".
Envía exactamente este mensaje de usuario y no añadas ningún system prompt:

"Devuelve un objeto JSON con las claves title y risks. Analiza esta nota de lanzamiento:
[pega aquí el texto]"

Muéstrame la respuesta y el ID de generación. No ejecutes otro modelo.

El slug es orientativo; utiliza uno que list-models confirme que está disponible. Para que la comparación se pueda auditar, exige explícitamente las herramientas de consulta, los valores devueltos y un ID de generación, en lugar de aceptar una recomendación de modelo sin respaldo.

OpenRouter MCP frente a los MCP oficiales de los proveedores

OpenRouter MCP funciona como una capa de inteligencia y pruebas entre proveedores. Cuando la acción pertenece al producto, la cuenta o el plano de datos de un proveedor concreto, normalmente conviene más su MCP oficial.

Elige OpenRouter MCP cuando la pregunta sea «¿Qué modelo o ruta debería usar?». Opta por el MCP propio de un proveedor cuando quieras saber «¿Qué puedo hacer dentro del servicio de este proveedor?». Puedes conectar ambos al mismo agente si necesitas las dos capacidades.

Los servidores MCP locales, multimodales o creados por la comunidad son otra categoría. La página Works With OpenRouter describe un servidor para varios clientes y flujos de trabajo de texto, imagen, audio y vídeo; requiere una clave API y créditos de OpenRouter, y no es el servicio alojado oficial de mcp.openrouter.ai.

Los límites que importan en un proyecto real

«El arnés/CLI de @OpenRouter ha sido una bendición... P. D.: gracias también por el MCP de OpenRouter, que permite consultar rápidamente información sobre los modelos 🫰» — @CodewithP, X, sobre un caso de uso para consultar información de modelos.

El recetario MCP de OpenRouter también aborda el caso inverso: utilizar modelos de OpenRouter como backend LLM para otros servidores de herramientas MCP, en lugar de conectar un cliente de programación a OpenRouter MCP.

Cómo diagnosticar el primer fallo

1. El servidor aparece, pero las herramientas fallan al autenticarse. Repite el paso de OAuth específico del cliente. La clave exclusiva tiene una duración documentada de 7 días y también puedes desconectarla desde el panel de OpenRouter.
2. No se abre ninguna ventana del navegador. Usa claude mcp login openrouter, la acción /mcp de Claude Code, los ajustes de MCP de Cursor o el botón Connect del conector de Claude.
3. Claude Desktop no muestra la opción de conector personalizado. Comprueba si el administrador de la organización ha desactivado los conectores personalizados.
4. La respuesta sobre un modelo parece desactualizada. Pide explícitamente list-models, list-benchmarks o list-model-endpoints, y exige los valores devueltos.
5. La prueba cuesta más o utiliza una ruta distinta de la esperada. Revisa su ID de generación con get-generation y fija después un proveedor concreto para la siguiente evaluación reproducible.

Preguntas frecuentes

¿OpenRouter MCP puede llamar a cualquier modelo de OpenRouter?

Puede probar los slugs de modelos que expone el catálogo en vivo, siempre dentro de las restricciones de disponibilidad, capacidades, crédito y enrutamiento. Confirma primero el slug con list-models.

¿Puedo usar OpenRouter MCP con Claude Desktop, Cursor y Claude Code al mismo tiempo?

Puedes añadir el mismo endpoint oficial a cada cliente, siguiendo la configuración y el flujo de autenticación documentados para cada uno. Mantén la configuración compartida libre de credenciales personales.

¿Debería instalar un paquete comunitario openrouter-mcp?

Solo si necesitas un flujo de trabajo local mediante stdio o una orquestación multimodal que el servidor alojado oficial no ofrezca. Antes, comprueba el repositorio, la gestión de credenciales, el origen del paquete y su estado de mantenimiento.

Empieza con una consulta del catálogo de solo lectura y autoriza una llamada de inferencia controlada únicamente cuando tengas claros el modelo, la ruta y el límite de gasto.