Shotcut MCP
MCPB · SHOTCUT-MCP-1.6.0.MCPB
Create, edit, validate, preview, and render Shotcut projects through AI clients.
Available components
Last scanned (4 hours ago)
Scores higher than 88% of MCPB servers
Category Design and Media
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security0
- No malware scan is available for this kind of package: the supply-chain vendors we use do not cover it. This is a permanent gap in our coverage, not a finding about the package.Unverified
- Known CVEs could not be checked: we found no dependency list to check in this bundle: either it runs a compiled binary, whose bundled manifests we do not read, or none of the package.json, requirements.txt, pyproject.toml or uv.lock files it ships for its runtime declares a dependency we can read (a requirements.txt that only points at a setup.py project, a local path, or a nested requirements file we cannot follow counts as none).Unverified
- Install-script risk not yet assessed.Unverified
- Dependency health could not be checked: we found no dependency list to check in this bundle: either it runs a compiled binary, whose bundled manifests we do not read, or none of the package.json, requirements.txt, pyproject.toml or uv.lock files it ships for its runtime declares a dependency we can read (a requirements.txt that only points at a setup.py project, a local path, or a nested requirements file we cannot follow counts as none).Unverified
Provenance & Transparency48
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 18 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability70
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 4657 tokens (~166/item across 28 items; 28 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 28 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 29 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 2 Nov 26 0
- Stability: 0.97 → pass security
- 1 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.
- 31 Oct 26 −1
- Stability: pass → 0.93 functional
- 25 Oct 26 0
- Stability: 0.97 → pass security
- 24 Oct 26 0
- Stability: pass → 0.97 functional
- 18 Oct 26 0
- Stability: 0.97 → pass security
- 17 Oct 26 0
- Schema quality: 3963 → 4657 ▼ functional
- 16 Oct 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 90 to 93. That category is still filling its 30-day observation window: 27 days of observed history at the previous scan, 28 at this one. The score rises as the window fills, whether or not the server changes.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 5 Nov 2026 · Analysed mcpb/https://github.com/matrodrigs/shotcut-mcp/releases/download/v1.6.0/shotcut-mcp-1.6.0.mcpb
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | mcpb |
| Reason | No attestation published |
Background: How many MCP packages publish verified provenance →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
analyze_media_quality Analyze media quality ~348
Use before proposing cleanup or delivery edits. Runs installed FFmpeg analyzers for silence, black frames, freezes, interlacing, and loudness and returns bounded structured measurements without changing the media.
| Name | Type | Req | Description |
|---|---|---|---|
| analyzers | array | – | Quality checks to run; defaults to every analyzer supported by this tool. |
| audio_stream_index | integer | – | Optional global FFprobe stream index for the audio checks. |
| black_min_duration_seconds | number | – | Minimum continuous black-frame duration to report. |
| black_picture_threshold | number | – | Fraction of qualifying dark pixels required for a black frame. |
| black_pixel_threshold | number | – | Per-pixel luminance threshold used by FFmpeg blackdetect. |
| dual_mono | boolean | – | Measure mono input as dual-mono when computing EBU R128 loudness. |
| duration_seconds | number | – | Optional bounded media duration in seconds to analyze. |
| freeze_min_duration_seconds | number | – | Minimum continuous frozen-video duration to report. |
| freeze_noise_db | number | – | Frame-difference tolerance in dB used by FFmpeg freezedetect. |
| max_intervals | integer | – | Maximum structured intervals retained per analyzer. |
| path | string | yes | Existing authorized local project, media, folder, or backup path. |
| silence_min_duration_seconds | number | – | Minimum continuous silence duration to report. |
| silence_threshold_db | number | – | Audio level in dB at or below which a segment counts as silence. |
| start_seconds | number | – | Optional media offset in seconds where analysis begins. |
| timeout_seconds | integer | – | Bounded timeout for local MLT processing. |
| video_stream_index | integer | – | Optional global FFprobe stream index for the video checks. |
| Name | Type | Req | Description |
|---|---|---|---|
| analyzers | object | – | – |
| current_revision | string|null | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| duration_seconds | number|null | – | – |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| expected_revision | string|null | – | – |
| media_duration_seconds | number|null | – | – |
| path | string | – | – |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
| requested_analyzers | array | – | Analyzer names requested by the caller. |
| start_seconds | number | – | – |
| streams | object | – | Selected global FFprobe stream indexes. |
No examples provided.
cancel_render Cancel render ~49
Use only when the user asks to stop an active render. Requests supervised cancellation, including after an MCP restart.
| Name | Type | Req | Description |
|---|---|---|---|
| job_id | string | yes | Durable render identifier returned by start_render or list_render_jobs. |
| Name | Type | Req | Description |
|---|---|---|---|
| cancellation_requested | boolean | – | – |
| current_revision | string|null | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| elapsed_seconds | number | – | – |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| eta_confidence | string|null | – | – |
| eta_seconds | number|null | – | – |
| expected_revision | string|null | – | – |
| in_frame | integer|null | – | – |
| job_id | string | – | – |
| log_tail | string|null | – | – |
| out_frame | integer|null | – | – |
| output_exists | boolean | – | – |
| output_path | string | – | – |
| output_size_bytes | integer|null | – | – |
| progress_percent | number|null | – | – |
| range_duration_frames | integer|null | – | – |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
| status | string | – | – |
No examples provided.
create_project Create multitrack Shotcut project ~226
Use to create a new editable Shotcut 26.8.1 project. If dimensions or frame rate were not requested, probe representative source media before choosing the profile; do not treat defaults as user intent. Tracks and clips use the same shapes as add_track and add_clip.
| Name | Type | Req | Description |
|---|---|---|---|
| clips | array | – | Initial clips using add_clip fields; track defaults to V1. |
| fps_den | integer | – | Project frame-rate denominator. |
| fps_num | integer | – | Project frame-rate numerator. |
| height | integer | – | Project height in pixels. |
| notes | string | – | Initial project notes. |
| overwrite | boolean | – | Replace an existing destination only when the user explicitly authorized it. |
| project_path | string | yes | Existing authorized Shotcut .mlt or .xml project path, except when create_project creates it. |
| timeout_seconds | integer | – | Bounded timeout for local MLT processing. |
| tracks | array | – | Initial tracks using add_track fields; V1 already exists. |
| width | integer | – | Project or contact-sheet width in pixels, depending on the tool. |
| Name | Type | Req | Description |
|---|---|---|---|
| backup_path | string|null | – | – |
| created | boolean | – | – |
| current_revision | string|null | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| expected_revision | string|null | – | – |
| operation_results | array | – | Results for initial track and clip operations. |
| path | string | – | – |
| previous_revision | string|null | – | – |
| project | object | – | Project snapshot; inspect_project publishes its complete schema. |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
| result_truncated | boolean | – | True means the project change committed but details were omitted to fit the MCP response budget. Do not retry the mutation; inspect the returned revision. |
| revision | string | – | – |
| validation | object | – | Result of processing the project with local Melt. |
No examples provided.
describe_mlt_service Describe MLT service ~61
Use after list_mlt_services to learn one installed service's accepted properties and local MLT metadata.
| Name | Type | Req | Description |
|---|---|---|---|
| kind | string | yes | MLT service kind to list or describe. |
| name | string | yes | Exact service name returned by list_mlt_services. |
| Name | Type | Req | Description |
|---|---|---|---|
| available | boolean | – | – |
| current_revision | string|null | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| expected_revision | string|null | – | – |
| kind | string | – | – |
| metadata | string|null | – | – |
| name | string | – | – |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
No examples provided.
detect_hardware_encoders Detect usable hardware encoders ~49
Use when choosing or troubleshooting hardware export. Lists advertised FFmpeg encoders and smoke-tests OS-appropriate candidates.
| Name | Type | Req | Description |
|---|---|---|---|
| refresh | boolean | – | Ignore cached encoder results and run smoke tests again. |
| Name | Type | Req | Description |
|---|---|---|---|
| candidates | array | – | OS-appropriate hardware encoder smoke tests. |
| current_revision | string|null | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| expected_revision | string|null | – | – |
| ffmpeg_path | string | – | – |
| note | string | – | – |
| platform | string | – | – |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
| suggestions | object | – | – |
No examples provided.
diagnose_color_workflow Diagnose project color workflow ~99
Use for washed-out colors, HDR/SDR questions, or export compatibility. Reports normalized source color facts and supported color-workflow constraints.
| Name | Type | Req | Description |
|---|---|---|---|
| hdr10_metadata | boolean | – | Whether the intended export requires HDR10 metadata. |
| output_codec | string | – | Optional intended export codec used to assess color compatibility. |
| project_path | string | yes | Existing authorized Shotcut .mlt or .xml project path, except when create_project creates it. |
| Name | Type | Req | Description |
|---|---|---|---|
| compatible | boolean | – | – |
| current_revision | string|null | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| expected_revision | string|null | – | – |
| issues | array | – | Color-workflow compatibility findings. |
| media | array | – | Bounded source-media summaries or probe errors. |
| media_truncated | boolean | – | – |
| project_color_workflow | object | – | Normalized Shotcut project color workflow. |
| project_path | string | – | – |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
| source_dynamic_ranges | array | – | Distinct detected source dynamic ranges. |
No examples provided.
diagnose_missing_media Find missing-media candidates ~261
Use when media is missing or offline. Searches authorized roots and ranks candidates without changing the project. Apply a source mapping the user already specified; otherwise let the user choose before relinking.
| Name | Type | Req | Description |
|---|---|---|---|
| max_candidates_per_resource | integer | – | Maximum ranked candidates returned for each missing resource. |
| max_depth | integer | – | Maximum directory depth below each search root. |
| max_files | integer | – | Maximum files examined across all search roots. |
| max_hash_bytes | integer | – | Largest candidate file eligible for Shotcut hash verification. |
| max_probe_candidates | integer | – | Maximum candidates inspected with FFprobe. |
| overwrite_visual | boolean | – | Replace an existing candidate sheet only with explicit authorization. |
| project_path | string | yes | Existing authorized Shotcut .mlt or .xml project path, except when create_project creates it. |
| search_roots | array | yes | One to eight authorized roots searched for missing-media candidates. |
| timeout_seconds | integer | – | Bounded timeout for local MLT processing. |
| visual_cell_width | integer | – | Width of each optional missing-media candidate cell in pixels. |
| visual_columns | integer | – | Columns in the optional missing-media candidate sheet. |
| visual_output_path | string | – | Optional PNG/JPEG destination for a missing-media candidate sheet. |
| Name | Type | Req | Description |
|---|---|---|---|
| commit_workflow | string | – | – |
| current_revision | string|null | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| expected_revision | string|null | – | – |
| missing_count | integer | – | – |
| project_path | string | – | – |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
| resources | array | – | Missing resources and their ranked replacement candidates. |
| search | object | – | Bounded search telemetry. |
| visual | object|null | – | – |
No examples provided.
discover_media Discover media in a folder ~194
Use when the user supplies a source folder. Lists media candidates by extension in deterministic pages, with optional bounded stream metadata. Respects path policy and skips directory symlinks; use probe_media to inspect individual files and do not infer visual content from filenames.
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | string | – | Opaque next_cursor from the preceding page with the same folder and recursive option. Changed file listings invalidate it. |
| folder_path | string | yes | Existing authorized local folder to scan; network folders require administrator opt-in. |
| include_metadata | boolean | – | Probe returned candidates for duration, video dimensions and audio. Probe failures are reported per file; remaining work shares a bounded time budget. |
| limit | integer | – | Maximum media candidates returned on this page. |
| recursive | boolean | – | Include subfolders up to 16 levels; directory symlinks are not followed. Scans stop with guidance after 20,000 entries or 30 seconds. |
| Name | Type | Req | Description |
|---|---|---|---|
| current_revision | string|null | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| expected_revision | string|null | – | – |
| folder_path | string | – | – |
| items | array | – | Media candidates on this page, with optional per-file metadata or probe errors. |
| next_cursor | string|null | – | – |
| offset | integer | – | – |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
| recursive | boolean | – | – |
| revision | string | – | – |
| scanned_entries | integer | – | – |
| skipped_entries | integer | – | – |
| total | integer | – | – |
No examples provided.
edit_project Edit project transactionally ~184
Use only after inspect_project. Applies up to 500 related operations in one validated atomic write; prefer item_ref and animate_clip for robust creative batches. Pass expected_revision and re-inspect on conflicts instead of force. Summarize committed operation results, and after visual edits show a managed contact sheet or exact preview.
| Name | Type | Req | Description |
|---|---|---|---|
| expected_revision | string | – | SHA-256 revision returned by inspect_project. Required unless force=true was explicitly authorized. |
| force | boolean | – | Bypass revision protection only with explicit user authorization; never retry conflicts with force automatically. |
| operations | array | yes | One or more related edit operations. Query shotcut_capabilities for unfamiliar operation schemas. |
| project_path | string | yes | Existing authorized Shotcut .mlt or .xml project path, except when create_project creates it. |
| timeout_seconds | integer | – | Bounded timeout for local MLT processing. |
| Name | Type | Req | Description |
|---|---|---|---|
| backup_path | string|null | – | – |
| current_revision | string|null | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| edited | boolean | – | – |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| expected_revision | string|null | – | – |
| item_bindings | object | – | Batch aliases mapped to item_ref values for the committed revision. |
| operation_results | array | – | Results in the same order as the requested operations. |
| path | string | – | – |
| previous_revision | string|null | – | – |
| project | object | – | Project snapshot; inspect_project publishes its complete schema. |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
| result_truncated | boolean | – | True means the project change committed but details were omitted to fit the MCP response budget. Do not retry the mutation; inspect the returned revision. |
| revision | string | – | – |
| validation | object | – | Result of processing the project with local Melt. |
No examples provided.
export_marker_chapters Export marker chapters ~184
Use to create Shotcut-compatible chapter text from point markers. Optionally includes range markers or selected marker colors and atomically protects an existing output.
| Name | Type | Req | Description |
|---|---|---|---|
| colors | array | – | Optional marker-color allowlist using Shotcut #RRGGBB values. |
| expected_revision | string | – | Optional SHA-256 revision returned by inspect_project. When supplied, export fails if the project has changed. |
| include_range_markers | boolean | – | Include Shotcut range markers as chapters; point markers are included by default. |
| output_path | string | yes | Authorized destination path. Omit only for single-frame or contact-sheet previews to use bounded managed output. |
| overwrite | boolean | – | Replace an existing destination only when the user explicitly authorized it. |
| project_path | string | yes | Existing authorized Shotcut .mlt or .xml project path, except when create_project creates it. |
| Name | Type | Req | Description |
|---|---|---|---|
| chapter_count | integer | – | – |
| chapters | array | – | Exported chapters in playback order. |
| colors | array|null | – | Applied marker-color allowlist. |
| created | boolean | – | – |
| current_revision | string|null | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| expected_revision | string|null | – | – |
| include_range_markers | boolean | – | – |
| marker_count | integer | – | – |
| path | string | – | – |
| project_path | string | – | – |
| project_revision | string | – | – |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
| size_bytes | integer | – | – |
No examples provided.
inspect_project Inspect project ~270
Use first to understand a timeline or before planning, editing, or restoring. Returns SHA-256 revision, stable item_ref selectors, and paginated structural state. Use summary for less detail, track/frame filters to focus, and pagination.next_offset with expected_revision to continue. Use render_contact_sheet for visual review.
| Name | Type | Req | Description |
|---|---|---|---|
| detail | string | – | Full includes properties and text; summary omits notes, captions, property bags and subtitle text, preserving identifiers and timing. |
| expected_revision | string | – | Revision from the first inspection page; pass on later pages to reject a changed project instead of mixing revisions. |
| in_frame | integer | – | Optional inclusive first timeline frame; returns items overlapping this range. |
| limit | integer | – | Maximum entries per collection page. Track metadata also accompanies every returned item. Nested filter details are retained in full. |
| offset | integer | – | Zero-based offset applied independently to timeline items, track metadata, and each top-level collection; use pagination.next_offset. |
| out_frame | integer | – | Optional inclusive last timeline frame; must be at least in_frame when both are supplied. |
| path | string | yes | Existing authorized local project, media, folder, or backup path. |
| track | string | – | Optional track name or track_id from an inspection; scopes timeline items and track metadata. |
| Name | Type | Req | Description |
|---|---|---|---|
| color_workflow | object | – | Normalized Shotcut project color workflow. |
| counts | object | – | Counts of important MLT element kinds. |
| current_revision | string|null | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| duration_frames | integer | – | Project duration in frames. |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| expected_revision | string|null | – | – |
| filters | array | – | Project-level filters in host order. |
| links | array | – | MLT links in the project. |
| markers | array | – | Shotcut point and range markers. |
| missing_resources | array | – | Resolved local resource paths that do not exist. |
| network_resources | array | – | Network resource values embedded in the project. |
| notes | string|null | – | Project notes, when present. |
| pagination | object | – | Each top-level collection and the flattened timeline item sequence uses the same offset/limit. Track and frame filters scope timeline items; other collections remain project-wide. Continue while next… |
| path | string | – | Authorized project path that was inspected. |
| profile | object | – | MLT profile attributes plus computed fps. |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
| resources | array | – | Media and data resources referenced by the project. |
| revision | string | – | SHA-256 revision to pass as expected_revision. |
| shotcut_editable | boolean | – | Whether the main tractor is marked as Shotcut-editable. |
| subtitles | array | – | Shotcut subtitle feeds. |
| tracks | array | – | Project tracks in main-tractor order. |
No examples provided.
list_mlt_services List MLT services ~49
Use when an edit needs an unfamiliar native MLT effect or transition. Lists services of one kind installed with Shotcut.
| Name | Type | Req | Description |
|---|---|---|---|
| kind | string | yes | MLT service kind to list or describe. |
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | – | – |
| current_revision | string|null | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| expected_revision | string|null | – | – |
| kind | string | – | – |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
| services | array | – | Installed MLT service names in sorted order. |
No examples provided.
list_project_backups List project backups ~61
Use before undo or recovery. Lists only backups owned by this project, including paths, revisions, sizes, and timestamps.
| Name | Type | Req | Description |
|---|---|---|---|
| project_path | string | yes | Existing authorized Shotcut .mlt or .xml project path, except when create_project creates it. |
| Name | Type | Req | Description |
|---|---|---|---|
| backup_count | integer | – | – |
| backups | array | – | Project-owned backups in newest-first order. |
| current_revision | string|null | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| expected_revision | string|null | – | – |
| project_path | string | – | – |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
No examples provided.
list_render_jobs List render history ~72
Use for 'the latest render', render history, or when job_id is unknown. Returns bounded newest-first durable summaries.
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | string | – | Opaque cursor returned by the preceding render-history page. |
| limit | integer | – | Maximum render summaries returned. |
| status | string | – | Optional render state filter. |
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | – | – |
| current_revision | string|null | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| expected_revision | string|null | – | – |
| jobs | array | – | Newest-first durable render summaries. |
| next_cursor | string|null | – | – |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
| status_filter | string|null | – | – |
No examples provided.
open_in_shotcut Open in Shotcut ~74
Use only when the user asks to open the GUI. Opens a project, media file, or folder in Shotcut; MCP edits do not require this.
| Name | Type | Req | Description |
|---|---|---|---|
| fullscreen | boolean | – | Ask Shotcut to open fullscreen. |
| path | string | yes | Existing authorized local project, media, folder, or backup path. |
| Name | Type | Req | Description |
|---|---|---|---|
| current_revision | string|null | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| expected_revision | string|null | – | – |
| opened | boolean | – | – |
| path | string | – | – |
| pid | integer | – | – |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
No examples provided.
plan_project_edit Plan project edit ~169
Use for a dry run, uncertain edit, or user review before committing. Applies operations in memory using stable item_ref selectors when supplied, validates with MLT, and returns a snapshot and diff without changing the project.
| Name | Type | Req | Description |
|---|---|---|---|
| expected_revision | string | yes | Required SHA-256 revision returned by inspect_project; force is not supported by plan_project_edit. |
| max_diff_lines | integer | – | Maximum unified-diff lines returned by a dry run; zero suppresses diff text. |
| operations | array | yes | One or more related edit operations. Query shotcut_capabilities for unfamiliar operation schemas. |
| project_path | string | yes | Existing authorized Shotcut .mlt or .xml project path, except when create_project creates it. |
| timeout_seconds | integer | – | Bounded timeout for local MLT processing. |
| Name | Type | Req | Description |
|---|---|---|---|
| base_revision | string | – | – |
| changed | boolean | – | – |
| current_revision | string|null | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| diff_lines | integer | – | – |
| diff_truncated | boolean | – | – |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| expected_revision | string|null | – | – |
| item_bindings | object | – | Batch aliases mapped to item_ref values for the resulting revision. |
| operation_results | array | – | Results in the same order as the requested operations. |
| planned | boolean | – | – |
| project | object | – | Project snapshot; inspect_project publishes its complete schema. |
| project_path | string | – | – |
| prospective_revision | string | – | – |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
| unified_diff | string | – | – |
| validation | object | – | Result of processing the project with local Melt. |
No examples provided.
probe_media Probe media ~55
Use to understand a source file before editing. Reads duration, codecs, resolution, frame rate, color, and audio with per-file caching.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | Existing authorized local project, media, folder, or backup path. |
| Name | Type | Req | Description |
|---|---|---|---|
| bit_rate | number|null | – | – |
| current_revision | string|null | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| duration_seconds | number|null | – | – |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| expected_revision | string|null | – | – |
| format | string|null | – | – |
| path | string | – | – |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
| size_bytes | integer | – | – |
| streams | array | – | Normalized audio, video, subtitle, and data streams. |
No examples provided.
render_contact_sheet Render a contact sheet ~186
Use for 'show me the edit', visual review, or a timeline overview. Renders exact frames or 12 evenly sampled frames into one image; omit output_path for managed output.
| Name | Type | Req | Description |
|---|---|---|---|
| cell_width | integer | – | Width of each contact-sheet cell in pixels. |
| columns | integer | – | Number of contact-sheet columns. |
| frames | array | – | Exact frames for the contact sheet. When present, sample_count is ignored. |
| output_path | string | – | Authorized destination path. Omit only for single-frame or contact-sheet previews to use bounded managed output. |
| overwrite | boolean | – | Replace an existing destination only when the user explicitly authorized it. |
| project_path | string | yes | Existing authorized Shotcut .mlt or .xml project path, except when create_project creates it. |
| sample_count | integer | – | Evenly sampled frame count used only when frames is omitted. |
| Name | Type | Req | Description |
|---|---|---|---|
| cells | array | – | Contact-sheet cells in display order. |
| columns | integer | – | – |
| created | boolean | – | – |
| current_revision | string|null | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| expected_revision | string|null | – | – |
| managed_output | boolean | – | – |
| path | string | – | – |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
| rows | integer | – | – |
| size_bytes | integer | – | – |
No examples provided.
render_preview Render preview frame ~121
Use to show or inspect one specific moment. Renders one PNG and returns its path; omit output_path for a bounded server-managed preview.
| Name | Type | Req | Description |
|---|---|---|---|
| frame | integer | – | Zero-based project frame to render. |
| output_path | string | – | Authorized destination path. Omit only for single-frame or contact-sheet previews to use bounded managed output. |
| overwrite | boolean | – | Replace an existing destination only when the user explicitly authorized it. |
| project_path | string | yes | Existing authorized Shotcut .mlt or .xml project path, except when create_project creates it. |
| Name | Type | Req | Description |
|---|---|---|---|
| created | boolean | – | – |
| current_revision | string|null | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| expected_revision | string|null | – | – |
| frame | integer | – | – |
| managed_output | boolean | – | – |
| path | string | – | – |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
| size_bytes | integer | – | – |
No examples provided.
render_preview_batch Render preview frames in batch ~102
Use when exact frames are needed as separate image files. Renders up to 64 requested frames; use render_contact_sheet for one overview image.
| Name | Type | Req | Description |
|---|---|---|---|
| overwrite | boolean | – | Replace an existing destination only when the user explicitly authorized it. |
| project_path | string | yes | Existing authorized Shotcut .mlt or .xml project path, except when create_project creates it. |
| requests | array | yes | Exact frame/output-path pairs; every output path must be unique. |
| Name | Type | Req | Description |
|---|---|---|---|
| created | integer | – | – |
| current_revision | string|null | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| expected_revision | string|null | – | – |
| partial_completion_possible | boolean | – | – |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
| requested | integer | – | – |
| results | array | – | Per-frame successes and bounded failures. |
No examples provided.
render_review_clip Render a short audiovisual review ~168
Use to review pacing, transitions, motion or sound. Renders at most 30 seconds to a managed H.264/AAC MP4 within 1280x720, preserving aspect ratio. This temporary review is separate from final export and replaces only the previous managed review for this project; surface the playable resource or path to the user.
| Name | Type | Req | Description |
|---|---|---|---|
| expected_revision | string | – | Optional inspected project revision; stale revisions are rejected before rendering. |
| in_frame | integer | yes | Inclusive first timeline frame of the review. |
| out_frame | integer | yes | Inclusive last timeline frame, at least in_frame and within the project. Selected duration must not exceed 30 seconds. |
| project_path | string | yes | Existing authorized Shotcut .mlt or .xml project path, except when create_project creates it. |
| Name | Type | Req | Description |
|---|---|---|---|
| created | boolean | – | – |
| current_revision | string|null | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| duration_frames | integer | – | – |
| duration_seconds | number | – | – |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| expected_revision | string|null | – | – |
| height | integer | – | – |
| in_frame | integer | – | – |
| managed_output | boolean | – | – |
| mime_type | string | – | – |
| out_frame | integer | – | – |
| path | string | – | – |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
| revision | string | – | – |
| size_bytes | integer | – | – |
| uri | string | – | – |
| width | integer | – | – |
No examples provided.
render_status Get render status ~84
Use when job_id is known; poll until a terminal state and surface meaningful status, progress, or ETA changes without narrating unchanged polls or raw logs. On completion, present both returned artifacts: rendered media and the exact editable project. Use list_render_jobs when the id is unknown.
| Name | Type | Req | Description |
|---|---|---|---|
| job_id | string | yes | Durable render identifier returned by start_render or list_render_jobs. |
| Name | Type | Req | Description |
|---|---|---|---|
| artifacts | array | – | Completed rendered media and exact editable project, otherwise empty. |
| current_revision | string|null | – | – |
| delivery_complete | boolean | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| editable_project_exists | boolean | – | – |
| editable_project_path | string|null | – | – |
| elapsed_seconds | number | – | – |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| eta_confidence | string|null | – | – |
| eta_seconds | number|null | – | – |
| expected_revision | string|null | – | – |
| frames_completed | integer|null | – | – |
| in_frame | integer|null | – | – |
| job_id | string | – | – |
| log_tail | string|null | – | – |
| out_frame | integer|null | – | – |
| output_exists | boolean | – | – |
| output_path | string | – | – |
| output_size_bytes | integer|null | – | – |
| progress_percent | number|null | – | – |
| project_path | string | – | – |
| range_duration_frames | integer|null | – | – |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
| rendered_project_revision | string|null | – | – |
| status | string | – | – |
No examples provided.
restore_project_backup Restore project backup ~152
Use after list_project_backups and authorization to restore the selected backup; an explicit request identifying that backup is sufficient. Validates and atomically restores it while backing up the current project; pass the current expected_revision unless force=true was explicitly authorized.
| Name | Type | Req | Description |
|---|---|---|---|
| backup_path | string | yes | Exact backup path returned by list_project_backups for this project. |
| expected_revision | string | – | SHA-256 revision returned by inspect_project. Required unless force=true was explicitly authorized. |
| force | boolean | – | Bypass revision protection only with explicit user authorization; never retry conflicts with force automatically. |
| project_path | string | yes | Existing authorized Shotcut .mlt or .xml project path, except when create_project creates it. |
| Name | Type | Req | Description |
|---|---|---|---|
| backup_path | string|null | – | – |
| current_revision | string|null | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| expected_revision | string|null | – | – |
| path | string | – | – |
| previous_revision | string|null | – | – |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
| restored | boolean | – | – |
| result_truncated | boolean | – | True means the project change committed but details were omitted to fit the MCP response budget. Do not retry the mutation; inspect the returned revision. |
| revision | string | – | – |
| validation | object | – | Result of processing the project with local Melt. |
No examples provided.
shotcut_capabilities Get editing capabilities ~63
Use before an unfamiliar edit. Omit operation for the catalog, presets, compatibility, and workflow; pass operation for only its complete schema, example, and transaction guarantees enforced by plan and edit.
| Name | Type | Req | Description |
|---|---|---|---|
| operation | string | – | Optional edit operation to describe in full. |
| Name | Type | Req | Description |
|---|---|---|---|
| compatibility | object | – | Legacy shotcut/mlt project baseline, serialization, and independently tested runtime combinations. |
| current_revision | string|null | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| expected_revision | string|null | – | – |
| feature_guidance | object | – | – |
| operation_query | string | – | – |
| operations | object | – | Edit operations keyed by op name. |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
| render_presets | object | – | – |
| transaction_guarantees | array | – | Safety and transaction guarantees that apply to edit operations. |
| workflow | array | – | Recommended end-to-end workflow. |
No examples provided.
shotcut_doctor Check Shotcut compatibility ~70
Use after installation, upgrade, or a setup failure. Distinguishes tested Shotcut/MLT combinations, untested-version warnings, and runtime failures. Checks repository startup, RNNoise, FFmpeg quality-analyzer availability, and path policy. An untested version alone does not block project operations.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| checks | object | – | – |
| compatible | boolean | – | True only for status=tested. False alone does not indicate a runtime failure; read status and issues. |
| current_revision | string|null | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| expected_revision | string|null | – | – |
| issues | array | – | Runtime errors take precedence over version warnings; empty when tested checks pass. |
| path_policy | object | – | Effective server path and resource policy. |
| quality_analyzers | object | – | – |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
| runtime_ready | boolean | – | Executable version queries, MLT repository and RNNoise checks passed, independently of version coverage; does not guarantee project readiness. |
| serialization | object | – | An exact Shotcut and MLT version pair. |
| status | string | – | Tested pair with passing checks, untested pair with passing checks, or concrete runtime check failure. |
| tested_stacks | array | – | Exact runtime pairs covered by Windows / Python 3.10 integration tests; other pairs are untested. |
| validated_stack | object | – | Legacy project baseline retained for clients; use tested_stacks for runtime coverage. |
No examples provided.
shotcut_status Check Shotcut status ~43
Use for a quick readiness check. Locates Shotcut, Melt, FFprobe, and FFmpeg and reports their versions; use shotcut_doctor for compatibility diagnosis.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| current_revision | string|null | – | – |
| details | object | – | Bounded structured context specific to the error code. |
| environment_overrides | object | – | – |
| error | string | – | Human-readable failure summary. |
| error_code | string | – | Stable machine-readable Shotcut MCP error code. |
| error_type | string | – | Stable Python exception family retained for compatibility. |
| expected_revision | string|null | – | – |
| ffmpeg | object | – | Executable discovery and version result. |
| ffprobe | object | – | Executable discovery and version result. |
| melt | object | – | Melt discovery, version, and repository readiness. |
| path_policy | object | – | Effective server path and resource policy. |
| ready | boolean | – | – |
| recommended_action | string | – | Machine-readable next action for the caller. |
| recommended_tool | string|null | – | MCP tool to call next when one action is preferred. |
| recoverable | boolean | – | Whether the caller can take a safe corrective action. |
| shotcut | object | – | Executable discovery and version result. |
No examples provided.
How do I install the Shotcut MCP server?
Shotcut MCP ships as an MCPB bundle, a single file you download and open in an MCP host that supports MCPB bundles, such as Claude Desktop. The host reads the launch command from the bundle's own manifest, so there is no command to copy. Before opening it, check the file's SHA-256 matches the one the MCP registry declares for it, 0f2194bbe39950e703b3b2c6253bfd71ef19dce1f3303e680f1c7853799cefba; the commands to do that are on this page. If it does not match, do not open it.
mcpb · shotcut-mcp-1.6.0.mcpb
Download bundleCheck the download matches the SHA-256 the MCP registry declares before you open it. If it does not match, do not open the file.
SHA-256
0f2194bbe39950e703b3b2c6253bfd71ef19dce1f3303e680f1c7853799cefba
macOS / Linux
echo "0f2194bbe39950e703b3b2c6253bfd71ef19dce1f3303e680f1c7853799cefba shotcut-mcp-1.6.0.mcpb" | shasum -a 256 -c
Windows (PowerShell)
(Get-FileHash -Algorithm SHA256 .\shotcut-mcp-1.6.0.mcpb).Hash -eq "0f2194bbe39950e703b3b2c6253bfd71ef19dce1f3303e680f1c7853799cefba"
Run it in the folder you saved the bundle to, then open the file with an MCPB-capable host such as Claude Desktop.
What is the Shotcut MCP server?
Shotcut MCP is listed in the public MCP registry as io.github.matrodrigs/shotcut-mcp. Create, edit, validate, preview, and render Shotcut projects through AI clients. This page covers its MCPB bundle (https://github.com/matrodrigs/shotcut-mcp/releases/download/v1.6.0/shotcut-mcp-1.6.0.mcpb).
Is the Shotcut MCP server safe to use?
Shotcut MCP scores 54 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Shotcut MCP server expose?
Shotcut MCP exposes 28 tools: shotcut_status, shotcut_doctor, shotcut_capabilities, discover_media, probe_media, and 23 more. Their descriptions and schemas cost roughly 3,785 tokens of context every time the server is loaded.
What licence is the Shotcut MCP server under?
Shotcut MCP declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.