Get current DaVinci Resolve status including version, current project, timeline, and page.

Returns JSON with product name, version, current page, project name, timeline name, and connection state.

Switch DaVinci Resolve to a specific page.

Args: page: Page name — "media", "cut", "edit", "fusion", "color", "fairlight", or "deliver"

Get the currently active DaVinci Resolve page.

Returns the page name: media, cut, edit, fusion, color, fairlight, or deliver.

Force reconnection to DaVinci Resolve. Use if Resolve was restarted.

List all projects in the current database folder.

Returns a JSON array of project names.

Open a project by name.

Args: name: Project name to load.

Save the current project.

Create a new project.

Args: name: Name for the new project.

Get all settings for the current project.

Returns JSON with frame rate, resolution, color science, and other project settings.

Set a project setting.

Args: setting: Setting name (e.g., "timelineFrameRate", "timelineResolutionWidth"). value: Value to set.

List all timelines in the current project.

Returns JSON array with each timeline's name, index, duration, and track counts.

Get detailed info about the current timeline.

Returns JSON with name, timecode, track counts, and start/end frames.

Switch to a different timeline by name or index.

Args: name: Timeline name to switch to (preferred). index: Timeline index (1-based). Used if name is empty.

Get the current playhead timecode position.

Set the playhead to a specific timecode.

Args: timecode: Timecode string (e.g., "01:00:05:00").

List all clips on a specific track.

Args: track_type: "video", "audio", or "subtitle" (default: "video"). track_index: Track number, 1-based (default: 1).

Returns JSON array of clips with name, start/end frame, duration, and source info.

Create a new empty timeline.

Args: name: Name for the new timeline.

Duplicate the current timeline.

Args: new_name: Name for the duplicate (optional, defaults to original + " Copy").

List clips in the media pool. Shows the current bin by default.

Args: folder_path: Optional subfolder name to navigate to (e.g., "B-Roll"). Leave empty for current folder.

Returns JSON with folder name, clips (with metadata), and subfolders.

Import media files into the current media pool bin.

Args: file_paths: List of absolute file paths to import (e.g., ["/Users/guy/video.mov"]).

Returns names of successfully imported clips.

Create a new bin (subfolder) in the media pool.

Args: name: Name for the new bin.

Add a clip from the media pool to the current timeline.

Args: clip_name: Name of the clip in the media pool. track_index: Target video track (1-based, default: 1). media_type: 0 = video+audio (default), 1 = video only, 2 = audio only. Use 1 for b-roll to preserve interview audio.

Get detailed properties of a media pool clip.

Args: clip_name: Name of the clip in the media pool.

Returns JSON with all clip properties (duration, resolution, codec, fps, etc.).

Set pan/tilt, zoom (0–100), rotation (-360–360), opacity (0–100). Targets playhead, or explicit 1-based video track/clip indices. Validates before writing. Returns JSON including original values and any partial failure.

Read clip transform values at the playhead or explicit 1-based video track/clip indices.

Legacy speed-property request. Resolve may reject it; timeline retiming is not guaranteed by the API. This acts on the underlying media-pool property, potentially affecting other uses of the media.

Enable/disable a clip at playhead or explicit 1-based video track/clip indices.

Create a compound clip from a 1-based video-track range. Creates a recovery timeline first.

Delete exactly one clip; defaults to non-ripple. Linked peers remain. Creates a recovery copy.

Replace at the original record position without ripple. Video-only preserves linked audio. Indices are 1-based. media_type 1 targets video; 2 targets audio. Combined replacement is rejected. source_end_frame is EXCLUSIVE; zero auto-matches source_start_frame + original duration. Source FPS must match timeline. Native source-out readbacks are reported separately. Validates bounds/locks/ambiguity and creates a recovery timeline before mutation. dry_run returns the plan without edits; new_media_id disambiguates duplicate names.

Apply a LUT to a clip's node graph. Targets the clip at the playhead.

Must be on the Color page. Common built-in LUTs:

• "Film Looks/Rec709 Kodak 2383 D65.cube"

