Valmera

Valmera MCP server — the video editing MCP server for real footage

Valmera is an agentic AI video editor. This hosted Model Context Protocol server lets Claude, ChatGPT, Gemini CLI, Cursor, VS Code, Codex or any MCP client edit video you already recorded. The assistant reads the transcript and frames, then cuts silences and filler words, adds word-timed captions, reframes to 9:16, adds b-roll, music and sound effects, and makes shorts from long videos. It renders a preview, watches the result, and exports a full-quality MP4 from your original file.

It is not a text-to-video generator. It edits the footage you upload.

Endpoint   https://valmera.io/mcp/server
Transport  Streamable HTTP
Auth       OAuth 2.1 (dynamic client registration + PKCE S256), or a bearer token from https://valmera.io/mcp
Registry   io.valmera/video-editor

• Product: valmera.io
• Setup for every client: valmera.io/mcp/setup
• Tool reference: valmera.io/mcp/tools
• Live server card: /.well-known/mcp/server-card.json

Connect in one minute

Claude (claude.ai and Claude Desktop)

Settings → Connectors → Add custom connector → name it Valmera. Paste https://valmera.io/mcp/server and sign in when prompted. Step-by-step guide.

Claude Code

claude mcp add --transport http valmera https://valmera.io/mcp/server

Then run /mcp inside Claude Code and choose Authenticate. Guide.

Cursor — ~/.cursor/mcp.json

{
  "mcpServers": {
    "valmera": { "url": "https://valmera.io/mcp/server" }
  }
}

VS Code (GitHub Copilot agent mode) — .vscode/mcp.json

{
  "servers": {
    "valmera": { "type": "http", "url": "https://valmera.io/mcp/server" }
  }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "valmera": { "serverUrl": "https://valmera.io/mcp/server" }
  }
}

ChatGPT

Turn on Developer mode in Settings, then add a connector with the URL https://valmera.io/mcp/server and complete Valmera sign-in. Guide.

Codex CLI

codex mcp add valmera --url https://valmera.io/mcp/server
codex mcp login valmera

Or add [mcp_servers.valmera] with url = "https://valmera.io/mcp/server" to ~/.codex/config.toml.

Gemini CLI

gemini mcp add --transport http valmera https://valmera.io/mcp/server

Then open Gemini CLI, run /mcp auth valmera and sign in.

Any stdio-only client

{
  "mcpServers": {
    "valmera": { "command": "npx", "args": ["-y", "mcp-remote", "https://valmera.io/mcp/server"] }
  }
}

There are more clients (Zed, Cline, Continue, Goose, LibreChat, MCP Inspector) in docs/CLIENTS.md.

First message to try: "List my Valmera projects." An empty list still means the connection works.

Install as a Claude plugin (connector + editing skills)

This repository is also a Claude plugin. It bundles the Valmera connector with three skills that teach Claude a reliable editing workflow: edit-video-with-valmera, turn-long-video-into-shorts and website-demo-video.

In Claude Code:

/plugin marketplace add ABO3SKRALMASAOODI/valmera-mcp
/plugin install valmera@valmera

In claude.ai, go to Customize → Plugins → Add → Add marketplace and enter ABO3SKRALMASAOODI/valmera-mcp. The skills follow the open Agent Skills format, so other agents that read SKILL.md can use them too.

What your assistant can do with it

According to the live server card on October 6, 2026, the server exposes 143 tools: 129 editing tools in 9 groups and 14 session tools. The full list is in docs/TOOLS.md.

You ask for	Tools the assistant uses
"Remove the dead air and the ums"	find_silences, cut_silences, remove_filler_words, get_kept_transcript
"Cut the part where I talk about pricing"	search_transcript, cut_range, restore_range
"Add bold word-by-word captions"	add_captions, set_caption_style, set_caption_fixes, audit_captions
"Make it vertical for TikTok and keep my face centered"	auto_reframe, set_frame, add_aspect_shift
"Turn this podcast into 5 shorts"	make_shorts, shorts_status, open_short, apply_short_edit_batches
"Add b-roll where I mention the product"	research_broll, search_stock, add_stock_media, insert_media
"Punch in on the important lines"	suggest_emphasis, punch_in_on_emphasis, add_zoom, add_zoom_path
"Put my track (or a song I name) under my voice"	find_song, fetch_url, add_music, set_music_fit, beat_align_cuts, set_master_loudness
"Add a whoosh on each transition"	search_sfx, audition_sfx_candidates, add_sfx
"Record a demo of my website"	record_website, record_website_demo, enhance_cursor, showcase_demo
"Blur the license plate" / "remove the burned-in subtitles"	blur_region, find_burned_text, erase_burned_text, erase_region
"Color grade it warmer"	set_color_grade, apply_look, set_grade_custom
"Show me what you changed"	render_preview, wait_for_job, watch_video, look_at
"Export the final video"	export_final, wait_for_job, download_url

