DEV Community

Javid Jamae
Javid Jamae

Posted on • Originally published at ffmpeg-micro.com

FFmpeg MCP Server for Warp: Video Processing in Your AI Terminal

#ffmpeg #mcp #ai #devtools

Originally published at ffmpeg-micro.com

Warp's agent mode can call MCP servers to extend what it does beyond shell commands. Connect the FFmpeg Micro MCP server, and you can process video with natural language right from your terminal. No curl commands to construct, no API parameters to remember, no switching to another app.

Quick setup: add FFmpeg Micro to Warp in 2 minutes

You need two things: a free FFmpeg Micro API key (grab one at ffmpeg-micro.com) and Warp installed on your machine.

Open Warp and go to Settings > Agents > MCP servers. Click + Add, select the CLI Server tab, and paste this:

{
  "ffmpeg-micro": {
    "command": "npx",
    "args": ["-y", "@ffmpeg-micro/mcp-server"],
    "env": {
      "FFMPEG_MICRO_API_KEY": "your_api_key_here"
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

Replace your_api_key_here with your actual API key and click Start.

You can also add this to ~/.warp/.mcp.json for file-based config.

What the MCP server exposes

Once connected, Warp's AI agent can call FFmpeg Micro's tools directly:

  • Transcode video between formats (MP4, WebM, MOV)
  • Apply quality presets (high, medium, low) and resolution targets (480p to 4K)
  • Run custom FFmpeg commands through the API's advanced mode
  • Upload files to cloud storage for processing
  • Check job status and download completed outputs
  • Transcribe audio to SRT subtitles using Whisper

Real examples

Open Warp's agent mode and try:

  • "Convert this MP4 to WebM at medium quality: https://storage.example.com/demo.mp4"
  • "Take this video and resize it to 720p"
  • "Process this with H.265 at CRF 28 with slow preset"
  • "Transcribe this video to SRT"

The agent constructs the correct API calls for you.

How this differs from Claude Desktop or Cursor

Warp is terminal-native. You're already in the shell, already working with files. The MCP server extends your terminal instead of requiring a chat window or IDE. Warp's agent also has direct filesystem access, making batch processing and file management smoother.

Read the full guide on ffmpeg-micro.com for batch operations, troubleshooting, and FAQ.

Top comments (0)