# KeelRouter

This MCP server for Claude Code connects agents to KeelRouter image and video models. It can select a model, submit a generation task, and check its status.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: keelrouter
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/keelrouter/keelrouter-mcp
- Updated: 2026-11-13
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/keelrouter

## What it does

KeelRouter routes image and video generation requests to models such as Seedream, GPT Image, Nano Banana, Kling, and Seedance. The agent can list models with their prices and accepted parameters, start a generation, then retrieve the result using its task ID. Video jobs run asynchronously.

The service is hosted remotely and connects over HTTP, so there is no local server to run. Tool calls require a `KEELROUTER_API_KEY` and funds in a prepaid KeelRouter balance; model prices vary, and failed calls are not charged. Model and balance checks are free. The repository’s agent skill can be added with `npx skills add keelrouter/keelrouter-mcp`.

## Requirements
- Remote server: `https://api.keelrouter.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http keelrouter https://api.keelrouter.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add keelrouter --url https://api.keelrouter.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "keelrouter": {
            "url": "https://api.keelrouter.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "keelrouter": {
            "type": "http",
            "url": "https://api.keelrouter.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http keelrouter https://api.keelrouter.com/mcp
```

## When to use it
- generate an image with a selected model
- start a video job and retrieve its task ID
- check a generation task and get its result link
- compare image and video models by price

## Example prompts
- Generate an image of a sunset landscape and choose a suitable model.
- Create a short video from this description and return the task ID.
- Check task `task_id` and give me the result link.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
