Works with any MCP clientClaudeCodexChatGPTCursorGeminiOpenClaw
Hosted MCP server

One endpoint. A full video editor.

Give any MCP-capable agent direct access to your BlitzReels workspace. It can inspect media, edit timelines, run workflows, generate assets, and export finished video.

blitzreels / mcplive
127
canonical tools
OAuth
workspace auth
HTTP
streamable
Endpoint
https://blitzreels.com/api/mcp
Example MCP config
{
  "mcpServers": {
    "blitzreels": {
      "type": "http",
      "url": "https://blitzreels.com/api/mcp"
    }
  }
}

First call opens an OAuth sign-in. The agent acts as you, scoped to your workspace.

Three steps

Connect from the client you already use.

The endpoint and capabilities stay the same across Claude, Codex, ChatGPT, Cursor, and other MCP clients.

  1. 01

    Add the endpoint

    Paste the hosted BlitzReels URL into your client's MCP server or connector settings.

  2. 02

    Approve OAuth

    Sign in once. Every tool call stays scoped to your BlitzReels workspace and permissions.

  3. 03

    Describe the edit

    Ask the agent to inspect, edit, generate, or export. It chooses from the same canonical tool catalog.

Live capability index

All 127 MCP tools.

Names and descriptions come from the same descriptors served to connected agents, so this list stays aligned with discovery.

Read the docs
127 tools

Projects and exports

27

List Projects

projects_list
Read

List the user's BlitzReels projects with status, duration, and basic metadata.

Get Project

projects_get
Read

Get details for one BlitzReels project, including timeline summary, clips, captions, and current recovery state with an app path and next read tool.

Inspect Project

projects_inspect
Read

Read bounded project context for editing, including timeline items, media assets, transcripts, captions, and stable IDs.

List Exports

exports_list
Read

List exports with render status and progress. Completed exports include a signed download URL. Pass exportId to return one export.

Read Export Caption Track

exports_caption_track_get
Read

Read a WebVTT caption track from the completed export's immutable canonical speech snapshot, preserving the actual export trims. Returns unavailable for older exports or unverified speech; never fabricates captions from titles or current edited timelines.

editor asset replace

editor_asset_replace
Write

Replace one shot's media asset while preserving the other timeline items. Revision checked; dryRun previews by default. Requires a current editor snapshot and an asset in the same workspace.

editor audio set

editor_audio_set
Write

Adjust one item's volume and audio fades. Revision checked; dryRun previews by default. Preserves the rest of the project.

editor text set

editor_text_set
Write

Create or revise one title or text overlay with explicit timing. Revision checked; dryRun previews by default. This edits project text, not spoken audio or captions.

editor crop set

editor_crop_set
Write

Adjust the crop of one existing source view after a layout has been applied. Revision checked; dryRun previews by default. Preserves the other shots.

editor assets insert

editor_assets_insert
Write

Insert a workspace image, generated shot or audio asset at an explicit project time. Revision checked; dryRun previews by default.

editor items move

editor_items_move
Write

Move selected timeline items to explicit times and layers. Revision checked; dryRun previews by default.

editor items remove

editor_items_remove
Write

Remove selected timeline items and, if requested, their linked captions. Revision checked; dryRun previews by default. The saved action can be undone.

Read Editor Snapshot

editor_snapshot_get
Read

Read the current revision, stable timeline IDs, captions, style and bounded media context before a precise revision. Signed media links are refreshed by reading again.

List Edit History

editor_history_list
Read

Read up to 50 saved edit actions, their labels and undo state. Does not restore or change the project.

Undo Saved Edit

editor_edit_undo
Write

Restore one saved editor action at the expected current revision. Requires the action ID from edit history and an idempotency key. Existing project data is changed.

Review Clip Candidates

clips_candidates_list
Read

Read existing suggested moments with source ranges, hooks, transcript excerpts and thumbnails before producing videos. Results are bounded; this does not generate suggestions or render clips.

Read Caption Words

captions_words_list
Read

Read bounded editable caption words and stable word IDs for one project, optionally matching text.

Correct Caption Words

captions_words_correct
Write

