list_models
Search, filter, sort, and page the live model catalog
LABSCO SUMMARY
A second opinion from any of 400+ models, one call away.
compare_models is the reason to install it: one prompt, several models, answers laid out together, instead of several tabs and a lot of copying. Everything runs on your own OpenRouter key, so the bill lands where you expect it to.
What it is
A TypeScript server over OpenRouter, which fronts 400+ models behind one API. Thirteen tools and one usage resource, and every paid call bills to your own OpenRouter key.
What you get
- The live model catalog searched, filtered, sorted and paged, with a direct lookup for one exact model — list_models, get_model
- A message sent to one named model, with max_tokens, temperature and a system prompt of your choosing — chat_with_model
- The same prompt sent to several models and returned side by side — compare_models
- Providers compared for one model on price, context, uptime, latency and throughput, and providers filtered by headquarters or datacenter — list_model_endpoints, list_providers
- Rankings, generation cost lookups and, with a management key, credits, account activity and analytics — list_model_rankings, list_app_rankings, get_generation, get_credits, list_activity, get_analytics_schema, query_analytics
Requirements
Node.js 24 LTS, pnpm 12.0.0 and OPENROUTER_API_KEY. Clone the repository, run pnpm install and pnpm run check (which also builds it), then point your client at node dist/server.js. OPENROUTER_MANAGEMENT_KEY is optional and only needed for credits, account activity and analytics. The server speaks only MCP 2026-07-28 and does not accept the older initialize handshake.
Setup effort
Build from source — git clone https://github.com/th3nolo/openrouter-mcp.git
USE CASES
01
Checking an answer against a different model
Send the same question to a model from another family and read both replies back in one place, rather than switching tools to do it.
02
Picking a model for a job on price and context
List what is available with pricing and context length attached, then read one model's full specification before committing to it.
03
Testing a prompt across candidates
Fan the same prompt out to several model ids at once with a shared max_tokens, and compare how each one handles it.
13 tools
Listed in project docs. Your client may show a different list.
get_model
Read one exact model, variant, or alias
list_model_endpoints
Compare the providers serving one model
list_providers
Filter providers by name, headquarters, or datacenter
list_model_rankings
Read one completed UTC day of model rankings
list_app_rankings
Read popular or trending public apps
get_credits
Read purchased, used, and remaining credits
list_activity
Read endpoint-level daily account activity
get_analytics_schema
Discover current analytics metrics, dimensions, operators, and granularities
query_analytics
Query bounded Activity Explore aggregates over an explicit time range
chat_with_model
Generate one response and return its generation ID
compare_models
Generate with two to eight models, three calls at a time
get_generation
Read provider, tokens, latency, and cost for one generation ID
BEFORE YOU INSTALL
What to know first
Tools you get
13 tools named in the project's documentation. openrouter://usage is the one resource, and it reads usage and limits for your API key. get_credits, list_activity, get_analytics_schema and query_analytics need an OpenRouter management key.
Requires
- Node.js 24 LTS
- pnpm 12.0.0
- OPENROUTER_API_KEY in your environment
Optional
OPENROUTER_MANAGEMENT_KEY in your environment
INSTALLATION
Connect your client
You clone this one yourself.
Server setup
TERMINAL
git clone https://github.com/th3nolo/openrouter-mcp.git
cd openrouter-mcp
pnpm install
pnpm run check
cp .env.example .envEdit .env and set your API key:
FILE · .env
OPENROUTER_API_KEY=<YOUR_OPENROUTER_API_KEY>Register the server with your client (the claude mcp add line, or the mcpServers block)
MCP Clients
Claude Code
CLAUDE CODE · TERMINAL
claude mcp add --transport stdio --scope user \
--env OPENROUTER_API_KEY=<YOUR_OPENROUTER_API_KEY> \
openrouter -- node <YOUR_PATH_TO_OPENROUTER_MCP>/dist/server.jsClaude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"openrouter": {
"command": "node",
"args": [
"<YOUR_PATH_TO_OPENROUTER_MCP>/dist/server.js",
"--transport",
"stdio"
],
"env": {
"OPENROUTER_API_KEY": "<YOUR_OPENROUTER_API_KEY>",
"OPENROUTER_BASE_URL": "https://openrouter.ai/api/v1",
"OPENROUTER_APP_NAME": "OpenRouter MCP Server"
}
}
}
}
