Orcadub MCP Server

AI video dubbing via OrcaRouter (model orca/dub): upload a video or URL, poll, download the MP4.

Local serverstdioGo

What is the Orcadub MCP server?

Connect Orcadub to Claude, Cursor or any other MCP client and it stops being a tab you switch to. AI video dubbing via OrcaRouter (model orca/dub): upload a video or URL, poll, download the MP4. The orcadub mcp server is what makes that connection.

What the server does

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.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • 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
  • dub_get — Poll a job: queued → in_progress → completed \
  • dub_download — Save a completed job's MP4 to a local path (refuses to overwrite existing files)

Credentials and setup notes

Configuration is passed through the environment: ORCADUB_API_KEY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

An OrcaRouter API key is required — every tool call is authenticated: 1. Register / log in at the OrcaRouter console. 2. Create an API key on the token management page (it looks like sk-orca-...). 3. 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

Installation

The server ships on npm as @orcadub/cli, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Where it fits

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Orcadub's toolset — dub_health, dub_upload, dub_create and 2 more — is a fair guide to whether it matches your workflow. It is maintained by Continuum-AI-Corp; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
dub_healthEnd-to-end probe of gateway → orca/dub routing. No job is created, nothing is billed.
dub_uploadUpload a local video file; returns the file_id for dub_create. Files above 64 MiB are chunked automatically (up to 8 GiB).
dub_createSubmit 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
dub_getPoll a job: queued → in_progress → completed \
dub_downloadSave a completed job's MP4 to a local path (refuses to overwrite existing files).

How to install the Orcadub MCP server

Or as host JSON config:

```json
{
  "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-..." }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

An OrcaRouter API key is required — every tool call is authenticated: 1. Register / log in at the OrcaRouter console. 2. Create an API key on the token management page (it looks like sk-orca-...). 3. 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

VariableDescriptionRequired
ORCADUB_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Orcadub to dub health.
  • Use Orcadub to dub upload.
  • Use Orcadub to dub create.

Frequently asked questions

It connects Orcadub to MCP-compatible AI assistants such as Claude and Cursor, exposing 5 tools (dub_health, dub_upload, dub_create, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Orcadub directly.