# videoworker

> videoworker is a freemium MCP server for design and media. FFmpeg media presets and custom jobs for agents, run on hosted workers with OAuth. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web, CLI
- **Website:** https://videoworker.dev/mcp
- **Repository:** https://github.com/azadkurt/videoworker-mcp
- **MCP Registry name:** io.github.AzadKurt/videoworker
- **Categories:** design and media
- **Listing updated:** 2026-11-14

## About

Instead of installing FFmpeg, an agent uploads a file, picks a versioned preset and collects the result. The README's presets are web-mp4 (H.264/AAC), audio-mp3, thumbnail-jpg, gif-preview, subtitles-burn-mp4 and subtitles-track-mp4. Subtitle presets take a video plus your own SRT or VTT file up to 2 MiB; they do not transcribe or translate. For anything else, create_job accepts custom FFmpeg arguments, including multi-file edits.

The hosted server lists nine tools: get_usage, list_jobs, create_job, get_job, cancel_job, delete_job_outputs, get_outputs, list_presets and run_preset. It signs in with OAuth using Client ID Metadata Documents, with scoped permissions that exclude billing, API keys and admin controls. Remote MCP cannot read a local filename, import a URL or take base64 media, so files are uploaded through the website or REST API first, and output links need authentication. An MIT-licensed local stdio connector handles local uploads and downloads and needs Python 3.12 or newer.

Web, REST and MCP share one monthly allowance of processing time, measured as the time the FFmpeg command runs, with no automatic overage charges. Jobs run up to 120 seconds, and signed webhooks can announce completion.

## Features

- **Versioned presets:** Run web MP4, MP3, JPEG thumbnail, GIF preview and subtitle jobs by name and version.
- **Custom FFmpeg jobs:** create_job takes your own arguments for multi-file edits and filters.
- **Subtitle burn-in or track:** Add your SRT or VTT as permanent captions or a switchable track.
- **Scoped OAuth:** Permissions exclude billing, API keys and admin controls.
- **Shared allowance:** Web, REST and MCP use one processing-time quota.
- **Completion webhooks:** Signed notifications reach a registered HTTPS endpoint.

## Good for

- Export web-ready MP4s from uploaded clips
- Extract MP3 audio from video
- Burn captions into a video from an SRT file
- Generate a thumbnail or short GIF preview
- Run a custom FFmpeg edit without installing FFmpeg

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http videoworker https://videoworker.dev/mcp/server
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://videoworker.dev/mcp/server
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "videoworker": {
      "url": "https://videoworker.dev/mcp/server"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "videoworker": {
      "type": "http",
      "url": "https://videoworker.dev/mcp/server"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "videoworker": {
      "serverUrl": "https://videoworker.dev/mcp/server"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "videoworker": {
      "type": "http",
      "url": "https://videoworker.dev/mcp/server"
    }
  }
}
```

## Tools

- `get_usage`: Checks the available processing time.
- `list_jobs`: Lists jobs.
- `create_job`: Creates a custom FFmpeg job.
- `get_job`: Gets a job's status.
- `cancel_job`: Cancels a job.
- `delete_job_outputs`: Deletes a job's outputs.
- `get_outputs`: Returns a job's outputs.
- `list_presets`: Lists presets and their parameters.
- `run_preset`: Submits a versioned preset task.

## FAQ

### What does it cost?

Free accounts get 5 processing minutes a month; Starter is US$9 a month for 100 minutes, with a 30-day trial for eligible new subscribers.

### Can the hosted MCP read files from my computer?

No. Upload through the website or REST API first, or use the local connector.

### Does it transcribe subtitles?

No, subtitle presets only use SRT or VTT files you supply.

### What is the job limit?

Up to 120 seconds of command runtime per job.

### Is videoworker free?

videoworker has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add videoworker to Claude Code?

Run this command in your terminal: claude mcp add --transport http videoworker https://videoworker.dev/mcp/server

### What are the best alternatives to videoworker?

The closest alternatives to videoworker are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/videoworker
