Orcadub MCP server

Translate any video. Keep the voice.

The official MCP server for OrcaDub — AI video dubbing, driven from your agent.

Website · API Docs · Get an API key · Config examples · Releases

Give any MCP-capable agent — Claude Code, Claude Desktop, Codex CLI, Cursor, Windsurf — the ability to dub a video into another language: upload a file or pass a URL, submit a job to the orca/dub model through the OrcaRouter gateway, poll progress, and download the finished MP4.

CLI usage

Every operation is a one-shot subcommand (no resident server needed):

export ORCADUB_API_KEY=sk-orca-...   # from https://www.orcarouter.ai/console

npx -y @orcadub/cli health
npx -y @orcadub/cli upload --path ./clip.mp4
npx -y @orcadub/cli create --source-lang en --target-lang ja \
  --url https://youtu.be/... --opt preserve_bgm=true
npx -y @orcadub/cli get --video-id <id>
npx -y @orcadub/cli download --video-id <id> --dest ./out.mp4

Optional create parameters use repeatable --opt key=val (e.g. --opt watermark=false --opt resolution=1080p --opt glossary.OrcaDub=OrcaDub). Results print as JSON on stdout; errors go to stderr with a non-zero exit.

With no subcommand the same binary runs as an MCP stdio server (npx -y @orcadub/cli).

Install the agent Skill

The dub-video Skill teaches an agent when to dub, which billed parameters it must confirm, and how to run the upload → create → poll → download workflow. Install it interactively:

npx -y @orcadub/cli skill install

The guided installer opens with a balanced 8-row ORCADUB wordmark, then lets you:

selects the initial default.

• Choose the Simplified Chinese or English interface; the system locale

first and are already checked.

• Choose Project or Global installation with the arrow keys.
• Select one or more platforms from a checkbox list. Detected platforms appear

and Enter to confirm.

• Press Space to toggle, / to filter, a to select all, n to clear all,

It supports 36 platforms: the 33-platform Comet-compatible catalog plus Hermes, OpenClaw, and Command Code. Use --lang zh or --lang en to skip the language screen. For unattended or agent-driven setup, select targets explicitly:

# Current project
npx -y @orcadub/cli skill install \
  --platform claude --platform codex --scope project --lang en --yes

# User-wide Codex installation
npx -y @orcadub/cli skill install \
  --platform codex --scope global --lang zh --yes

Use --yes to accept detected platforms (or all platforms when none are detected) without opening the installer. Use --json for decoration-free structured output. Set NOCOLOR (or use TERM=dumb) for a color-free installer. Existing identical content is left unchanged; an existing different Skill is preserved unless --force is provided. Skill installation needs network access to the canonical orcadub-plugin repository, but it does not require ORCADUBAPI_KEY and does not contact OrcaRouter.

Quick start

Shortened. The full README is on GitHub.