Replace selected caption words by their stable IDs. Preserves timing and the other captions; this does not change the spoken audio.

Save Video Quality Feedback

video_feedback_save
Write

Save the user's 1-5 rating and optional quality category/comment against one completed playable video export. Replaces that user's previous feedback for this export; does not change accepted clips or defaults. Requires the feedback storage migration to be installed.

Prepare Source Captions

captions_source_prepare
Write

Restore editable project captions from the selected source's completed canonical transcript. Keeps the full recording and avoids duplicate captions on identical retries. Requires source transcription first; no-speech is an explicit successful state.

Recover Missing Clips

clips_recover
Write

Recover a terminal batch's missing clip count through the persisted recovery workflow. Preserves accepted clips and returns the recovery batch ID. Can spend existing account credits; retry with the identical idempotency key.

List Workspaces

workspaces_list
Read

List bounded workspaces the connected user belongs to, with their role and default workspace. Selecting a workspace for the task does not change account defaults.

Read Business Context

workspace_context_get
Read

Read the selected workspace's business audience, offer, reviewed brand defaults, protected vocabulary, editorial purpose, language, avoided terms, pronunciation notes and existing account entitlements. Returns current export quality and watermark constraints without pricing or upgrade links.

Save Reviewed Business Context

workspace_context_save
Write

Save the user-reviewed business name, audience, offer, conversion goal, tone, protected vocabulary and editorial preferences for the selected workspace. Requires workspace settings permission and confirmReviewed=true; changes future assistant guidance, preserving existing projects. Pronunciation notes guide script drafting; they do not retime or replace source speech.

Inspect Supplied Business Website

workspace_brand_scan
Write

Start extracting a brand profile from the exact website the user supplied and authorized to scan. Saves a draft profile for review; does not apply discovered fields to existing videos. Can spend existing account credits.

Read Website Brand Draft

workspace_brand_scan_get
Read

Read one authorized website extraction run and its draft business profile. Show the extracted fields to the user for review before saving them as defaults.

Read Published Content Performance

content_performance_list
Read

Read bounded existing provider-reported engagement in the selected workspace, sorted by views. Returns source title, caption, published date and views/likes/comments/shares/saves. Does not import new data, start monitoring or infer attributable leads, sales or revenue.

Media library and uploads

15

List Media

media_list
Read

List media files in user's library (videos, audio, images)

Get Media Transcript

media_transcript_get
Read

Get transcript summary metadata or a bounded window of transcription segments for a video asset.

Upload File

media_upload_file
Write

Import a video, audio, or image file from ChatGPT into the BlitzReels media library. Use this for a file the user attached or picked, and for an image ChatGPT generated in this conversation that the user wants to keep, animate, or edit in BlitzReels.

Import Media From URL

media_import_url
Write

Import a video, audio, or image from a user-provided direct URL into the private BlitzReels media library.

Start Media Upload

media_upload_start
Write

Get a presigned URL for direct file upload (for large files)

Finish Media Upload

media_upload_finish
Write

Complete the upload process after uploading to a presigned URL

Inspect Import URL

media_import_inspect
Read

Inspect a user-provided public social-video or Google Drive URL and return available import metadata without creating media.

Scan Page For Video

media_import_scan_page
Read

Scan a user-controlled public page and return an importable video URL found on it without creating media.

Get Media Asset

media_assets_get
Read

Get metadata and processing state for one media-library asset without returning transcript segments.

Preview Media Asset

media_assets_preview
Read

Return one bounded JPEG as MCP image content for visual inspection. Images use the stored visual; videos use the existing thumbnail.

List Media Folders

media_folders_list
Read

List one bounded level of media-library folders and direct asset counts.

Create Media Folder

media_folders_create
Write

Create one media-library folder in a workspace and return a retry-safe mutation receipt.

Update Media Asset

media_assets_update
Write

Rename one media asset, edit its description, move it to a folder, or change B-roll eligibility. Provide at least one of name, description, folderId, or allowUsingAsBroll.

Estimate Video Upscale

media_upscale_estimate
Read

