mcp-server · ffmpeg-micro — Claude Code MCP server: features and setup
Connect an agent to FFmpeg Micro to start video transcodes, track jobs, and retrieve output links. The server also exposes ready-made video workflows.
claude mcp add --transport http mcp-server https://mcp.ffmpeg-micro.comWhat mcp-server does
An agent can submit one or more videos for transcoding, choose a quality or resolution preset, or pass FFmpeg options. It can also inspect a job, list jobs, and cancel one that is pending or processing. Completed files get signed download links with a 10-minute lifetime.
Local files use a two-part upload flow: the server provides a temporary HTTPS address, the client sends the file there, then confirms the upload. Ready-made workflows cover tasks such as captions, resizing, and watermarks. The caption-video workflow pauses so a transcript can be reviewed before processing resumes.
Claude Code can connect to the HTTP server without running a local process; the first connection opens FFmpeg Micro sign-in in a browser. Local npx setup needs Node.js 22.14 or later and an API key. Output links expire, so fetch a fresh link when an older one no longer works.
What it helps with
- submit video files for transcoding with a chosen resolution
- inspect or cancel an FFmpeg Micro job
- upload a local video for processing
- run a prepared video workflow and retrieve its output link
Example prompts for the agent
- Convert this video to MP4 at 720p and return a link when the file is ready.
- Show my failed FFmpeg Micro jobs.
- Create captions for this video, let me review the transcript, then resume processing after I approve it.
How to install mcp-server
1Platform CLI: remote server
claude mcp add --transport http mcp-server https://mcp.ffmpeg-micro.com2Platform CLI
claude mcp add --env FFMPEG_MICRO_API_KEY=<FFMPEG_MICRO_API_KEY> --transport stdio ffmpeg-micro-mcp-server -- npx -y @ffmpeg-micro/mcp-serverReplace <…> with your own values
1Platform CLI: remote server
codex mcp add ffmpeg-micro-mcp-server --url https://mcp.ffmpeg-micro.com2Platform CLI
codex mcp add ffmpeg-micro-mcp-server --env FFMPEG_MICRO_API_KEY=<FFMPEG_MICRO_API_KEY> -- npx -y @ffmpeg-micro/mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"ffmpeg-micro-mcp-server": {
"url": "https://mcp.ffmpeg-micro.com"
}
}
}{
"mcpServers": {
"ffmpeg-micro-mcp-server": {
"command": "npx",
"args": [
"-y",
"@ffmpeg-micro/mcp-server"
],
"env": {
"FFMPEG_MICRO_API_KEY": "<FFMPEG_MICRO_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"ffmpeg-micro-mcp-server": {
"type": "http",
"url": "https://mcp.ffmpeg-micro.com"
}
}
}{
"servers": {
"ffmpeg-micro-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ffmpeg-micro/mcp-server"
],
"env": {
"FFMPEG_MICRO_API_KEY": "<FFMPEG_MICRO_API_KEY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http ffmpeg-micro-mcp-server https://mcp.ffmpeg-micro.com2Platform CLI
gemini mcp add -e FFMPEG_MICRO_API_KEY=<FFMPEG_MICRO_API_KEY> ffmpeg-micro-mcp-server npx -y @ffmpeg-micro/mcp-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-server
How do I install mcp-server in Claude Code?
Run claude mcp add --transport http mcp-server https://mcp.ffmpeg-micro.com. On the first connection, sign in to FFmpeg Micro in your browser and approve access.
What does mcp-server do?
It gives an agent tools to create and manage FFmpeg Micro video jobs, upload local files, and launch prepared video workflows.
Do I need an API key to connect from Claude Code?
The HTTP connection uses browser sign-in with OAuth. Local npx setup requires an API key and Node.js 22.14 or later.
Similar MCP servers
All MCP servers for Backend and APIs →mcp-server by other authors comes first.
