# NarrateAI

Stop recording your voice. NarrateAI adds professional voiceover to silent screen recordings — automatically. Just drop a video URL and get a narrated demo, dubbed video, or polished document back. W…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add narrateai/video

# Browse available tools
npx -y @smithery/cli@latest tool list narrateai/video

# Get full schema for a tool
npx -y @smithery/cli@latest tool get narrateai/video get_job_result

# Call a tool
npx -y @smithery/cli@latest tool call narrateai/video get_job_result '{}'
```

## Direct MCP Connection

Endpoint: `https://video--narrateai.run.tools`

**Required config:**
- `api-key` (header) — Get your free API key (5 min included) at narrateai.app — upgrade anytime

## Tools (18)

- `get_job_result` — Check job status and result. Poll every 60 seconds — do NOT poll more frequently.
- `get_upload_url` — GET A SIGNED UPLOAD URL for uploading a local video to NarrateAI cloud storage.
- `generate_narration_script` — NARRATION SCRIPT – generates an AI-written timed script for a SILENT video. No audio output.
- `narrate_video_full` — FULL NARRATED VIDEO – produces a downloadable video with AI voiceover.
- `abandon_job` — Abandon/cancel a processing job. Call this when the user cancels on the agent side.
- `transcribe_video` — TRANSCRIPTION ONLY – video with existing voice -> speech-to-text -> timed transcript.
- `transcribe_and_translate` — TRANSCRIBE & TRANSLATE (new upload) – video with voice -> speech-to-text -> translate -> translated transcript.
- `translate_existing_video` — TRANSLATION (existing video) – Translate transcript of a video already in the user's library.
- `dub_video_full` — FULL AUTO-DUBBING – transcribe -> translate -> extract speaker voice -> TTS with cloned voice -> dubbed video.
- `generate_document` — DOCUMENT GENERATION – produces a structured markdown document from a silent video.
- `generate_tts` — TEXT-TO-SPEECH – generate audio from text. Returns a downloadable audio URL.
- `narrate_batch` — BATCH NARRATION – narrate multiple videos in parallel. Each gets a full narrated video with voiceover.
- `batch_generate_scripts` — BATCH SCRIPT GENERATION – generate AI narration scripts for multiple silent videos in parallel.
- `batch_transcribe` — BATCH TRANSCRIPTION – transcribe speech from multiple videos in parallel.
- `batch_dub` — BATCH DUBBING – dub multiple videos into another language in parallel.
- `update_transcript` — UPDATE TRANSCRIPT – edit the narration script before continuing to full video.
- `list_videos` — LIST VIDEOS – get the user's video library (previously processed videos).
- `continue_to_full_video` — Continue from transcript to full narrated video. Use after generate_narration_script

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get narrateai/video <tool-name>
```