Estimate ByteDance upscale eligibility and credits for one stored video. Does not spend credits or queue a job. Call this before media_upscale.

Upscale Video

media_upscale
Write

Queue a ByteDance upscale of one stored video asset to 1080p or 4k. Call media_upscale_estimate first. Spends AI credits and returns a new pending media asset to poll with media_assets_get.

Clipping and captions

24

Create Clips

clips_create
Write

Create a private BlitzReels clip batch from an existing asset or a user-provided video URL. Supports public social videos, Google Drive, and direct media URLs.

Get Clip Batch

clips_get
Read

Get status, generated clips, render counts, and download links for a BlitzReels clip batch.

Manage Clips

clips_manage
Write

List or inspect clips, regenerate, repair visual QA, start export, promote an accepted delivery export, inspect caption words, or apply a verified caption look.

Delete Clip Batch

clip_batches_delete
Write

Preview or delete a terminal clip batch. Dry-run is the default; real deletion requires explicit confirmation, retention choice, workspace delete permission, and an idempotency key.

Refresh Clip Progress

clips_status_get
Read

Read one existing batch's progress, ready clips and renewed signed links without opening or remounting a review widget. Safe for bounded polling and widget refresh; does not recreate or repair clips.

List Clips

clips_list
Read

List bounded managed clips from the selected source or project with their current workflow state.

Inspect One Clip

clips_inspect
Read

Read one managed clip's selected source range, project, workflow state and delivery information.

Revise Selected Moment

clips_reselect
Write

Replace the source moment for one managed clip using a verified suggestion or explicit time range. Can spend existing account credits. Preserves the other clips; read current state before retrying.

Repair One Clip Layout

clips_repair
Write

Request a layout repair for one managed clip, such as preserving a screen demo or moving captions away from faces. Changes that clip's project; preserves the other clips.

Export One Clip

clips_export
Write

Render one managed clip at an existing-account-supported quality. Returns persisted export state; inspect until the accepted delivery file is ready. Can spend existing account credits.

Apply Caption Look

captions_look_apply
Write

Apply a verified caption look to one project. Preserves word overrides unless clearWordOverrides=true. Existing captions are restyled; spoken audio is preserved.

List Synchronized Recordings

recording_sets_list
Read

Read bounded camera and screen recording sets in the selected workspace with status, duration and alignment warnings.

Inspect Synchronized Recording

recording_sets_get
Read

Read one camera and screen recording set, its primary speaker, content windows, alignment and warnings. Separate audio-only tracks are not supported.

Create Synchronized Recording

recording_sets_create
Write

Create an empty camera and screen recording set in the explicit workspace. Requires existing recording-set access; does not import files or start processing.

Attach Camera or Screen Recording

recording_sets_track_attach
Write

Attach one existing authorized video asset as a camera or screen track. Specify the main speaker when known; alignment happens during finalization.

Synchronize Recording Tracks

recording_sets_finalize
Write

Finalize the collected camera and screen tracks and queue analysis. Can spend existing transcription credits. Inspect returned alignment and warnings before clipping.

Clip a Synchronized Recording

recording_sets_clips_create
Write

Produce a batch from a ready synchronized camera and screen recording, with optional clip count, maximum duration and caption look. Preserves readable screen context through the existing layout pipeline. Can spend existing credits; follows clips_get with the returned batch_id.

Read Clip Review Link

clip_share_get
Read

Read whether the source video's clip share page is public and which clips are visible. Does not publish content.

Publish a Clip Review Link

clip_share_publish
Write

Make the selected source video's clip page public with reviewed title, description and explicit download permission. Requires confirmPublicSharing=true from the user. Returns the verified public URL; no social network post is made.

Unpublish a Clip Review Link

clip_share_unpublish
Write

Disable public access to the selected clip page. Changes an existing publication; preserves private projects and exports.

Set Shared Clip Visibility

clip_share_visibility_set
Write

Show or hide one identified clip on an existing public review page after explicit user confirmation. Preserves the other clips and private project data.

Create Project

projects_create
Write

Create a new private BlitzReels video project.

List Clip Presets

clips_presets_list
Read

List available clip batch presets and their clipping/caption defaults.