How it works

1. Upload. Upload in Valmera Studio, import a link, or use upload_start and upload_finish from a client that can send files. MP4, MOV, M4V, MKV and WebM are accepted, up to 14 GB and 3 hours per file.
2. Index. Valmera transcribes the footage with word-level timestamps and detects shots, silences and on-screen text. index_status reports progress.
3. Edit. Each tool call writes a new version of a non-destructive edit decision list (EDL). The original upload is never modified, and any cut can be restored.
4. Review. render_preview renders a fast proxy preview. watch_video and look_at let the assistant inspect the frames it produced before it reports back.
5. Export. export_final renders a full-resolution H.264 MP4 from the original file for the reviewed version. download_url returns the link. You can also export from Studio.

Slow jobs return a job id and never a fake completion. The assistant calls wait_for_job until the job finishes.

Example prompts

Open my latest project. Remove dead air and filler words but keep natural pauses,
add clean white captions with the active word highlighted, reframe to 9:16,
render a preview and tell me what you changed.

This is a 70-minute two-person podcast. Find the 5 strongest self-contained stories,
make each one a vertical short with captions and a hook title, and keep whoever is
speaking in frame.

Record a 30-second demo of https://example.com — scroll the hero, click "Pricing",
zoom on the main button — then add captions and light background music.

There are 40+ more in docs/PROMPTS.md.

What it does not do

The server card lists these honestly so your assistant never promises them:

• Generate a whole video from a text prompt. Valmera edits footage you provide.
• Import or export SRT/VTT. Captions are burned into the picture.
• Team seats or collaboration.
• Publish directly to YouTube or TikTok.
• Custom font uploads, true crossfade/dissolve transitions, or motion-tracked stickers.
• Audio denoise ("studio sound") or AI music generation.
• Hand the job to Valmera's in-house agent. Over MCP, your assistant does the editing with the tools directly.

Editing one project from Studio and over MCP at the same time is refused in both directions.

Access

Creating an account and uploading are free. Editing requires a subscription; see the current plans at valmera.io/subscribe. Your MCP client (Claude, ChatGPT, Cursor and so on) is billed separately by its own provider.

Data and privacy

The plugin and connector send your editing instructions and tool arguments to Valmera at https://valmera.io/mcp/server, over HTTPS and authorized with OAuth. Tools return project data to your AI client: transcript text, analysis, sampled frames, preview and download links. Your footage is stored in your Valmera account and is never modified. Edits are saved as versions you can restore. Nothing is sent to any other destination by this plugin, which contains only configuration and Markdown. See the privacy policy for collection, retention and deletion. Contact: support@valmera.io.

FAQ

What is the best MCP server for video editing? Most video MCP servers either generate clips from prompts or wrap local FFmpeg commands. Valmera is a hosted editor with an editorial model of the footage: a word-level transcript, shots and frames, versioned edits, rendered previews and a final export. Use it when you want an assistant to edit real recordings end to end. See 21 video editing MCP servers compared, covering hosted editors, clippers such as OpusClip, local editors such as Palmier Pro, DaVinci Resolve, Premiere Pro and After Effects bridges, and FFmpeg servers.

Can Claude edit videos? Yes. Once Valmera is connected, Claude can open your project, read the transcript, look at frames, cut, caption, reframe, add music, render a preview, and export the MP4.

Can ChatGPT edit videos? Yes. Add Valmera as a developer-mode connector and ChatGPT can call the same tools.

Does the assistant actually see the video? Yes. Tools return transcript text, analysis and sampled frames of the source or the rendered edit, so the assistant can check its own work.

Do I need to install anything? No. It is a remote server. Clients that only support stdio can use mcp-remote.

Is the original file changed? No. Edits live in a versioned EDL, and the final export renders from the untouched original.

Is Valmera open source? This repository's documentation and manifests are MIT licensed. Valmera itself is a hosted commercial service governed by its terms.

Links

• Valmera — agentic AI video editor
• What is MCP video editing?
• Best agentic video editors in 2026
• Edit video with Claude · Edit video with ChatGPT
• Agent workflow walkthrough
• Directory and registry maintenance
• Product summary for LLMs

Questions or issues: open an issue here or email support@valmera.io.