Vocnu

Command line

The npm package vocnu, for Node.js 20 or newer. It uploads a file of up to 10 GB, shows the price in credits and asks before it starts, follows the job and saves the results next to the file.

npx vocnu login
npx vocnu translate film.mkv --to es

Options

Option	What it does
--output video|audio|subtitles	The video with the voice-over (default for video files), the voice-over audio or subtitles only
--from <lang>	The spoken language, detected by default
--voice male|female	A male voice (default) or a female one
--format mp4|mkv|mov|webm|avi	Video file format; by default the upload's own, else MP4
--audio-format m4a|mp3|wav|flac|ogg	Voice-over audio format
--burn-subtitles	Subtitles burned into the picture
--out <dir>	Where the results go
--yes	Start without confirming the price
--no-wait	Start the job and return its ID

Other commands

• vocnu credits
• vocnu languages
• vocnu jobs
• vocnu status <job>
• vocnu download <job>
• vocnu cancel <job>
• vocnu logout

MCP server

Add Vocnu to Claude or any other assistant that supports MCP, then ask it to translate a video. It uploads the file, tells you the price, starts only when you agree, follows the job and saves the files.

Claude Code

claude mcp add vocnu -e VOCNU_TOKEN=vocnu_... -- npx -y vocnu mcp

Claude Desktop and other MCP clients

{
  "mcpServers": {
    "vocnu": {
      "command": "npx",
      "args": ["-y", "vocnu", "mcp"],
      "env": { "VOCNU_TOKEN": "vocnu_..." }
    }
  }
}

Then ask, for example: “Translate ~/Videos/film.mkv into Lithuanian with Vocnu.”

Tools

vocnu_upload_media

Uploads a file from your computer

vocnu_start_job

Starts a job once you agree to its price

vocnu_job_status

Shows how far a job has got

vocnu_download_results

Saves the finished files

vocnu_languages

Lists the target languages

vocnu_credits

Shows your credit balance

vocnu_list_jobs

Lists your jobs

vocnu_cancel_job

Cancels a job

API tokens

Create a token in the app under Settings, API & MCP. It is shown once: the command line saves it when you run vocnu login, or you set it as VOCNU_TOKEN.

A token can upload files, show prices, start, follow and download jobs and read your credits. It cannot pay, change your profile or manage tokens. Revoke it any time; the app shows when each token was last used.

Create a token

Open data

• The voice catalog: every voice with its language, gender and a sample, as JSON.
• The names library: how the characters, places and terms of films and series are written in each language, as JSON under CC BY-SA 4.0.

Questions and answers

Do the command line and the MCP server need an account?

Yes. They work with a personal API token from your Vocnu account: the same credits, prices and refunds as the app, and you see the price before anything is charged.