List Caption Themes

captions_themes_list
Read

List built-in caption looks and saved caption themes available to a workspace.

Timeline editing

11

Apply Timeline Edit

timeline_edit_apply
Write

Trim or extend one timeline item. Split one timeline item at an exact sequence position.

Preview Timeline Edit

timeline_edit_preview
Read

Preview without mutation. Trim or extend one timeline item. Split one timeline item at an exact sequence position.

Apply visual presets

visuals_apply
Write

Create or update up to 20 visual blocks in one call after edit timing is settled. Presets: broll-headline, steps, quote, end-screen, key-number, before-after, screenshot-focus, chapter. IDs are scoped to the project; repeating an ID updates it. Asset IDs must belong to the workspace. Atomic, undoable; dryRun validates without writing. Returns IDs and revision. No generation pass.

Update Timeline Clip

update_timeline_clip
Write

Update one timeline item's start, duration, trim, layer, ignored state, or blurred background. Provide at least one field to update besides timelineItemId.

Batch Update Timeline Clips

batch_update_timeline_clips
Write

Update timing, trim, layer, or state for up to 100 timeline items in one sequence transaction.

Mute Clip Audio

mute_clip_audio
Write

Set one timeline media item's volume to zero.

Delete Timeline Items

delete_timeline_items
Write

Preview or delete up to 100 timeline items and optionally remove linked captions.

Add Title Card

add_text_overlay
Write

Add an opening title card (hook) or generic text overlay to a project timeline. Defaults to classic white: black text on a white card.

Add Transition

add_transition
Write

Add a timed transition effect, optionally attached to one timeline item and paired with sound.

Add Media To Timeline

timeline_media_add
Write

Place an image or video asset onto a BlitzReels project timeline at a timestamp, including B-roll and static images.

Add Audio To Timeline

timeline_audio_add
Write

Place an audio asset onto a BlitzReels project timeline at a timestamp for voiceover, music, or sound.

Workflows

07

List Workflows

workflows_list
Read

List public BlitzReels workflows that can be imported into a workspace.

Import Workflow

workflows_import
Write

Import a public BlitzReels workflow into the user's workspace.

Get Workflow

workflows_get
Read

Get a workflow definition, input schema, defaults, and ordered steps.

Create Workflow Run

workflow_runs_create
Write

Create an interactive workflow run from a workflow and optional inputs.

Get Workflow Run

workflow_runs_get
Read

Get workflow run status, step statuses, outputs, warnings, and dashboard URL.

Execute Workflow Run Step

workflow_runs_execute_step
Write

Execute one pending workflow run step and return updated run status.

Start Export

exports_start
Write

Render a BlitzReels video project and return export and job IDs for status checks.

AI generation

17

List Generation Options

generation_options_list
Read

List the models, defaults, limits, and credit costs available for one generation kind before queueing it. Video duration is an enum per model (durations_seconds), not a min-max range.

Generate Image

generation_image_create
Write

Queue an AI image generation into the BlitzReels media library. Spends AI credits and returns a job to poll with generation_jobs_get.

Generate Video

generation_video_create
Write

Queue video generation, image animation, source-video editing or character replacement into the media library. Editing accepts referenceVideoAssetIds and transformation controls, including original-audio preservation. Spends AI credits and returns a job readable with generation_jobs_get.

Generate Voiceover

generation_voiceover_create
Write

Queue a text-to-speech voiceover into the BlitzReels media library. Spends AI credits and returns a job to poll with generation_jobs_get.

Generate Music

generation_music_create
Write

Queue a background music track into the BlitzReels media library. Spends AI credits and returns a job to poll with generation_jobs_get.

Generate Sound Effect

generation_sound_create
Write

Queue a sound effect into the BlitzReels media library. Spends AI credits and returns a job to poll with generation_jobs_get.

Generate Faceless Video

generation_faceless_create
Write

Turn a script into a full faceless video project: scene plan, generated visuals, optional voiceover, captions, music, and sound. Spends AI credits and returns a job to poll with generation_jobs_get.

Get Generation Job

generation_jobs_get
Read

