# L4 Smartroute

> Intelligent AI model routing for coding agents. Analyzes task complexity using knowledge graphs to recommend the best AI model & effort level across 80+ models from 15+ providers.

- **Type:** MCP server
- **Install:** `agentstack add mcp-linux5real-l4-smartroute`
- **Verified:** Pending review
- **Seller:** [Linux5Real](https://agentstack.voostack.com/s/linux5real)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Linux5Real](https://github.com/Linux5Real)
- **Source:** https://github.com/Linux5Real/L4-Smartroute

## Install

```sh
agentstack add mcp-linux5real-l4-smartroute
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# L4-Smartroute

Intelligent AI model routing for coding agents. Picks the right model for the right task - so you stop overpaying for simple fixes and underpowering complex refactors.

*made by [linux5real](https://github.com/Linux5real)*

## What is L4-Smartroute?

L4-Smartroute is an MCP server that analyzes your task (prompt or git diff), calculates code complexity using knowledge graph analysis, and recommends the best AI model + effort level. Instead of always using the most expensive model, it routes each task to the most appropriate one from 80+ AI-models (Coding-Models) across 15 providers.

## Built on Graphify

L4-Smartroute uses [Graphify](https://github.com/safishamsi/graphify) knowledge graphs to calculate blast radius - how many files, communities, and code paths a change affects. This drives complexity scoring and ensures high-risk cross-module work gets a capable model while simple edits stay cheap.

## Features

- **54+ models** across 14 providers (Anthropic, OpenAI, Google, xAI, Meta, and more)
- **3 router modes**: deterministic, hybrid, ai-review
- **4 optimization levels**: quality, balanced, performance, token-saver
- **Graphify-powered** blast radius analysis for accurate complexity scoring
- **Web UI** for configuration on `http://localhost:6639`
- **One-command install** with auto Claude Code integration

## Prerequisites

- **Python 3.11+**
- **One of:** `uv`, `pipx`, or `pip`
- **Claude Code CLI** (optional — for automatic MCP server registration)
- **Graphify** (optional — for full blast radius analysis, run `graphify ./your-project`)

## Installation

### One Command

```bash
curl -fsSL https://raw.githubusercontent.com/Linux5Real/L4-Smartroute/main/install.sh | bash
```

This auto-detects your package manager (`uv` > `pipx` > `pip`), clones the repo locally, installs it editable, installs the Claude Code commands, and registers Claude Code with the actual installed MCP executable path.

### Manual

```bash
git clone https://github.com/Linux5Real/L4-Smartroute.git
cd L4-Smartroute
pip install -e .
claude mcp add l4-smartroute -- "$(command -v l4-smartroute)"
```

### From Source

```bash
git clone https://github.com/Linux5Real/L4-Smartroute.git
cd L4-Smartroute
pip install -e .
```

## Setup

Start the configuration UI:

```bash
l4-smartroute-setup
```

This opens `http://localhost:6639` where you can:

- Select which models are available
- Choose optimization mode (Quality / Balanced / Performance / Token Saver)
- Set router mode (Deterministic / Hybrid / AI Review)
- Configure Graphify path and budget settings

### Claude Code Commands

- **`/smartroute`** — Get a model recommendation for your current task
- **`/smartroute-settings`** — Open the configuration UI

## How It Works

```
Prompt / Git Diff
  -> Graphify blast radius (files, communities, centrality)
  -> Task classification (13 task types)
  -> Candidate scoring (fit, tier, cost, speed)
  -> Optional AI review (hybrid/ai-review mode)
  -> Final model + effort level + budget alternative
```

## Supported Models

| Provider | Models |
|----------|--------|
| Anthropic | Claude Fable 5, Opus 4.8, Opus 4.7, Opus 4.6, Sonnet 4.6 / 4.5, Haiku 4.5 |
| OpenAI | GPT-5.5, GPT-5.5 Pro, GPT-5.4, GPT-5.4 mini/nano, GPT-5.3 Codex, GPT-5.2 |
| Google | Gemini 3.1 Pro, 3.5 Flash, 3.1 Flash-Lite, 3 Deep Think, 2.5 Pro / flash |
| xAI | Grok 4.3, Grok 4.20, Grok 4.1, Grok-build-0.1 |
| Meta | Llama 4 Maverick, Llama 4 Scout |
| Alibaba | Qwen3.7 Max/Plus, Qwen3.6 Plus, Qwen3.5, Qwen3 Coder Next, and more |
| Mistral | Mistral Large 3, Medium 3.5, Small 4 |
| DeepSeek | DeepSeek V4 Pro, V4 Flash and more |
| NVIDIA | Nemotron 3 Ultra, Super, Nano Omni |
| Moonshot | Kimi K2.6, Kimi K2.5|
| MiniMax | MiniMax-M3, M2.7, M2.5, M2.1, M2 |
| Xiaomi | MiMo-V2.5-Pro, V2.5, V2-Omni, V2-Flash |
| Zhipu AI | GLM-5.1, GLM-5-Turbo and more |
| Others | Command A/A+, Step 3.7 Flash, KAT-Coder-Pro V2, Hy3 |

**Missing a model?** [Open an issue](https://github.com/Linux5Real/L4-Smartroute/issues) and we'll add it.

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Linux5Real](https://github.com/Linux5Real)
- **Source:** [Linux5Real/L4-Smartroute](https://github.com/Linux5Real/L4-Smartroute)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: flagged — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-linux5real-l4-smartroute
- Seller: https://agentstack.voostack.com/s/linux5real
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.