# KeelRouter

> KeelRouter is a paid MCP server for design and media. Generate images and video with several models through one KeelRouter API key. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API
- **Website:** https://keelrouter.com/docs
- **Repository:** https://github.com/keelrouter/keelrouter-mcp
- **MCP Registry name:** com.keelrouter/keelrouter
- **Categories:** design and media, AI models and LLM tooling
- **Listing updated:** 2026-11-14

## About

KeelRouter is a pay-per-call gateway, and this MCP endpoint (api.keelrouter.com/mcp) exposes its image and video generation to assistants. The registry names Seedream, GPT Image, Nano Banana, Kling and Seedance as available models, all billed against one prepaid USD balance.

Image and video jobs are asynchronous: a task is created, the highest possible price is held from your balance, and the unused part is released when the job completes. Failed tasks cost nothing, results are kept for 30 days, and an Idempotency-Key header makes retries safe. Callbacks are signed with HMAC-SHA256 using the creating key.

## Features

- **Image and video models:** Reach Seedream, GPT Image, Nano Banana, Kling and Seedance with one key.
- **Prepaid balance:** Pay per call; credits never expire and no subscription is required.
- **Async tasks:** Create a task, poll or receive a signed callback when it finishes.
- **Safe retries:** Idempotency-Key repeats return the original task without holding more.
- **Free failures:** Failed and refused calls cost nothing.

## Good for

- Generate a short video from an assistant
- Create product images with a chosen model
- Run batches with webhooks on completion
- Switch between image models without new accounts

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http keelrouter https://api.keelrouter.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.keelrouter.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "keelrouter": {
      "url": "https://api.keelrouter.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "keelrouter": {
      "type": "http",
      "url": "https://api.keelrouter.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "keelrouter": {
      "serverUrl": "https://api.keelrouter.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "keelrouter": {
      "type": "http",
      "url": "https://api.keelrouter.com/mcp"
    }
  }
}
```

## Tools

- `list_models`: Image and video models on KeelRouter with their USD prices per tier and the request params each accepts. Free to call.
- `generate_image`: Generate an image with a KeelRouter model. Spends real USD from the account balance at the price in list_models (from under $0.01 per image; higher resolutions cost more); failed calls are not charged. Waits up to 50 seconds; if not done, returns task_id for get_result. Result links are valid for a limited time.
- `generate_video`: Start a video with a KeelRouter model and return task_id right away; videos take one to several minutes. Spends real USD from the account balance at the price in list_models (usually per second; check before choosing duration and resolution); failed calls are not charged. Then call get_result.
- `get_result`: Status of an image or video task. When completed: file links and the final cost in USD.
- `get_balance`: USD balance on this KeelRouter account.

## FAQ

### How is it billed?

Pay per call from a prepaid USD balance, with no monthly fee.

### What happens when a job fails?

Failed tasks cost nothing and the held amount is released.

### How long are results kept?

Result files are deleted after 30 days.

### Is KeelRouter free?

No. KeelRouter is a paid product.

### How do I add KeelRouter to Claude Code?

Run this command in your terminal: claude mcp add --transport http keelrouter https://api.keelrouter.com/mcp

### What are the best alternatives to KeelRouter?

The closest alternatives to KeelRouter are HyperFrames by HeyGen, ffmpeg-skill, Claude Code Ultimate Guide, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/keelrouter
