How do I install Orcadub?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Orcadub need an API key?

The publisher lists these environment variables: ORCADUB_API_KEY.

What transport does Orcadub use?

Orcadub runs locally over stdio.

When was Orcadub last checked?

Last checked 2026-11-09. AI video dubbing via OrcaRouter (model orca/dub): upload a video or URL, poll, download the MP4.

Orcadub MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @orcadub/[email protected]

Credentials from the publisher

ORCADUB_API_KEY — OrcaRouter API key (sk-orca-...). Create one at https://www.orcarouter.ai/console.

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1ORCADUB_API_KEY=<secret> claude mcp add io.github.continuum-ai-corp-orcadub-mcp-server -- npx -y @orcadub/cli@1.4.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.continuum-ai-corp-orcadub-mcp-server": {4      "command": "npx",5      "args": [6        "-y",7        "@orcadub/[email protected]"8      ],9      "env": {10        "ORCADUB_API_KEY": "<secret>"11      }12    }13  }14}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.4.0
API key

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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:

Choose the Simplified Chinese or English interface; the system locale selects the initial default.
Choose Project or Global installation with the arrow keys.
Select one or more platforms from a checkbox list. Detected platforms appear first and are already checked.
Press Space to toggle, / to filter, a to select all, n to clear all, and Enter to confirm.

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 NO_COLOR (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 ORCADUB_API_KEY and does not contact OrcaRouter.

Quick start

claude mcp add orcadub -e ORCADUB_API_KEY=sk-orca-... -- npx -y @orcadub/cli

Then just ask your agent: "Dub this into Chinese: https://www.youtube.com/watch?v=…"

Prerequisites

An OrcaRouter API key is required — every tool call is authenticated:

Register / log in at the OrcaRouter console.
Create an API key on the token management page (it looks like sk-orca-...).
Provide it via the ORCADUB_API_KEY environment variable (see below).

Dubbing jobs are billed per minute of source video. Without a key the server still starts, but every tool call returns a sign-up redirect to the console.

Installation

Claude Code

claude mcp add orcadub -e ORCADUB_API_KEY=sk-orca-... -- npx -y @orcadub/cli

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "orcadub": {
      "command": "npx",
      "args": ["-y", "@orcadub/cli"],
      "env": { "ORCADUB_API_KEY": "sk-orca-..." }
    }
  }
}

Codex CLI

codex mcp add orcadub --env ORCADUB_API_KEY=sk-orca-... -- npx -y @orcadub/cli

Cursor / Windsurf / other MCP hosts

Any host that launches stdio MCP servers works with the same shape: command npx, args ["-y", "@orcadub/cli"], env ORCADUB_API_KEY. Ready-to-copy configuration files for Claude Code, Codex, Cursor and Windsurf live in examples/.

Docker

Images are published to GHCR for linux/amd64 and linux/arm64:

docker pull ghcr.io/continuum-ai-corp/orcadub-mcp-server:latest
claude mcp add orcadub -e ORCADUB_API_KEY=sk-orca-... -- \
  docker run --rm -i -e ORCADUB_API_KEY -v "$PWD:$PWD" -w "$PWD" \
  ghcr.io/continuum-ai-corp/orcadub-mcp-server:latest

Or as host JSON config:

{
  "mcpServers": {
    "orcadub": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "ORCADUB_API_KEY",
               "-v", "/path/to/videos:/work", "-w", "/work",
               "ghcr.io/continuum-ai-corp/orcadub-mcp-server:latest"],
      "env": { "ORCADUB_API_KEY": "sk-orca-..." }
    }
  }
}

Note: dub_upload and dub_download read/write local paths, so mount the directory you upload from / download to (the -v flag) — paths you pass to the tools must be valid inside the container.

Prebuilt binaries

Download the binary for your platform from the releases page (verify with checksums.txt), then register it directly:

# example: Linux amd64 via gh CLI
gh release download v0.1.0 -R Continuum-AI-Corp/orcadub-mcp-server \
  -p 'orcadub-mcp-server_*_linux_amd64' -O ~/bin/orcadub-mcp-server && chmod +x ~/bin/orcadub-mcp-server
