DittoDub MCP documentation | Codex, Claude, and AI apps

Connect an AI app

Add the hosted MCP URL to the client. Sign in to DittoDub, then choose the workspace the client may use.

Connect your AI app to one DittoDub workspace.

The client uses DittoDub sign-in or a service key. Workspace membership and key permissions determine what it may read or create.

AI app

Codex, Claude Code, Cursor, or another MCP client

DittoDub sign-in

Choose the workspace the app may access

MCP tools

Read projects and start paid work only after confirmation

Codex

Add DittoDub, then sign in and choose a workspace.

Setup

codex mcp add dittodub --url https://mcp.dittodub.com/mcp
codex mcp login dittodub

Claude Code

Claude opens DittoDub sign-in after it connects.

Setup

claude mcp add --transport http --scope user dittodub https://mcp.dittodub.com/mcp

Other AI apps

Use this URL in any client that accepts a remote MCP server.

Setup

https://mcp.dittodub.com/mcp

Copy these instructions into Codex, Claude, or another agent. The agent can use them to connect the client and follow the DittoDub spending rules.

Available tools

The MCP tools let an app search YouTube and DittoDub projects, check credits, create or add languages, request source-transcript review, and download completed files.

list_supported_locales

Get the exact source and target locale identifiers DittoDub accepts.

list_projects

Search every project visible in the active workspace, including work created in the web app.

list_youtube_videos

Find videos from connected channels and see whether a DittoDub project already exists.

get_usage

Check available workspace credits and active pricing before billable work.

get_project

Read source details, billing, per-language progress, publishing metadata, and completed files.

get_project_asset

Get a downloadable dubbed-audio, caption, or thumbnail resource using a deliverable ID returned by get_project.

create_project

Create a localization project from a YouTube URL or uploaded file with a hard spend ceiling.

add_project_languages

Preview the exact charge, then add languages to an existing project after confirmation.

submit_transcript_for_human_review

Preview the exact charge, then submit the English source transcript to Ditto Verified after confirmation.

Authentication

People sign in with DittoDub. Servers and CI use a service key tied to one workspace.

Sign in with DittoDub

The client opens DittoDub sign-in, then asks you to choose a workspace. Your current workspace role sets its access.

Servers and CI

Limit the service key to one workspace. Grant read access alone, or add create access when the automation needs it.

Codex with a service key

export DITTODUB_API_KEY="dd_live_..."

codex mcp add dittodub --url https://mcp.dittodub.com/mcp --bearer-token-env-var DITTODUB_API_KEY