Ffmpeg-micro
MCP server for the FFmpeg Micro video transcoding API — create, monitor, download transcodes.
Connector by ffmpeg-micro.comOfficial · Domain verified by the MCP Registry
Install
Works with Claude Code, VS Code, Codex, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/ffmpeg-micro-com-mcp-server
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Remote endpoint
https://mcp.ffmpeg-micro.comRemote (HTTP)
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.
- Tools
- 6 read · 7 write · 0 delete · 2 not yet classified
- Secrets
- 1 (API keys, tokens or passwords)
- Install scripts
- None found
- Runs as
- Node.js package
Tools by what they do 15
Read from the source code; the running server may list different tools.
Read 6 · Look things up without changing anything.
get_blueprint_runget_download_urlget_transcodeget_transcribeget_transcribe_downloadlist_transcodes
Write 7 · Create, change, send or run things.
cancel_transcodeconfirm_uploadcontinue_blueprint_runrequest_upload_urlrun_blueprintrun_blueprint_and_waittranscode_video
Not yet classified 2 · We could not tell from the name and description.
transcode_and_waittranscribe_audio
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
FFMPEG_MICRO_API_KEY
Network hosts it talks to 1
mcp.ffmpeg-micro.com· found in remote endpoint, install command
Files it touches
- Any path the agent passes to its tools
Tools (15)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
cancel_transcodeCancel TranscodeCancel a pending or processing transcode job. Jobs that are already completed, failed, or canceled cannot be canceled and return an error.
confirm_uploadConfirm UploadStep 2 of the direct-upload flow. Call after PUTting the file bytes to the URL returned by `request_upload_url`. Returns the final `gs://...` `fileUrl` plus probe metadata (duration, format, codecs). Use the `fileUrl` directly as a `media_url` for `transcribe_audio` or as an `inputs[].url` for `transcode_video`.
continue_blueprint_runContinue Blueprint RunResume a caption-video blueprint run that paused in status awaiting_review for transcript review. Pass the approved (optionally edited) SRT text; the run continues to render the captioned video. Poll with get_blueprint_run afterwards.
get_blueprint_runGet Blueprint RunFetch the current state of a blueprint run: status (pending/processing/awaiting_review/completed/failed), current step, and outputs when completed. Multi-output blueprints (listing-kit, hook-variants) return an `outputs` array of {label, url}; single-output blueprints return `output_url`. Download URLs are signed with a 10-minute TTL — re-fetch this run for fresh links. A caption-video run in status awaiting_review includes `srt_text`; review/edit it and resume with continue_blueprint_run.
get_download_urlGet Download URLGenerate a short-lived (10 minute) signed HTTPS URL for a completed transcode's output file. The job must be in `completed` status. Use this instead of the `output_url` field on the job object, which is a `gs://` URL that HTTP clients cannot fetch directly.
get_transcodeGet TranscodeFetch the current state of a single transcode job by ID, including status (pending/processing/completed/failed/canceled) and `output_url` when completed.
get_transcribeGet TranscribeFetch the current state of a single transcribe job by ID, including status (pending/processing/completed/failed/canceled) and `output_url` when completed. Mirrors `get_transcode` but for SRT generation jobs created via `transcribe_audio`.
get_transcribe_downloadGet Transcribe Download URLGenerate a short-lived (10 minute) signed HTTPS URL for a completed transcribe job's SRT file. The job must be in `completed` status. The returned URL can be dropped directly into a transcode's `subtitles='<url>'` filter to burn captions into a video.
list_transcodesList TranscodesList transcode jobs for the authenticated account, with optional filters for status and time range. Paginated (default page 1, limit 20).
request_upload_urlRequest Upload URLStep 1 of the direct-upload flow. Returns a short-lived presigned HTTPS URL that the caller PUTs the file bytes to (with the same Content-Type that was passed in). After the PUT succeeds, call `confirm_upload` with the same filename and fileSize to receive the final `gs://` URL for use as a transcode/transcribe input. The presigned URL expires in ~15 minutes.
run_blueprintRun BlueprintStart a blueprint run — a pre-built video workflow (captioning, resizing, watermarking, ads, and more). Returns the new run ({id, status, blueprint, tokens_charged}); poll it with get_blueprint_run, or use run_blueprint_and_wait to do both in one step. Per-blueprint input fields (* = required): - product-ad: logo_url*, photo_url*, music_url? — GENERATIVE, costs 200 tokens - caption-video: video_url*, language?, style? (bold-bottom|clean-lower|center-pop|top-title) — pauses at awaiting_review with srt_text for transcript review; resume with continue_blueprint_run - viral-short: video_url*, hoo…
run_blueprint_and_waitRun Blueprint and WaitOne-shot convenience tool: starts a blueprint run and polls until it completes, fails, or pauses for review. Returns the final run with `output_url` (or `outputs` [{label, url}] for multi-output blueprints — prefer `outputs` when present). Download URLs are signed with a 10-minute TTL; re-fetch with get_blueprint_run for fresh links. NOTE: caption-video pauses in status awaiting_review — this tool then returns early with `awaitingReview: true` and the run's `srt_text`; review/edit the transcript and resume with continue_blueprint_run. If your MCP client enforces a short per-request timeout (ma…
transcode_and_waitTranscode and WaitOne-shot convenience tool: creates a transcode job, polls until it reaches a terminal state (completed/failed/canceled) or the timeout expires, and returns the final job plus a signed download URL if completed. Use this when you want the full transcode in one step without managing polling yourself.
transcode_videoTranscode VideoCreate a video transcode job on FFmpeg Micro. Accepts one or more input videos (gs:// or https://) and an output format. Returns immediately with a pending job — use `get_transcode`, `list_transcodes`, or `transcode_and_wait` to follow progress.
transcribe_audioTranscribe AudioGenerate an SRT subtitle file from an audio or video URL using Whisper. Returns a pending job envelope immediately — poll with `get_transcribe` until status is `completed`, then fetch the signed SRT URL with `get_transcribe_download`. The SRT URL can be dropped directly into a transcode's `subtitles='<url>'` filter to burn captions into a video.
Signals
- Stars
- 1
- Forks
- 0
- Open issues
- 0
- Weekly downloads
- 229
- Last commit
- Oct 16, 2026 (12 days ago)
- Last release
- Oct 16, 2026 (12 days ago)
- Last package publish
- Oct 16, 2026 (12 days ago)
From GitHub (fetched Oct 24, 2026) and the package registry.
Details
- Registry name
com.ffmpeg-micro/mcp-server- Version
- 0.4.3
- Auth
- Auth not stated, API key
- Packages
- npm @ffmpeg-micro/mcp-server
- License
- MIT
- Repository
- github.com/ffmpeg-micro/ffmpeg-micro-mcp
- Website
- ffmpeg-micro.com
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
Cite this page
Ffmpeg-micro MCP server. Agent Mart. https://agentmart.dev/connectors/ffmpeg-micro-com-mcp-server (last updated 2026-10-24)