# BlitzReels Video Editor (remote · www.blitzreels.com)

Create, edit, reframe, caption, organize, generate, and export short-form videos with BlitzReels.

- Trust score: 79/100 (medium)
- Change this week: +3
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-12

## Components

- remote · `www.blitzreels.com`: 79/100 (this document), [markdown](https://verifymcp.io/servers/com-blitzreels-blitzreels/api-mcp.md), [page](https://verifymcp.io/servers/com-blitzreels-blitzreels/api-mcp)

## Channel facts

- Endpoint: `https://www.blitzreels.com/api/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-12.

- **Endpoint Security**: 86/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation is enforced on tool calls, but the challenge carries no valid RFC 9728 metadata, so a client cannot discover where to get a token.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC is configured correctly; the domain's records validate against the full chain to the root.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 83/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 5968 tokens (~112/item across 53 items; 52 tools + 1 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 22/100
  - Stability check failed: schema churn in the 7 days we've observed: 0 tool removals, 1 breaking changes, 0 auth/transport breaks, 2 additions.
- **Tool Coverage**: 94/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 79% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).
  - Supports UI / widget rendering.

## Install

### Claude

```bash
claude mcp add --transport http com-blitzreels-blitzreels https://www.blitzreels.com/api/mcp
```

### Codex

```toml
[mcp_servers.com-blitzreels-blitzreels]
url = "https://www.blitzreels.com/api/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-blitzreels-blitzreels": {
      "type": "remote",
      "url": "https://www.blitzreels.com/api/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add com-blitzreels-blitzreels --url https://www.blitzreels.com/api/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  com-blitzreels-blitzreels:
    url: "https://www.blitzreels.com/api/mcp"
```

### Other

```json
{
  "mcpServers": {
    "com-blitzreels-blitzreels": {
      "type": "http",
      "url": "https://www.blitzreels.com/api/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-12 (score 79, +1)

No change was recorded against any check on this day. Stability & Change Management went from 19 to 22.

### 2026-08-11 (score 78, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-08-10 (score 77, +1)

No change was recorded against any check on this day. Stability & Change Management went from 12 to 15.

### 2026-08-08 (score 76, −2)

- [security regression] HSTS header: pass → fail

### 2026-08-07 (score 78, +1)

- [security] Tool “clips_manage” rewrote its description, which is the text the model reads
- [cosmetic] “clips_manage” added an optional parameter “captionsEnabled”
- [cosmetic] “clips_manage” added an optional parameter “contentTypeHint”
- [cosmetic] “clips_manage” added an optional parameter “layoutMode”

### 2026-08-06 (score 77, +1)

- [security regression] Stability: unverified → fail
- [security regression] A breaking change shipped without a version bump: still 1.0.0
- [security] Tool “media_assets_update” rewrote its description, which is the text the model reads
- [security] Tool “update_timeline_clip” rewrote its description, which is the text the model reads
- [functional regression] “generation_video_create” changed the type of “durationSeconds”: number → integer
- [cosmetic] “generation_video_create” reworded the description of “durationSeconds”
- [cosmetic] “batch_update_timeline_clips” reworded the description of “updates”

### 2026-08-05 (score 76)

First indexed and scored.

## MCP tools (52)

### `projects_list` (~93 tokens)

List Projects

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

Input parameters:

- `limit` (number): Maximum number of projects to return (1-50)
- `offset` (number): Project offset.
- `search` (string): Search projects by name
- `status` (string): Filter by project status
- `workspaceId` (string): Optional workspace ID. Defaults to the user's default workspace. UUID string.

Output parameters:

- `bounds` (object)
- `projects` (array)

### `projects_get` (~44 tokens)

Get Project

Get details for one BlitzReels project, including timeline summary, clips, and captions.

Input parameters:

- `projectId` (string, required): The project ID to get details for. UUID string.

Output parameters:

- `error` (string)
- `project` (object|null)

### `projects_inspect` (~190 tokens)

Inspect Project

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

Input parameters:

- `assetLimit` (integer): Maximum media assets to return (1-50).
- `assetOffset` (integer): Media asset offset.
- `captionWordLimit` (integer): Maximum caption words to return (1-2000).
- `captionWordOffset` (integer): Caption word offset.
- `mode` (string): Bounded project context view to return.
- `projectId` (string, required): Project UUID. UUID string.
- `search` (string): Optional media search when mode is assets or full.
- `timelineLimit` (integer): Maximum timeline items to return (1-1000).
- `timelineOffset` (integer): Timeline item offset.
- `transcriptLimit` (integer): Maximum transcript segments to return (1-500).
- `transcriptOffset` (integer): Transcript segment offset.

Output parameters:

- `bounds` (object)
- `data` (object)
- `mode` (string)

### `exports_list` (~135 tokens)

List Exports

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

Input parameters:

- `exportId` (string): Return only this export, including its signed download URL when the render is complete. UUID string.
- `limit` (number): Maximum exports to return when exportId is absent (1-50).
- `offset` (number): Export offset when exportId is absent.
- `projectId` (string): Filter exports by project ID. UUID string.
- `workspaceId` (string): Optional workspace ID when projectId is not provided. Defaults to the user's default workspace. UUID string.

Output parameters:

- `bounds` (object)
- `exports` (array)

### `media_list` (~81 tokens)

List Media

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

Input parameters:

- `assetType` (string): Filter by asset type
- `limit` (integer): Maximum number of assets to return (1-50)
- `offset` (integer): Media asset offset.
- `workspaceId` (string): Optional workspace ID. Defaults to the user's default workspace. UUID string.

Output parameters:

- `assets` (array)
- `bounds` (object)

### `media_transcript_get` (~104 tokens)

Get Media Transcript

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

Input parameters:

- `assetId` (string, required): The media asset ID to get transcript for. UUID string.
- `limit` (integer): Maximum transcript segments to return (1-200).
- `mode` (string): Summary returns metadata only. Text returns joined text for a bounded segment window. Full returns the bounded segment objects without duplicating their text.
- `offset` (integer): Transcript segment offset.

Output parameters:

- `error` (string)
- `transcript` (object|null)

### `projects_create` (~110 tokens)

Create Project

Create a new private BlitzReels video project.

Input parameters:

- `aspectRatio` (string): Video aspect ratio
- `description` (string): Project description (optional, max 500 characters)
- `frameRate` (string): Video frame rate
- `idempotencyKey` (string): Retry key. Reuse only with identical inputs.
- `name` (string, required): Project name (1-100 characters)
- `workspaceId` (string): Optional workspace ID. Defaults to the user's default workspace. UUID string.

Output parameters:

- `project` (object)

### `media_upload_file` (~167 tokens)

Upload File

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.

Input parameters:

- `file` (object, required): A file from ChatGPT: attached by the user, picked from their file library, or produced earlier in this conversation. ChatGPT provides this value.
- `name` (string): Optional name to use in BlitzReels.
- `projectId` (string): Optional BlitzReels project ID to associate with the uploaded file. UUID string.
- `workspaceId` (string): Optional workspace ID when projectId is not provided. Defaults to the user's default workspace. UUID string.

Output parameters:

- `media` (object)

### `media_import_url` (~132 tokens)

Import Media From URL

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

Input parameters:

- `contentHashSha256` (string): Optional SHA-256 hex hash of file bytes for dedupe optimization. 64-character hex string.
- `name` (string): Optional name for the file
- `projectId` (string): Optional project ID to associate the upload with. UUID string.
- `url` (string, required): URL of the media file to download and upload
- `workspaceId` (string): Optional workspace ID when projectId is not provided. Defaults to the user's default workspace. UUID string.

Output parameters:

- `media` (object)

### `media_upload_start` (~107 tokens)

Start Media Upload

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

Input parameters:

- `contentType` (string, required): MIME type (e.g., video/mp4, audio/mp3, image/jpeg)
- `fileName` (string, required): Name of the file to upload
- `projectId` (string): Optional project ID to associate the upload with. UUID string.
- `workspaceId` (string): Optional workspace ID when projectId is not provided. Defaults to the user's default workspace. UUID string.

Output parameters:

- `uploadInfo` (object)

### `media_upload_finish` (~153 tokens)

Finish Media Upload

Complete the upload process after uploading to a presigned URL

Input parameters:

- `contentHashSha256` (string): Optional SHA-256 hex hash of file bytes for dedupe optimization. 64-character hex string.
- `contentType` (string, required): MIME type of the file
- `fileName` (string, required): Name of the uploaded file
- `fileSizeBytes` (number, required): Size of the uploaded file in bytes
- `projectId` (string): Optional project ID to associate the upload with. UUID string.
- `storageKey` (string, required): Storage key returned from media_upload_start
- `workspaceId` (string): Optional workspace ID when projectId is not provided. Defaults to the user's default workspace. UUID string.

Output parameters:

- `media` (object)

### `media_import_inspect` (~90 tokens)

Inspect Import URL

Check whether a video URL can be imported and return its title, duration, qualities, and audio tracks. Use for a social video link, a Google Drive file link, or a direct video file URL. Use media_import_scan_page instead when the URL is a web page that only embeds a video.

Input parameters:

- `url` (string, required): Public video URL. Supports social video links and Google Drive file links.

Output parameters:

- `preview` (object)

### `media_import_scan_page` (~75 tokens)

Scan Page For Video

Scan a web page and return the importable video URL found inside it. Use only when the URL is a page rather than a video; media_import_inspect already handles social, Google Drive, and direct video URLs.

Input parameters:

- `url` (string, required): Video page URL or direct media URL to inspect for an importable video.

Output parameters:

- `resolved` (object)

### `clips_presets_list` (~22 tokens)

List Clip Presets

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

Output parameters:

- `presets` (array)

### `captions_themes_list` (~74 tokens)

List Caption Themes

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

Input parameters:

- `includeBuiltInLooks` (boolean): Include built-in caption looks.
- `includeSavedThemes` (boolean): Include saved workspace caption themes.
- `workspaceId` (string): Optional workspace ID. Defaults to the user's default workspace. UUID string.

Output parameters:

- `themes` (array)

### `media_assets_get` (~38 tokens)

Get Media Asset

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

Input parameters:

- `assetId` (string, required): Media asset UUID. UUID string.

Output parameters:

- `asset` (object)

### `media_assets_preview` (~67 tokens)

Preview Media Asset

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

Input parameters:

- `assetId` (string, required): Media asset UUID. UUID string.
- `maxDimension` (integer): Maximum preview width or height in pixels (256-1536).

Output parameters:

- `asset` (object)
- `preview` (object)

### `media_folders_list` (~85 tokens)

List Media Folders

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

Input parameters:

- `limit` (integer): Maximum folders to return (1-50).
- `offset` (integer): Folder offset.
- `parentFolderId` (string): Parent folder UUID, or null for root folders.
- `workspaceId` (string): Workspace UUID, or null for the default workspace. UUID string.

Output parameters:

- `bounds` (object)
- `folders` (array)

### `media_folders_create` (~113 tokens)

Create Media Folder

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

Input parameters:

- `description` (string): Optional folder description.
- `iconType` (string): Folder icon type.
- `idempotencyKey` (string): Retry key. Reuse only with identical inputs.
- `name` (string, required): Folder name.
- `parentFolderId` (string): Parent folder UUID, or null for the root.
- `workspaceId` (string): Workspace UUID, or null for the default workspace. UUID string.

Output parameters:

- `folder` (object)
- `mutationReceipt` (object)

### `media_assets_update` (~148 tokens)

Update Media Asset

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.

Input parameters:

- `allowUsingAsBroll` (boolean): Whether the asset may be selected as B-roll.
- `assetId` (string, required): Media asset UUID. UUID string.
- `description` (string): New description, or null to clear it.
- `folderId` (string): Target folder UUID, or null to move the asset to root.
- `idempotencyKey` (string): Retry key. Reuse only with identical inputs.
- `name` (string): New media asset name.

Output parameters:

- `asset` (object)
- `mutationReceipt` (object)
- `txid` (number|null)
- `updatedFields` (array)

### `clips_create` (~228 tokens)

Create Clips

Create a BlitzReels clip batch from an existing video asset or an import URL. Supports YouTube, Instagram, TikTok, X, Facebook, Google Drive, and direct video URLs.

Input parameters:

- `assetId` (string): Existing BlitzReels video asset ID. Provide assetId or url, not both. UUID string.
- `autoTrimSilence` (boolean): Trim silence around selected moments.
- `captionThemeId` (string): Optional saved caption theme ID. Null uses workspace default captions. UUID string.
- `clipPresetId` (string): Clip style preset. Use high-retention for High Retention clips or demo-focus for product and screen demos.
- `createSharePage` (boolean): Create a public showcase page where completed clips appear.
- `idempotencyKey` (string): Retry key. Reuse only with identical inputs.
- `url` (string): Video URL to import before clipping. Supports social video links, Google Drive file links, and direct video file URLs.
- `workspaceId` (string): Optional workspace ID. Defaults to the user's default workspace. UUID string.

Output parameters:

- `batch` (object)
- `result` (object)

### `clips_get` (~67 tokens)

Get Clip Batch

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

Input parameters:

- `batchId` (string, required): Clip batch ID returned from clips_create. UUID string.
- `workspaceId` (string): Optional workspace ID. Defaults to the user's default workspace. UUID string.

Output parameters:

- `batch` (object)

### `clips_manage` (~271 tokens)

Manage Clips

List or inspect clips, regenerate an exact range or suggestion with layout and caption settings, repair visual QA, start export, inspect caption words, or apply a verified caption look.

Input parameters:

- `allowBlockingQaBypass` (boolean)
- `assetId` (string): UUID string.
- `captionWordLimit` (number)
- `captionsEnabled` (boolean)
- `clearWordOverrides` (boolean)
- `clipId` (string)
- `contentTypeHint` (string)
- `coverFrameSeconds` (number)
- `endSeconds` (number)
- `format` (string)
- `layoutMode` (string)
- `limit` (number)
- `lookId` (string)
- `matchText` (string)
- `maxDurationSeconds` (number)
- `minDurationSeconds` (number)
- `offset` (number)
- `operation` (string, required)
- `projectId` (string): UUID string.
- `repairMode` (string)
- `resolution` (string)
- `selectionMode` (string)
- `startSeconds` (number)
- `status` (string)
- `suggestionId` (string): UUID string.
- `timelineItemId` (string)
- `workspaceId` (string): UUID string.

### `clip_batches_delete` (~96 tokens)

Delete Clip Batch

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.

Input parameters:

- `batchId` (string, required): UUID string.
- `confirmDelete` (boolean)
- `dryRun` (boolean)
- `idempotencyKey` (string, required)
- `retention` (string)
- `workspaceId` (string): UUID string.

### `timeline_edit_apply` (~66 tokens)

Apply Timeline Edit

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

Input parameters:

- `expectedRevision` (integer|null, required): Expected sequence revision, or null.
- `idempotencyKey` (string, required)
- `operation` (required)
- `projectId` (string, required): UUID string.

### `timeline_edit_preview` (~60 tokens)

Preview Timeline Edit

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

Input parameters:

- `expectedRevision` (integer|null, required): Expected sequence revision, or null.
- `operation` (required)
- `projectId` (string, required): UUID string.

### `update_timeline_clip` (~150 tokens)

Update Timeline Clip

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

Input parameters:

- `blurredBackground` (boolean)
- `durationSeconds` (number)
- `expectedRevision` (integer): Expected sequence revision, or null.
- `idempotencyKey` (string, required): Retry key. Reuse only with identical inputs.
- `ignored` (boolean)
- `layerIndex` (integer)
- `projectId` (string, required): UUID string.
- `startSeconds` (number)
- `timelineItemId` (string, required)
- `trimEndSeconds` (number)
- `trimStartSeconds` (number)

Output parameters:

- `affectedTimelineItemIds` (array)
- `baseRevision` (integer)
- `createdTimelineItemIds` (array)
- `deletedTimelineItemIds` (array)
- `mutationReceipt` (object)
- `operationId` (string)
- `projectId` (string)
- `replayed` (boolean)
- `result` (object)
- `revision` (integer)
- `txid` (number)
- `warnings` (array)

### `batch_update_timeline_clips` (~96 tokens)

Batch Update Timeline Clips

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

Input parameters:

- `expectedRevision` (integer): Expected sequence revision, or null.
- `idempotencyKey` (string, required): Retry key. Reuse only with identical inputs.
- `projectId` (string, required): UUID string.
- `updates` (array, required): Each update needs at least one field to change besides timelineItemId.

Output parameters:

- `affectedTimelineItemIds` (array)
- `baseRevision` (integer)
- `createdTimelineItemIds` (array)
- `deletedTimelineItemIds` (array)
- `mutationReceipt` (object)
- `operationId` (string)
- `projectId` (string)
- `replayed` (boolean)
- `result` (object)
- `revision` (integer)
- `txid` (number)
- `warnings` (array)

### `mute_clip_audio` (~70 tokens)

Mute Clip Audio

Set one timeline media item's volume to zero.

Input parameters:

- `expectedRevision` (integer): Expected sequence revision, or null.
- `idempotencyKey` (string, required): Retry key. Reuse only with identical inputs.
- `projectId` (string, required): UUID string.
- `timelineItemId` (string, required)

Output parameters:

- `affectedTimelineItemIds` (array)
- `baseRevision` (integer)
- `createdTimelineItemIds` (array)
- `deletedTimelineItemIds` (array)
- `mutationReceipt` (object)
- `operationId` (string)
- `projectId` (string)
- `replayed` (boolean)
- `result` (object)
- `revision` (integer)
- `txid` (number)
- `warnings` (array)

### `delete_timeline_items` (~94 tokens)

Delete Timeline Items

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

Input parameters:

- `confirmDelete` (boolean)
- `dryRun` (boolean)
- `expectedRevision` (integer): Expected sequence revision, or null.
- `idempotencyKey` (string)
- `projectId` (string, required): UUID string.
- `removeAssociatedCaptions` (boolean)
- `timelineItemIds` (array, required)

### `add_text_overlay` (~106 tokens)

Add Text Overlay

Add an editable text overlay to a project timeline at an exact time and layer.

Input parameters:

- `durationSeconds` (number)
- `expectedRevision` (integer): Expected sequence revision, or null.
- `idempotencyKey` (string, required): Retry key. Reuse only with identical inputs.
- `layerIndex` (integer)
- `name` (string)
- `projectId` (string, required): UUID string.
- `startSeconds` (number)
- `text` (string, required)

Output parameters:

- `affectedTimelineItemIds` (array)
- `baseRevision` (integer)
- `createdTimelineItemIds` (array)
- `deletedTimelineItemIds` (array)
- `mutationReceipt` (object)
- `operationId` (string)
- `projectId` (string)
- `replayed` (boolean)
- `result` (object)
- `revision` (integer)
- `txid` (number)
- `warnings` (array)

### `add_transition` (~138 tokens)

Add Transition

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

Input parameters:

- `durationSeconds` (number)
- `easing` (string)
- `expectedRevision` (integer): Expected sequence revision, or null.
- `idempotencyKey` (string, required): Retry key. Reuse only with identical inputs.
- `includeSfx` (boolean)
- `intensity` (number)
- `layerIndex` (integer)
- `name` (string)
- `preset` (string)
- `projectId` (string, required): UUID string.
- `startSeconds` (number, required)
- `timelineItemId` (string)

Output parameters:

- `affectedTimelineItemIds` (array)
- `baseRevision` (integer)
- `createdTimelineItemIds` (array)
- `deletedTimelineItemIds` (array)
- `mutationReceipt` (object)
- `operationId` (string)
- `projectId` (string)
- `replayed` (boolean)
- `result` (object)
- `revision` (integer)
- `txid` (number)
- `warnings` (array)

### `workflows_list` (~71 tokens)

List Workflows

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

Input parameters:

- `limit` (number): Maximum workflows to return (1-50).
- `offset` (number): Pagination offset.
- `search` (string): Optional search query for workflow name or description.
- `trigger` (string): Optional trigger filter.

Output parameters:

- `bounds` (object)
- `workflows` (array)

### `workflows_import` (~58 tokens)

Import Workflow

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

Input parameters:

- `workflowId` (string, required): Public workflow ID to import. UUID string.
- `workspaceId` (string): Optional target workspace ID. Defaults to the user's default workspace. UUID string.

Output parameters:

- `workflow` (object)

### `workflows_get` (~63 tokens)

Get Workflow

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

Input parameters:

- `stepLimit` (number): Maximum workflow steps to return (1-100).
- `stepOffset` (number): Workflow step offset.
- `workflowId` (string, required): Workflow ID. UUID string.

Output parameters:

- `workflow` (object)

### `workflow_runs_create` (~76 tokens)

Create Workflow Run

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

Input parameters:

- `inputs` (object): Optional workflow input values. Omit to use workflow defaults.
- `projectId` (string): Optional project ID for workflows that operate on an existing project. UUID string.
- `workflowId` (string, required): Workflow ID to run. UUID string.

Output parameters:

- `run` (object)

### `workflow_runs_get` (~69 tokens)

Get Workflow Run

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

Input parameters:

- `runId` (string, required): Workflow run ID. UUID string.
- `stepLimit` (number): Maximum workflow run steps to return (1-100).
- `stepOffset` (number): Workflow run step offset.

Output parameters:

- `run` (object)

### `workflow_runs_execute_step` (~59 tokens)

Execute Workflow Run Step

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

Input parameters:

- `runId` (string, required): Workflow run ID. UUID string.
- `stepRunId` (string, required): Step run ID from workflow_runs_create or workflow_runs_get. UUID string.

Output parameters:

- `result` (object)
- `run` (object)

### `timeline_media_add` (~227 tokens)

Add Media To Timeline

Place an uploaded image or video asset onto the actual BlitzReels project timeline at a timestamp. Use after media_upload_file when the user asks to add B-roll, a static image, or visual media to the video.

Input parameters:

- `allowDuplicate` (boolean): Allow inserting the same asset more than once
- `animationPreset` (string): Optional visual animation preset
- `assetId` (string, required): Image or video media asset ID. UUID string.
- `durationSeconds` (number): Duration in seconds. Required for still images when a specific length is needed.
- `layerIndex` (number): Exact timeline layer to use. Lower layer numbers render on top. Omit for intent-based placement.
- `placementIntent` (string): Layer intent used when layerIndex is omitted. Use overlay for visible B-roll/logo/sticker over video, background for behind video, exact when layerIndex is supplied.
- `positionPreset` (string): Visual placement preset
- `projectId` (string, required): BlitzReels project ID. UUID string.
- `startSeconds` (number): Timeline start time in seconds

Output parameters:

- `result` (object)

### `timeline_audio_add` (~169 tokens)

Add Audio To Timeline

Place an uploaded audio asset onto the actual BlitzReels project timeline at a timestamp. Use after media_upload_file when the user asks to add voiceover, music, or audio to a video.

Input parameters:

- `assetId` (string, required): Audio media asset ID. UUID string.
- `durationSeconds` (number): Optional duration. Required if the audio asset duration is not known yet.
- `fadeInSeconds` (number): Fade-in length in seconds
- `fadeOutSeconds` (number): Fade-out length in seconds
- `loop` (boolean): Loop audio to fill requested duration
- `projectId` (string, required): BlitzReels project ID. UUID string.
- `startSeconds` (number): Timeline start time in seconds
- `volume` (number): Audio volume multiplier, 1 is normal

Output parameters:

- `result` (object)

### `exports_start` (~101 tokens)

Start Export

Render/export a BlitzReels video project after timeline edits. Returns export and job IDs that can be polled with exports_list.

Input parameters:

- `coverFrameSeconds` (number): Optional cover thumbnail timestamp
- `format` (string): Export container format
- `idempotencyKey` (string): Retry key. Reuse only with identical inputs.
- `projectId` (string, required): BlitzReels project ID. UUID string.
- `resolution` (string): Export resolution

Output parameters:

- `export` (object)

### `generation_options_list` (~41 tokens)

List Generation Options

List the models, defaults, limits, and credit costs available for one generation kind before queueing it.

Input parameters:

- `kind` (string, required): Generation kind to describe.

Output parameters:

- `options` (object)

### `generation_image_create` (~159 tokens)

Generate Image

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

Input parameters:

- `aspectRatio` (string): Output aspect ratio.
- `folderId` (string): Optional media library folder ID.
- `idempotencyKey` (string): Retry key. Reuse only with identical inputs.
- `model` (string): Image model. Call generation_options_list for costs.
- `prompt` (string, required): What the image should show (8-5000 characters).
- `referenceAssetIds` (array): Up to 4 existing image asset IDs to use as style or subject references.
- `workspaceId` (string): Optional workspace ID. Defaults to the user's default workspace. UUID string.

Output parameters:

- `generation` (object)

### `generation_video_create` (~351 tokens)

Generate Video

Queue an AI video generation into the BlitzReels media library, from a prompt or from an existing image asset. Spends AI credits and returns a job to poll with generation_jobs_get.

Input parameters:

- `aspectRatio` (string): Output aspect ratio.
- `durationSeconds` (integer): Clip length in seconds (2-30). Must be supported by the chosen model.
- `folderId` (string): Optional media library folder ID.
- `generateAudio` (boolean): Generate audio alongside the video when supported.
- `idempotencyKey` (string): Retry key. Reuse only with identical inputs.
- `model` (string): Video model. Supported durations and text-to-video vs image-to-video differ per model; call generation_options_list first.
- `negativePrompt` (string): What to avoid in the shot.
- `prompt` (string, required): What should happen in the shot (3-5000 characters).
- `referenceAssetIds` (array): Reference image asset IDs. Seedance 2.5 accepts 29 plus sourceAssetId, for 30 images total; other models accept up to 4.
- `referenceAudioAssetIds` (array): Seedance 2.5 reference audio asset IDs. Unsupported by other models.
- `referenceVideoAssetIds` (array): Seedance 2.5 reference video asset IDs. Unsupported by other models.
- `resolution` (string): Seedance 2.5 output resolution.
- `seed` (integer): Optional seed for reproducible output.
- `sourceAssetId` (string): Source image asset ID. Required by image-to-video models.
- `workspaceId` (string): Optional workspace ID. Defaults to the user's default workspace. UUID string.

Output parameters:

- `generation` (object)

### `generation_voiceover_create` (~149 tokens)

Generate Voiceover

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

Input parameters:

- `idempotencyKey` (string): Retry key. Reuse only with identical inputs.
- `speed` (number): Speaking rate between 0.5 and 1.6.
- `text` (string, required): Script to read aloud (3-8000 characters).
- `voiceId` (string): Voice ID. Call generation_options_list with kind voiceover for the catalog.
- `voiceStyle` (string): Delivery emotion.
- `workspaceId` (string): Optional workspace ID. Defaults to the user's default workspace. UUID string.

Output parameters:

- `generation` (object)

### `generation_music_create` (~115 tokens)

Generate Music

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

Input parameters:

- `durationSeconds` (number): Track length between 10 and 120 seconds.
- `idempotencyKey` (string): Retry key. Reuse only with identical inputs.
- `mood` (string): Track mood.
- `prompt` (string): Optional description of the track.
- `workspaceId` (string): Optional workspace ID. Defaults to the user's default workspace. UUID string.

Output parameters:

- `generation` (object)

### `generation_sound_create` (~151 tokens)

Generate Sound Effect

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

Input parameters:

- `durationSeconds` (number): Effect length between 0.5 and 30 seconds.
- `idempotencyKey` (string): Retry key. Reuse only with identical inputs.
- `loop` (boolean): Produce a seamlessly loopable effect.
- `prompt` (string, required): The sound to create (3-500 characters).
- `promptInfluence` (number): How literally to follow the prompt, between 0 and 1. Higher is more literal.
- `workspaceId` (string): Optional workspace ID. Defaults to the user's default workspace. UUID string.

Output parameters:

- `generation` (object)

### `generation_faceless_create` (~297 tokens)

Generate Faceless Video

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.

Input parameters:

- `captionStyleId` (string): Optional caption theme ID from captions_themes_list.
- `generateBackgroundMusic` (boolean): Add a generated background track.
- `generateSoundEffects` (boolean): Add generated sound effects.
- `generateVoiceover` (boolean): Narrate the script with a generated voice.
- `idempotencyKey` (string): Retry key. Reuse only with identical inputs.
- `imageModelId` (string): Model used to generate scene images.
- `includeCaptions` (boolean): Burn captions into the timeline.
- `plannerModelId` (string): Model used to plan the video scenes.
- `projectName` (string): Name for the created BlitzReels project.
- `script` (string, required): The narration or story to turn into a video.
- `targetDurationSeconds` (number): Target runtime between 10 and 120 seconds.
- `videoModel` (string): Image-to-video model used to animate scenes.
- `visualStyle` (string): Art direction for the generated scenes.
- `voiceId` (string): Voice ID used when generateVoiceover is true.
- `workspaceId` (string): Optional workspace ID. Defaults to the user's default workspace. UUID string.

Output parameters:

- `generation` (object)

### `generation_jobs_get` (~65 tokens)

Get Generation Job

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

Input parameters:

- `jobId` (string, required): Job ID returned by any generation_*_create tool.
- `workspaceId` (string): Optional workspace ID. Defaults to the user's default workspace. UUID string.

Output parameters:

- `job` (object)

### `generation_jobs_cancel` (~60 tokens)

Cancel Generation Job

Cancel a queued or running generation before it finishes spending credits.

Input parameters:

- `jobId` (string, required): Job ID returned by any generation_*_create tool.
- `workspaceId` (string): Optional workspace ID. Defaults to the user's default workspace. UUID string.

Output parameters:

- `job` (object)

### `generation_plan_brief` (~134 tokens)

Get Generation Plan Brief

Fetch the authoring brief for an AI video generation plan: the target model's prompting grammar, capability constraints, locked style contract, and the plan JSON schema. Author the plan yourself from this brief, then check it with generation_plan_validate.

Input parameters:

- `aspectRatio` (string)
- `targetDurationSeconds` (number): Desired final video duration in seconds.
- `videoModelId` (string): Target video model id (see generation_options_list, kind: video). Defaults to the strongest single-take model.
- `visualStyle` (string): Visual style preset id; its locked style contract is included in the brief.

Output parameters:

- `brief` (object)

### `generation_plan_validate` (~66 tokens)

Validate Generation Plan

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.

Input parameters:

- `plan` (object, required): The generation plan object authored from generation_plan_brief's planJsonSchema.

Output parameters:

- `errors` (array): Empty when valid. Each entry states exactly what to change.
- `valid` (boolean)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/com-blitzreels-blitzreels/api-mcp#diagnostics

## Score history

- 2026-08-12: 79
- 2026-08-11: 78
- 2026-08-10: 77
- 2026-08-09: 76
- 2026-08-08: 76
- 2026-08-07: 78
- 2026-08-06: 77
- 2026-08-05: 76

## Links

- Remote endpoint: https://www.blitzreels.com/api/mcp
- Website: https://www.blitzreels.com/agents
- Changelog RSS feed: https://verifymcp.io/servers/com-blitzreels-blitzreels/api-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/com-blitzreels-blitzreels/api-mcp.json
- HTML version of this page: https://verifymcp.io/servers/com-blitzreels-blitzreels/api-mcp