Skip to content
MCP server

MCP Server

Create, track and download FFmpeg video transcodes from an AI agent

Install
Pricing
Freemium
Platforms
API, CLI
Runs
Locally or Remotely
Version
0.4.3
Listing updated
2 days ago

About MCP Server

MCP Server is a freemium MCP server for design and media. It can run locally on your machine or as a hosted remote server.

This server fronts the FFmpeg Micro hosted API, a service that runs FFmpeg jobs in the cloud so there is nothing to install or host. An agent can submit a transcode, check on it and fetch a signed download link, which stays valid for 10 minutes.

Beyond raw transcodes, the README lists blueprints, prebuilt workflows for captioning, resizing, watermarking and ads. The caption blueprint pauses with a transcript so the agent can edit it before rendering, and multi-output blueprints return labeled files. Local files can be uploaded with a two-step presigned URL flow, so the host never handles raw storage URLs.

It can run locally over stdio from npm with an API key, or as a remote server at https://mcp.ffmpeg-micro.com with browser OAuth sign-in. Billing follows the duration of the processed video at one token per 10 seconds, and failed jobs are not billed.

Install

Run in a terminal

claude mcp add --transport http mcp-server https://mcp.ffmpeg-micro.com

Add to Settings → Connectors → Add custom connector

https://mcp.ffmpeg-micro.com
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server": {
      "url": "https://mcp.ffmpeg-micro.com"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mcp.ffmpeg-micro.com"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server": {
      "serverUrl": "https://mcp.ffmpeg-micro.com"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mcp.ffmpeg-micro.com"
    }
  }
}

Configuration

  • FFMPEG_MICRO_API_KEYAPI key from https://www.ffmpeg-micro.com/dashboard/api-keysRequired

Tools this server provides (12)

Taken from the project documentation; the running server may differ.

transcode_video
Creates a transcode job from one or more gs:// or https:// inputs.
get_transcode
Fetches the state of a single job.
list_transcodes
Lists jobs with status, page, limit and date filters.
cancel_transcode
Cancels a pending or processing job.
get_download_url
Generates a 10-minute signed URL for a finished output.
transcode_and_wait
Creates a job, polls until done and returns the download URL.
request_upload_url
Returns a presigned URL for uploading a local file.
confirm_upload
Confirms an upload and returns the storage URL and probe metadata.
run_blueprint
Starts a prebuilt video workflow.
get_blueprint_run
Fetches a blueprint run's status, step and outputs.
run_blueprint_and_wait
Starts a blueprint and polls until it completes, fails or pauses.
continue_blueprint_run
Resumes a paused caption run with an approved transcript.

What it does

Transcode jobs
Create jobs from one or more inputs, with quality or resolution presets or raw FFmpeg options.
Job control
Fetch, list with filters, or cancel jobs.
Signed downloads
Generates 10-minute signed HTTPS links for finished outputs.
Blueprints
Runs prebuilt workflows such as captions, resizing and product ads.
Local file upload
Presigned upload then confirm, returning a storage URL for later jobs.
Wait helpers
Convenience tools create a job and poll until it finishes.

Good for

  • Add burned-in captions to a batch of videos
  • Resize one video into versions for several platforms
  • Create text-hook variants of an ad
  • Transcode uploads from an automation workflow
  • Review and fix a caption transcript before rendering

Pricing

Freemium, from $19.99 a month

Free plan with 200 signup tokens; Starter $19.99/mo; Pro $49.99/mo; token top-ups from $5

Prices change. Check ffmpeg-micro.com before you buy.

MCP Server FAQ

How do I sign in?

The remote server opens a browser OAuth sign-in; the stdio package takes an FFMPEG_MICRO_API_KEY.

How is usage billed?

One token per 10 seconds of input, metered per second; status checks and downloads are free.

Is there a free tier?

Yes. New accounts get 200 tokens, about 33 minutes of video, with no card.

What happens to failed jobs?

They are never billed.

Is MCP Server free?

MCP Server has a free plan, with paid plans for more usage or features. Paid plans start at $19.99 a month.

How do I add MCP Server to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp-server https://mcp.ffmpeg-micro.com

What are the best alternatives to MCP Server?

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

Alternatives to MCP Server

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media