AgentIndex icon
AgentIndex
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Submit Tool
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompare
Home/
LLM Infra/
llm-router
llm-router logo

llm-router

Active·★ 119·MIT·Updated 2026-10-22

LLM Router is an MCP server plus a set of hooks for AI coding tools. It targets a common waste: using your best model for everything, including simple explanations, file lookups and small edits. Every prompt passes a UserPromptSubmit hook before the top-tier model sees it, and the router sends easy work to cheap or free models and keeps hard work on Claude or another premium model.

The README describes a layered decision: reuse the previous turn's route for replies like "yes" or "go ahead", score the prompt with free heuristics, ask a local Ollama model when the heuristics are unsure, and only then fall back to paid APIs. In subscription mode it follows a free-first chain of Ollama, then Codex, then a paid API. It lists 46 MCP tools and 20+ providers, with budget caps per provider, a dashboard, Prometheus metrics and OpenTelemetry traces. One command installs it for Claude Code, VS Code, Cursor, Codex CLI and other hosts, and Claude Code Pro or Max users can start without any API key.

© 2026 AgentIndex.app|Built by a 10-year iOS Developer.
Best by use caseAboutContactAdvertisePrivacy PolicyTerms of UseQYSGitHubBuy me a coffee ☕

Browse by Category

MCP ServersCode AssistantWorkflow AutomationRAG / Knowledge BaseMulti-AgentBrowser AutomationLLM InfraDev ToolingObservability

Not affiliated with Anthropic, OpenAI or Microsoft.

Guides

This write-up is based on the project's README and public repository data. We have not hand-tested the tool. Data as of 2026-10-17.

License
MIT
Latest release
v15.4.0 · 2026-09-29
Last commit
2026-10-17
Contributors
3
Forks
18
Open issues and PRs
17
First published
2026-03-28
PyPI package
claude-code-llm-router 7.6.1 · 70 downloads last week

Source: GitHub, npm and PyPI public APIs.

#ai-routing#anthropic#claude#claude-code#cost-optimization#gemini#litellm#llm
$ Install
$ pipx install claude-code-llm-router && llm-router install
↗ Visit site★ GitHub
01

Features

01Intelligent routing with task classification and cost optimization
0246 tools across 6 categories: smart routing, text, code, filesystem, media, and monitoring
03Support for 20+ providers including Ollama, Gemini, OpenAI, Anthropic, and more
04Budget control with per-provider caps, dashboards, and enforcement modes
05Seamless integration with multiple hosts via MCP and hooks
02

Why choose it

+Routes by task difficulty with a free-first fallback chain, so simple prompts avoid premium-model cost.
+Supports many hosts: Claude Code, Cursor, VS Code, Codex CLI, Gemini CLI, Windsurf, Zed and more, with one-line installs.
+Budget caps, a dashboard, Prometheus metrics and OpenTelemetry traces keep spend and routing decisions visible.
+Falls back to safe defaults when hooks, providers or budgets fail, instead of blocking a session.
03

Trade-offs

!The README's savings figures (60–80% against running everything on Claude Opus) are the project's own claims and depend on your prompt mix.
!It adds a hook and a routing step in front of every prompt, so there is extra setup and one more component to debug.
!The local-model tier needs Ollama installed, and the free fallback uses a Gemini key, so full benefits need some provider setup.
04

Maintenance check

ActiveChecked: 2026-10-19
Last commit
2026-10-19
Commits, last 90 days
100+
Releases, last 90 days
30
Latest release
v15.4.0 (2026-09-29)
Open issues
12
Recent issues with at least one comment
—
Commits per week, last 12 weeks
Commits per week, last 12 weeks: 17, 0, 9, 20, 84, 54, 45, 172, 85, 151, 126, 82

Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.

Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.

05

Compatibility

Claude Code
Claude Code
Verified via docs
Codex CLI
Codex CLI
Verified via docs
VS Code
VS Code (MCP native)
Verified via docs
Cursor
Cursor IDE
Verified via docs
Gemini CLI
Gemini CLI
Verified via docs
06

Quick start

1
$ pipx install claude-code-llm-router
2
$ llm-router install
07

Use cases

↳Automatically route simple queries to free/cheap models in AI coding assistants
↳Reduce costs in Claude Code by offloading low-value prompts to cheaper models
↳Centralized budget management for teams using multiple LLM providers
08

Alternatives

⚡Top VS:
VSclaude-code-source-all-in-one★91→VSnotebooklm-mcp★204→VSagents-best-practices★2.4k→

Comments

Log in to leave a comment

No comments yet. Be the first!

On this page
01Features02Why choose it03Trade-offs04Maintenance check05Compatibility06Quick start

Most discussed open issues

  • #95 Suite flakiness recurs: 3 clean-rerun failures in one session across two known-flaky files0 comments · 2026-08-31
  • #91 An -m slow run calls uv build three times — three files each define their own module-scoped 'built' fixture0 comments · 2026-08-31
  • #39 Want to add your plugin to awesome-ai-plugins?0 comments · 2026-08-19

Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.

VS
anythingmcp
★780
→
claude-code-source-all-in-one logo
claude-code-source-all-in-one★ 91
Always up-to-date open-source mirror of Claude Code (currently v2.1.123). Run from source with Claude subscription/API, ChatGPT subscription (GPT-5.5 / GPT-5.4), OpenAI-compatible providers, or local Ollama. 18 deep-dive architecture articles included. For educational and reference purposes only.
VSCompare→
notebooklm-mcp logo
notebooklm-mcp★ 204
Google NotebookLM over MCP + a local HTTP REST API. Citation-backed Q&A, audio/video/content generation, multi-account rotation. For Claude Code, Codex, Cursor, n8n, Zapier, Make.
VSCompare→
agents-best-practices logo
agents-best-practices★ 2.4k
Provider-neutral Agent Skill for Codex, Claude Code, and agentic harness design.
VSCompare→
anythingmcp logo
anythingmcp★ 780
Self-hosted MCP gateway & API-to-MCP bridge. Convert REST/SOAP/WSDL/GraphQL/SQL APIs into MCP servers for Claude, ChatGPT, Gemini, Copilot, Cursor. OpenAPI/Postman/WSDL import, OAuth2, RBAC, audit log. 29 pre-built adapters (DHL, DATEV, Weclapp, Personio, Handelsregister, Shopware...). Source-available.
VSCompare→
open-claude-in-chrome logo
open-claude-in-chrome★ 255
Claude in Chrome, reverse-engineered and open-source. No domain blocklist. Any Chromium browser. Same 18 MCP tools, same performance.
VSCompare→
nvim-mcp logo
nvim-mcp★ 66
MCP server that connects AI agents to your running Neovim instance via msgpack-RPC — no plugins required.
VSCompare→
widemem-ai logo
widemem-ai★ 49
Next-gen AI memory layer with importance scoring, temporal decay, hierarchical memory, and YMYL prioritization
VSCompare→
claude-dev-suite logo
claude-dev-suite★ 45
Specialized agents, MCP servers, skills, and a visual dashboard for Claude Code. MIT.
VSCompare→
See all alternatives →
07
Use cases
08Alternatives
ypollak2 /
llm-router
↗

MCP server that routes each AI coding prompt to the cheapest capable model

11918MIT
Last commit1d ago
StatusActive
CategoryLLM Infra
Contributors3
Latest releasev15.4.0
Links
Documentation↗Discussion↗Issues↗Releases↗
Cloud Infrastructure
Ad

Deploy on DigitalOcean

Host your MCP servers, Docker containers, and AI agents with $200 free credit over 60 days.

Claim $200 Free Credit