• "Film Looks/Rec709 Fujifilm 3513DI D65.cube"

Args: lut_path: LUT file path (relative to Resolve's LUT directory or absolute). node_index: Node to apply LUT to (1-based, default: 1).

Get the LUT currently applied to a node on the clip at the playhead.

Args: node_index: Node index (1-based, default: 1).

Create a new color version on the clip at the playhead.

Args: name: Name for the color version. version_type: 0 = local (default), 1 = remote.

Switch to a color version by name on the clip at the playhead.

Args: name: Color version name. version_type: 0 = local (default), 1 = remote.

List all color versions on the clip at the playhead.

Args: version_type: 0 = local versions (default), 1 = remote versions.

Returns JSON with version names and current version.

Export a LUT from the current clip's grade.

Args: output_path: Absolute path for the output .cube file. export_type: "17pt", "33pt" (default), or "65pt".

Add timeline marker. Legacy frame=0 selects playhead; other values are timeline-relative. Use create_chapter_markers to explicitly address frame zero.

Read timeline markers keyed by timeline-relative frame.

Delete markers by explicit color, All, or exact timeline-relative frame (including zero). No arguments make no changes. Returns the removed marker records for restoration.

Insert Text+ at playhead. Validates size/position and reports partial failures after creation.

Modify Text+ on the playhead clip or explicit 1-based video track/clip indices.

List all available render presets (both standard and Quick Export).

Returns JSON with standard render presets and Quick Export presets.

Render the current timeline using a Quick Export preset.

Common presets: "H.264 Master", "H.265 Master", "ProRes 422 HQ", "YouTube", "Vimeo", "TikTok", "Twitter".

Args: preset: Quick Export preset name. output_dir: Output directory (optional, uses project default if empty). filename: Custom filename (optional, uses timeline name if empty).

Add a custom render job to the render queue.

Args: output_dir: Output directory path. filename: Custom filename (optional). format: Video format (e.g., "mov", "mp4"). Leave empty for project default. codec: Codec name (e.g., "ProRes422", "H264"). Leave empty for project default. width: Output width. 0 = use project setting. height: Output height. 0 = use project setting. frame_rate: Output FPS. 0 = use project setting.

Start rendering all queued render jobs.

Get the status of all render jobs.

Returns JSON with each job's status, progress percentage, and completion state.

Export the current timeline to an interchange format.

Args: output_path: Absolute path for the output file. format: Export format — "fcpxml" (default), "edl", "csv", "aaf", "otio".

List Fusion compositions on a timeline clip. Targets clip at playhead by default.

Args: track_index: Video track (1-based). 0 = use playhead. clip_index: Clip position on track (1-based). 0 = use playhead.

Returns JSON with comp names and count.

Add a new Fusion composition to the clip at the playhead.

List all tools in a Fusion composition on the clip at the playhead.

Args: comp_index: Fusion comp index (1-based, default: 1).

Returns JSON array of tools with their type and name.

Send the current frame to Moondream for a caption. detail: short or normal.

Send the current frame to Moondream to detect described objects and return bounding boxes.

Send the current frame to Moondream for visual question answering.

Look for objects such as an airplane in timeline shots using Moondream. Sends ONE midpoint timeline frame per clip (up to 50) to the cloud; may miss objects elsewhere. Analyzes the visible composite, including overlays/upper tracks. Temporarily moves playhead/page. Reports sampled clip indices, matches and restoration status; not exhaustive source-media search.

Transcribe one exact clip, or a folder AND nested folders when clip_name is empty. folder_path is an exact resource path; empty uses current bin. Requires Resolve 21. Returns operation status, not a transcript; speaker detection is optional.

Delete transcription for one clip, or the current/specified folder AND nested folders.

Classify audio for one clip, or the current/specified folder AND nested folders.

Remove audio classification for one clip, or the current/specified folder AND nested folders.

Analyze a clip or folder for IntelliSearch. Needs Faster/Better Extras. Face identification is opt-in. This starts native analysis; it does not query a search index.

Clear IntelliSearch analysis for the ENTIRE current project (Resolve API scope).

Run native Slate ID analysis on a clip or folder and add slate markers. Requires AI Slate ID Extras.

Create new deblurred media from ONE uniquely named clip; does not replace timeline clips. filename names the native output. Format/codec availability depends on this workstation.

Generate a speech clip into the media pool, leaving the timeline untouched. Requires AI Speech Generator Extras. Text is limited to 350 characters.

Disable ALL Resolve background tasks for this application session. The API has no corresponding enable call; restart Resolve to reset this setting.

Find shots by case-insensitive name and/or metadata substrings across all bins. Returns exact names, media IDs and folder paths for unambiguous editing. Not visual search.

Find clips by name and/or position. timecode is absolute HH:MM:SS:FF; seconds is elapsed since timeline start (13:22 = 802 seconds). End frame is exclusive. track_index 0 searches all tracks of the selected type.

Insert video-only B-roll into an EMPTY interval on an existing video track. Absolute record frame; defaults to dry-run. Rejects overlap, locked tracks and FPS mismatch. Creates a recovery copy before an actual insertion.

Assemble complete media clips in supplied order into a NEW timeline. Rejects ambiguous media and existing timeline names. Defaults to planning only. This is an ordered assembly; it does not infer cuts from a transcript.

Add a marker at the exact current playhead, including drop-frame timecode support.

Create markers from supplied chapter/speaker boundaries. Each entry: {frame: timeline-relative integer, name: string, note: optional string}. Validates the complete batch before writing. Does not extract transcripts or infer speaker times.

Render locally with an installed Quick Export preset; explicitly disables uploading to YouTube. Requires an existing absolute output directory and a filename. Returns Resolve's actual status.

Auto-caption the CURRENT timeline with Resolve's speech recognition (Studio, adds a subtitle track). Clips and audio are not changed. The native true/false result is unreliable, so success means a new subtitle track or new cues were read back. Then use resolve_get_transcript(source="captions"). language: auto, english, spanish, ...; preset: default, netflix, teletext; chars_per_line 0 = preset default.

Read transcript TEXT with timing. source="captions": cues from the current timeline's subtitle track(s) (0 = all); seconds are timeline-relative, frames absolute. Works on any Resolve 21 Studio after resolve_create_captions. source="clip": a media pool clip's full native transcript (Resolve 21.1+) with speakers and word times, in seconds from the clip's start; run resolve_transcribe_audio first. format json|srt|vtt|text. output_path (absolute, new file) writes SRT/VTT/text to disk.

Find dead air on the current timeline with ffmpeg (read-only; needs ffmpeg). detect_on="carried" reports only time when EVERY enabled audio track is quiet (safe for multi-mic podcasts); "spine" analyzes just the spine track. threshold_db 0 = calibrate per clip. Returns timeline-relative seconds (the same scale as resolve_get_transcript captions).

Remove dead air from a talking-head/podcast timeline into a NEW timeline (dry-run by default). A pause is cut only where every enabled mic track is quiet for longer than min_silence_seconds; keep_pause_seconds of room stays at each side. All tracks are cut together, so cameras and mics stay in sync; timeline markers in kept time move with the edit. Needs ffmpeg. tracks="all" (default) carries every video/audio track, keeping mics and cameras in sync; tracks="spine" carries only the spine track (A1 by default).

Text-based / manual editing: cut the listed ranges from ALL carried tracks into a NEW timeline (dry-run by default). remove: [{start_seconds, end_seconds}] in timeline-relative seconds, e.g. caption cues from resolve_get_transcript(source="captions") for filler words, false starts or off-topic passages. Ranges may overlap; the original timeline is not changed. tracks="all" (default) carries every video/audio track, keeping mics and cameras in sync; tracks="spine" carries only the spine track (A1 by default).

Wait until a render job (or all rendering, if job_id is empty) finishes, then report the final status and output file. Other MCP calls wait while this runs, so keep timeouts modest (max 3600 s). stop_on_timeout=True calls StopRendering if the deadline passes.