claude mcp add orcadub -e ORCADUB_API_KEY=sk-orca-... -- ~/bin/orcadub-mcp-server

From source

git clone https://github.com/Continuum-AI-Corp/orcadub-mcp-server && cd orcadub-mcp-server && make build
# binary lands in bin/orcadub-mcp-server

Configuration

Environment variable	Required	Description
`ORCADUB_API_KEY`	yes	OrcaRouter `sk-orca-...` key, sent as `Authorization: Bearer` on every request. The gateway resolves your workspace and billing from it.

The gateway address (https://api.orcarouter.ai) is fixed in the binary — there is nothing else to configure.

Tools

Tool	Description
`dub_health`	End-to-end probe of gateway → `orca/dub` routing. No job is created, nothing is billed.
`dub_upload`	Upload a local video file; returns the `file_id` for `dub_create`. Files above 64 MiB are chunked automatically (up to 8 GiB).
`dub_create`	Submit a dubbing job (billed). Source is exactly one of `file_id` or `url` (YouTube and direct links are fetched server-side). Required: `source_lang`, `target_lang` (never `auto`), and `video_name` when using `file_id`. Optional knobs cover content profiles, glossaries, translation style, background-music preservation, lipsync, watermarking, resolution/ratio and more.
`dub_get`	Poll a job: `queued → in_progress → completed \| failed` with integer progress. On completion the response includes `content_url` (Bearer-authenticated delivery address, never expires) and `job_id`.
`dub_download`	Save a completed job's MP4 to a local path (refuses to overwrite existing files).

Supported languages: en zh ja ko fr de es pt ru ar it hi tr th vi id bn pl nl uk fil el cs sv da no fi sk.

Example

A typical agent conversation:

User: Dub this into Chinese: https://www.youtube.com/watch?v=xxxx

Agent: (dub_create with source_lang=en, target_lang=zh, url=…) → job queued → (polls dub_get every ~30 s) → completed → (asks: download locally? default: current directory) → (dub_download) → "Saved to ./My-Video-zh.mp4 — re-download any time: curl -H "Authorization: Bearer sk-orca-..." <content_url> -o out.mp4"

Direct tool usage from an agent prompt works too — for example dub_create {"source_lang":"en","target_lang":"zh","url":"https://…","glossary":{"OrcaRT":"OrcaDub Realtime"}}.

Troubleshooting

Symptom	Cause / fix
Tool calls return `not authorized … www.orcarouter.ai/console`	`ORCADUB_API_KEY` is unset — register, export the key, restart the session.
`401`	Invalid or expired key — re-issue on the OrcaRouter console.
`402 insufficient_credit`	Top up your OrcaRouter balance (per-minute billing).
`429 free_quota_exceeded`	Free-tier limit reached.
`task_not_exist` on `dub_get`	The id wasn't created through this gateway — use the id exactly as returned by `dub_create`.

Development

go build ./...
go test ./... -count=1

Layout: cmd/ (entrypoint) · internal/ (HTTP client, Skill installer, tool layer, wire types) · npm/ (npx launcher that downloads the platform binary from GitHub Releases) · server.json (MCP Registry manifest).

Releasing

Tag: git tag v0.1.0 && git push origin v0.1.0.
GitHub Actions runs goreleaser: linux/darwin/windows × amd64/arm64 binaries + archives + checksums land on the Release.
The npm-publish job stamps the tag version into npm/package.json and publishes @orcadub/cli to npm (requires the NPM_TOKEN repo secret).
The registry job stamps the same tag version into server.json and publishes it to the MCP Registry.

License

MIT

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Orcadub?

Does Orcadub need an API key?

What transport does Orcadub use?

When was Orcadub last checked?

Documentation

Translate any video. Keep the voice.

CLI usage

Install the agent Skill

Quick start

Prerequisites

Installation

Claude Code

Claude Desktop

Codex CLI

Cursor / Windsurf / other MCP hosts

Docker

Prebuilt binaries

From source

Configuration

Tools

Example

Troubleshooting

Development

Releasing

License