Check a queued generation. Completed jobs carry the media asset ID and a download URL.

Cancel Generation Job

generation_jobs_cancel
Write

Request cancellation of the identified queued or running generation. Work already performed can consume credits; cancellation does not establish a refund.

Get Generation Plan Brief

generation_plan_brief
Read

Read a generation brief from rawPrompt. Source-video edits return execution for generation_video_create with required assets and transformation controls. New scenes return an authoring grammar and planJsonSchema for generation_plan_validate. This read does not generate media or spend credits.

Validate Generation Plan

generation_plan_validate
Read

Validate a self-authored generation plan against the schema and the target model's real capabilities before execution. Returns directive errors to fix and revalidate; only a valid plan is executable.

Plan an Approved Video Script

video_storyboard_create
Write

Create a vertical video storyboard for the user-approved script in an existing project. Spends planning credits; returns scene narration, factual review notes, references and the production credit estimate. Does not generate images or animate video. Existing account access applies.

Review Video Storyboard

video_storyboard_get
Read

Read one authorized storyboard revision, its scene and reference previews, estimate, approvals and bounded polling guidance. Refreshes signed previews. Complete means the editable timeline is assembled; use exports_start and exports_list for a downloadable MP4.

Revise Selected Storyboard Scenes

video_storyboard_revise
Write

Create a new immutable draft from a known revision with selected scene, character or model changes. Preserves other scene definitions; requires review and production approval again. Does not generate media or overwrite an approved revision.

Approve Storyboard Previews

video_storyboard_approve
Write

After showing the storyboard and its credit estimate, confirmApproved=true starts production of reference images and scene keyframes. Spends existing credits. This stage produces reviewable previews, not animated videos.

Approve Previews and Produce Video

video_assets_approve
Write

After the user approves the generated previews and animation cost, confirmApproved=true starts scene animation, narration and editable timeline assembly. Can replace the project's generated timeline and spend existing credits. Follow the revision and then export the finished project.

Regenerate Selected Storyboard Preview

video_storyboard_asset_regenerate
Write

Replace the identified preview after user approval of the new credit cost. A scene_keyframe changes one keyframe; a character_anchor refreshes its dependent keyframes; a style_anchor refreshes every keyframe. Preserves unaffected previews. Does not regenerate an already finished video shot.

Story kits

06

List Reusable Characters

characters_list
Read

List bounded reusable characters with identity, voice, facts, and image-reference metadata.

Get Reusable Character

characters_get
Read

Inspect one reusable character and its ordered reference-image set before planning a story.

Apply Reusable Character

characters_apply
Write

Create or update a reference-based character for repeatable faceless story generation.

List Story Kits

story_kits_list
Read

List bounded reusable Story Kits that bind characters, locations, style, facts, and narrator voice.

Get Story Kit

story_kits_get
Read

Inspect one Story Kit and its revision before generating or updating a story.

Apply Story Kit

story_kits_apply
Write

Create or update a Story Kit with optimistic concurrency and an idempotent mutation receipt.

Series

06

List Series

series_list
Read

List optional Series with bounded counts and cover previews.

Get Series

series_get
Read

Read a Series identity, creative defaults and revision.

List Series Content

series_content
Read

List sources or projects in a Series. Null seriesId lists standalone content. sourceId filters projects by clip origin.

Apply Series

series_apply
Write

Create or replace a Growth+ Series identity and defaults. defaultCreationMode selects podcast branding or faceless Story Kit defaults; membership stays mixed. Updates require expectedRevision. Existing content keeps its settings.

Assign Series Content

series_assign
Write

Assign, move or detach one source or project using expectedSeriesId. Moving a source does not move existing clips or change branding.

Delete Series

series_delete
Write

Delete the Series container at an expected revision and detach its content. Sources, projects and exports are preserved.

Carousels

09

Compile Carousel

carousels_compile
Write

Create or replace a carousel project from a slide document. Server owns chip layout, safezones, and exact export pixels.

Preview Carousel

carousels_preview
Read

Render JPEG stills for a compiled carousel at the exact platform frame and return them as MCP images so you can inspect chips on the real slides.

