kairouter-mcp

MCP server exposing KaiRouter's video generation API — BytePlus Seedance family (Seedance 2.0, 2.0 Fast, 2.0 Mini, 1.5 Pro, 1.0 Pro, ...) and any other video model active on KaiRouter — as tools any MCP-compatible agent harness (Claude Code, Codex, Antigravity, ...) can call.

This is a standalone repo — it does not contain any of KaiRouter's backend source, only a thin client for its public/user-scoped HTTP API. Not yet published to npm — run it from a local build for now (see below).

Tools

generate_video is async by design — BytePlus video generation can take tens of seconds to a few minutes. The agent is expected to call generate_video once, then poll check_video_status every few seconds until the job finishes.

Related MCP server: mcp-litmedia

Setup

git clone https://github.com/X-OR-Cloud/kairouter-mcp.git
cd kairouter-mcp
npm install
npm run build

This produces dist/index.js. You'll need a KaiRouter API key — create one at https://kairouter.com/dashboard/api-keys.

Claude Code

claude mcp add kairouter -e KAIROUTER_API_KEY=sk-xor-your-key-here -- node /absolute/path/to/kairouter-mcp/dist/index.js

Or add directly to .mcp.json (project) / ~/.claude.json (user):

{
  "mcpServers": {
    "kairouter": {
      "command": "node",
      "args": ["/absolute/path/to/kairouter-mcp/dist/index.js"],
      "env": { "KAIROUTER_API_KEY": "sk-xor-your-key-here" }
    }
  }
}

Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.kairouter]
command = "node"
args = ["/absolute/path/to/kairouter-mcp/dist/index.js"]
env = { KAIROUTER_API_KEY = "sk-xor-your-key-here" }

Antigravity / other MCP-compatible harnesses

Most harnesses accept the same mcpServers JSON block shown above under Claude Code — check the harness's own MCP settings for the exact config file path/UI, since this varies and wasn't verified here for Antigravity specifically.

Configuration

Development

npm run dev    # tsc --watch
npm start      # run the built server directly over stdio (for manual testing with an MCP client)