th3nolo

Openrouter MCP — AI skill for Claude Code

AI community

Stateless MCP server and CLI for OpenRouter (MCP 2026-07-28): use any OpenRouter model from Claude Code and other MCP clients.

How to install Openrouter MCP

This entry records only its repository, not the path inside it, so there is no exact command to give. Open th3nolo/openrouter-mcp and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Openrouter MCP does

Stateless MCP server and CLI for OpenRouter (MCP 2026-07-28): use any OpenRouter model from Claude Code and other MCP clients. 13 tools, 1 resource, HTTP and stdio.

Alternatives in AI

Zen MCP Server — The power of Claude Code + Gemini / OpenAI / Grok / OpenRouter / Ollama / Custom Model working as one 11.3k ★
Firecrawl MCP Server — 🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM c 6.1k ★
Peekaboo — Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, o 3.2k ★

README

OpenRouter MCP server

This project connects agents to OpenRouter through two front doors: an agent-first command-line interface and a strict stateless MCP server. Both use the same operation layer and stable response shapes. The MCP server exposes thirteen focused tools and one API-key usage resource.

Version 3.0 targets MCP `2026-07-28` only. Each HTTP POST is independent. The server does not accept `initialize`, create `Mcp-Session-Id` sessions, expose a GET event stream, or run a legacy fallback.

Design notes and the reasoning behind the stateless `2026-07-28` surface are in the engineering note [Building a strict stateless MCP 2026-07-28 server for OpenRouter](https://th3nolo.com/articles/openrouter-stateless-mcp-2026-07-28). More notes and case studies: [th3nolo.com](https://th3nolo.com). Author: Manuel Parra.

What changed in 3.0

list_models sends pagination, filters, and sorting to OpenRouter instead of downloading the full catalog.
get_model calls OpenRouter's direct model endpoint. It replaces get_model_info; there is no alias.
list_model_endpoints returns provider price, context, uptime, latency, throughput, and supported parameters.
list_providers exposes provider geography, policy links, and service-status metadata without a browser.
list_model_rankings and list_app_rankings expose bounded versions of OpenRouter's public rankings pages.
get_credits and list_activity expose account data with a separate management-key boundary.
get_analytics_schema and query_analytics expose the current Activity Explore analytics contract with explicit time ranges and bounded results.
chat_with_model and compare_models return a generation_id and the resolved model.
get_generation uses that ID to fetch exact provider, token, latency, and cost metadata.
The openrouter-mcp CLI exposes the same operations directly, emits JSON automatically when piped, and never prompts.
Browser inspection informed the surface contr