Get Carousel Document

carousels_get
Read

Read the carousel slot document and the named template catalog.

Patch Carousel Slide

carousels_patch_slide
Write

Patch named slots or template_id on one slide. Re-rasters that slide only. Never rewrite HTML.

Patch Carousel Document

carousels_patch_document
Write

Reorder, remove, insert, duplicate, or undo slides on a compiled carousel. One write for the filmstrip. Insert rasters an empty named template unless sourceIndex copies a slide.

Expand Carousel Recipe

carousels_expand_recipe
Read

Turn a named recipe or a brief into compile-ready named-template slides. Expand never publishes and never invents metrics.

Migrate Legacy Carousel

carousels_migrate
Write

Rebuild a compile slot document from a legacy overlay carousel. Then patch slots like any compiled deck.

Clone Carousel

carousels_clone
Write

Duplicate a carousel onto a new project. Copies slots. Icon and shot values may be pack filenames or asset:<media_asset_id>.

Carousel Theme Kit

carousels_kit
Write

Save or apply a theme, brand theme, or named slide template. Themes rewrite fonts, colors, overlay, and asset:<id> logos. Never persist signed URLs.

Publishing

05

List Publishing Connections

publishing_connections_list
Read

List Instagram accounts connected through the BlitzReels UI for the authenticated workspace, including their connection status.

Schedule Instagram Publish

publishing_instagram_schedule
Write

Schedule a completed project export to Instagram. Optional includeAffiliateCta appends Try BlitzReels for free plus the Affonso tracking URL. Requires an active Instagram account connected in the BlitzReels UI.

Read Connected Publishing Accounts

publishing_accounts_list
Read

Read the supported accounts available through the existing workspace and provider access rules. Does not connect new accounts, publish, schedule or bypass provider review.

Schedule Reviewed Video Publication

publishing_video_schedule
Write

Schedule a selected existing video asset to explicit active YouTube, Instagram, Facebook, TikTok, LinkedIn or Threads accounts connected in the BlitzReels UI, using reviewed copy, privacy/consent choices, synthetic-media disclosure, time and timezone. Requires confirmPublish=true. Existing workspace permissions and provider access rules apply. A scheduled receipt is not proof of publication.

Verify Video Publication

publishing_post_get
Read

Read the current targets for one publishing receipt with scheduled/published state and verified remote URLs. Does not retry or publish a failed target.

Protocol first

No preferred model. No private integration.

BlitzReels speaks MCP over Streamable HTTP. Any client that supports the protocol and OAuth can use the same tools.

Claude
Codex
ChatGPT
Cursor
Gemini
OpenClaw

AI agent video editing FAQ

Connection, authentication, compatibility, and API questions about the hosted server.

Does BlitzReels have an MCP server?+

Yes. BlitzReels runs a hosted MCP server over Streamable HTTP with OAuth at https://blitzreels.com/api/mcp. Add it to ChatGPT, Claude, Cursor, or any MCP-capable client and the agent can read projects, edit, and export on your behalf.

Can Claude Code edit videos with captions from a CLI?+

Yes. Claude Code signs in with the BlitzReels CLI (npx blitzreels auth login), then reads projects, edits captions and transcripts, inserts B-roll, and exports, all from the terminal. An installable agent skill pack gives Claude Code the exact commands and safe edit flows.

Which AI agents are compatible with BlitzReels?+

BlitzReels works with Claude Code, OpenAI Codex, and ChatGPT through the MCP server, CLI, or REST API, plus other MCP-capable clients such as Cursor. Installable skill packs are published for the most common coding agents.

Which video APIs support transcripts, B-roll, and export automation?+

BlitzReels covers transcripts, captions, B-roll insertion, reframing, and export automation in one REST API, with a hosted MCP server and a CLI on top. The OpenAPI schema at /api/openapi.json lets you generate clients for custom agents.

Can I try the agent integration for free?+

Yes. Website signup leads to a 7-day card trial with watermarked exports. A card is required; watermark-free export needs an active paid subscription.

Give your agent a video editor.

Connect once, approve your workspace, and start editing from any MCP-capable client.