Add Adjustment Layer

Add an adjustment layer to the active sequence via QE DOM. The layer is added at the playhead position on the specified track.

Video track index (default: 0)

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Add Adjustment Layer

Add Audio Keyframes

Add audio level keyframes to create fades or level changes

Array of keyframe objects with time_seconds and level_db

Audio level in dB

Time in seconds relative to clip start

Node ID of the clip

Failure detail when ok is false.

The registered MCP tool name.

Add Audio Keyframes

Add Custom Metadata Field

Add a custom metadata field to the project's metadata schema. This creates a schema/column definition only; it does not set a per-item value. Use set_metadata with complete Project Metadata XML and readback to update a value.

Display label for the field

Internal name for the metadata field

Type of the field: 0 = Integer, 1 = Real, 2 = String, 3 = Boolean

Failure detail when ok is false.

The registered MCP tool name.

Add Custom Metadata Field

Add Keyframe

Add and read back a keyframe on an effect property. This verifies stored parameter data only; render/playback verification remains host-dependent.

Display name of the effect

Node ID of the clip

Display name of the property

Time in seconds relative to clip start where to add keyframe

Value at the keyframe

Failure detail when ok is false.

The registered MCP tool name.

Add Keyframe

Add Marker

Add a marker to the active sequence or a clip

Marker color index (0=Green, 1=Red, 2=Purple, 3=Orange, 4=Yellow, 5=White, 6=Blue, 7=Cyan)

Comments for the marker

Duration of the marker in seconds (0 for point marker)

Name/label for the marker

Optional clip node ID to add marker to clip instead of sequence

Time position in seconds for the marker

Failure detail when ok is false.

The registered MCP tool name.

Add Marker

Add Marker To Project Item

Add a marker to a project item (source clip marker).

Color label index (0-7)

Marker comments

Node ID or name of the project item

Marker name

Time in seconds for the marker

Marker type (default: Comment)

Failure detail when ok is false.

The registered MCP tool name.

Add Marker To Project Item

Add Text Overlay

Unavailable: Premiere does not expose a supported scripting API to create caption clips directly from raw text. Import an .srt/.vtt and use create_caption_track, or use a MOGRT/PNG overlay for title graphics.

Caption format (default: subtitle)

Duration in seconds (default: 5)

Start time in seconds (default: 0)

Text content to display

Failure detail when ok is false.

The registered MCP tool name.

Add Text Overlay

Add To Render Queue

Request an Adobe Media Encoder render-queue handoff for the active sequence. Verify queue presence or the output file independently.

Full output file path

Path to an AME preset file (.epr)

Failure detail when ok is false.

The registered MCP tool name.

Add To Render Queue

Add To Timeline

Insert a project item at a timeline position and verify Premiere added no unexpected same-track fragments.

Audio track index for the audio portion (default: 0)

Node ID or name of the project item to add

Start time in seconds on the timeline (default: 0)

Video track index (0-based, default: 0)

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Add To Timeline

Add To Timeline Batch

Insert up to 32 project items in one validated CEP request. All items and target tracks are preflighted before the first insertion; every requested placement is read back, and the tool fails closed if Premiere cannot verify one.

Ordered placements. They use the same insert-edit semantics as add_to_timeline; later placements must not share a target video-track start time.

Audio target for linked source audio (defaults to 0).

Project item node ID or unique name.

Timeline insertion time in seconds (defaults to 0).

Video track index (defaults to 0).

Failure detail when ok is false.

The registered MCP tool name.

Add To Timeline Batch

Add Track

Add verified video or audio tracks to the active sequence. Returns an error if Premiere cannot add the exact requested count.

Number of tracks to add (default: 1)

Type of track to add

Failure detail when ok is false.

The registered MCP tool name.

Add Track

Add Tracks

Add video and/or audio tracks through QE and verify the active sequence gained the exact requested counts

Number of 5.1 audio tracks to add (default: 0)

Number of mono audio tracks to add (default: 0)

Number of standard stereo audio tracks to add (default: 0)

Number of video tracks to add (default: 0)

Failure detail when ok is false.

The registered MCP tool name.

Add Tracks

Add Transition

Add a video transition between two clips at a cut point. Uses QE DOM.

Time position in seconds of the cut point where the transition should be placed

Duration of the transition in seconds (default: 1.0)

Video track index (0-based)

Name of the transition (e.g., 'Cross Dissolve', 'Dip to Black')

Failure detail when ok is false.

The registered MCP tool name.

Add Transition

Add Transition To Clip

Add a transition to a specific clip's start or end

Node ID of the clip

Where to apply the transition (default: end)

Name of the transition

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Add Transition To Clip

Adjust Audio Levels

Adjust a clip's Volume > Level in dB. Does not read or change Essential Sound Amplify automation.

Audio level in dB (0 = unity, negative = quieter, positive = louder)

Node ID of the audio or video clip

Failure detail when ok is false.

The registered MCP tool name.

Adjust Audio Levels

Analyze Loudness

Measure integrated loudness (LUFS), loudness range (LU), and true peak (dBFS) from a local media file using FFmpeg's EBU R128 filter. Analysis only: it does not normalize audio or change Premiere.

Optional maximum acceptable true peak in dBFS (commonly -1 or -2)

Absolute path to a local audio or video file. Provide this or project_item_id.

Project item whose local media path should be resolved through Premiere. Provide this or media_path.

Optional delivery target in LUFS (for example -14 streaming, -16 podcast, or -23 broadcast)

Allowed absolute difference from target_lufs (default: 1 LU)

Failure detail when ok is false.

The registered MCP tool name.

Analyze Loudness

Analyze Video Interlacing

Classify decoded video frames as progressive, top-field-first, bottom-field-first, mixed, or undetermined using FFmpeg idet. Read-only delivery preflight.

Existing local video file

Decode sample duration from 1 through 300 seconds (default: 30)

Failure detail when ok is false.

The registered MCP tool name.

Analyze Video Interlacing

Analyze Video Qc

Analyze a local video delivery for sustained black and frozen sections with FFmpeg. Read-only: it does not contact Premiere or modify the file.

Path to an existing local video file

Minimum black duration to report (default: 0.5)

Minimum frozen duration to report (default: 1)

Failure detail when ok is false.

The registered MCP tool name.

Analyze Video Qc

Apply Audio Effect

Apply an audio effect to a clip. Uses QE catalog lookup, with an exact-name QE probe when enumeration is empty.

Name of the audio effect

Node ID of the clip

Failure detail when ok is false.

The registered MCP tool name.

Apply Audio Effect

Apply Edit Plan

Apply a previously previewed compound edit after revalidating every target. Requires the edit capability and exact preview confirmation token.

Exact token returned by preview_edit_plan

An edit plan containing insert_clip and remove_clip operations (maximum 100)

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Apply Edit Plan

Apply Effect

Apply a video effect to a clip. Uses QE DOM catalog lookup, with an exact-name QE probe when Premiere's catalog enumeration is empty.

Name of the effect (e.g., 'Gaussian Blur', 'Lumetri Color')

Node ID of the clip to apply the effect to

Failure detail when ok is false.

The registered MCP tool name.

Apply Effect

Apply Lut

Apply a LUT file to a clip via Lumetri Color

Full path to the .cube or .3dl LUT file

Node ID of the clip

Failure detail when ok is false.

The registered MCP tool name.

Apply Lut

Apply Spot Workflow Plan

Apply one exact previewed motion-demo, product-spot, or brand-spot plan. Requires edit authority, requires filesystem authority for a MOGRT, and only targets empty explicitly named tracks. Host readback is not playback or render verification.

Exact token returned by the corresponding preview tool.

Exact plan returned by a preview_*_spot tool

Failure detail when ok is false.

The registered MCP tool name.

Apply Spot Workflow Plan

Attach Custom Property

Attach a custom property (key/value pair) to the active sequence

Unique identifier for the custom property

Value for the custom property

Failure detail when ok is false.

The registered MCP tool name.

Attach Custom Property

Auto Reframe Sequence

Auto-reframe a sequence for a different aspect ratio

Premiere Auto Reframe motion preset (default: default)

Name for the newly created auto-reframed sequence

Sequence name or ID to reframe. Uses active sequence if omitted.

Target frame height in pixels

Target frame width in pixels

Whether Auto Reframe should honor nested sequences (default: false)

Failure detail when ok is false.

The registered MCP tool name.

Auto Reframe Sequence

Batch Add Transitions

Add the same transition to all cut points on a track

Duration of each transition in seconds (default: 1.0)

Video track index (0-based, default: 0)

Name of the transition (e.g., 'Cross Dissolve')

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Batch Add Transitions

Batch Apply Effect

Apply one audio or video effect to compatible selected clips, a compatible track, or all compatible clips. Every target is preflighted and then checked by component-count readback.

Display name of the effect to apply (e.g., 'Gaussian Blur', 'Lumetri Color')

Which clips to apply to: selected clips, all on a track, or all in sequence

Track index (required when target is 'track')

Track type (required when target is 'track')

Failure detail when ok is false.

The registered MCP tool name.

Batch Apply Effect

Batch Enable Disable

Enable or disable multiple clips at once (selected, track, or all).

true to enable, false to disable

Which clips to affect

Failure detail when ok is false.

The registered MCP tool name.

Batch Enable Disable

Batch Rename Clips

Rename multiple clips on the timeline using a pattern. Supports sequential numbering.

Name pattern. Use {n} for a sequential number, ## for a zero-padded two-digit sequence number, and {name} for the original name (e.g., 'Scene_##', '{name}_v2')

Only rename selected clips (default: false, renames all on track)

Starting number for {n} placeholder (default: 1)

Track index (0-based)

Track type to rename clips on

Failure detail when ok is false.

The registered MCP tool name.

Batch Rename Clips

Capture Frame

Capture the current frame and return it as inline image data for the LLM to see. This lets the AI visually inspect the current state of the timeline.

Time position in seconds to capture. Uses current playhead if omitted.

Failure detail when ok is false.

The registered MCP tool name.

Capture Frame

Check Offline Media

Check for offline (missing) media in the project

Failure detail when ok is false.

The registered MCP tool name.

Check Offline Media

Clear Item In Out

Clear in and/or out points on a project item (reset to full duration).

Clear the in point (default: true)

Clear the out point (default: true)

Node ID or name of the project item

Failure detail when ok is false.

The registered MCP tool name.

Clear Item In Out

Clear Sequence In Out

Clear the in and/or out points on the active sequence.

Clear in point (default: true)

Clear out point (default: true)

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Clear Sequence In Out

Close All Source Clips

Close all clips in the Source Monitor.

Failure detail when ok is false.

The registered MCP tool name.

Close All Source Clips

Close Project

Close the current Premiere Pro project

Whether to save before closing (default: true)

Failure detail when ok is false.

The registered MCP tool name.

Close Project

Close Sequence

Close a sequence tab in the timeline

Sequence name or ID. Uses active sequence if omitted.

Failure detail when ok is false.

The registered MCP tool name.

Close Sequence

Close Source Monitor

Close the clip currently open in the Source Monitor.

Failure detail when ok is false.

The registered MCP tool name.

Close Source Monitor

Color Correct

Apply basic color correction to a clip using Lumetri Color

Blacks adjustment (-100 to 100)

Contrast adjustment (-100 to 100)

Exposure adjustment (-4.0 to 4.0)

Highlights adjustment (-100 to 100)

Node ID of the clip

Saturation (0-200, 100 = normal)

Shadows adjustment (-100 to 100)

Color temperature adjustment

Tint adjustment

Whites adjustment (-100 to 100)

Failure detail when ok is false.

The registered MCP tool name.

Color Correct

Compare Cmx3600 Edls

Compare two local CMX 3600 EDLs by event number and report bounded added, removed, and changed editorial events. Read-only; it does not alter either interchange file or Premiere.

Existing revised .edl file

Existing baseline .edl file

Failure detail when ok is false.

The registered MCP tool name.

Compare Cmx3600 Edls

Consolidate And Transfer

Consolidate, copy, or transcode project media using the Project Manager. Reports success only after a new destination folder contains a copied Premiere project.

Convert After Effects compositions (default: false)

Convert image sequences to clips (default: false)

Convert synthetic importer items (default: false)

Copy media to a new location (default: true)

Destination folder path for the consolidated project

Exclude unused clips (default: true)

Include all sequences (default: true). If false, only active sequence is used.

Include preview/render files (default: false)

Rename media to match clip names (default: false)

Transcode media during copy (default: false)

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Consolidate And Transfer

Consolidate Duplicates

Consolidate duplicate project items and report success only when duplicate media groups decrease.

Failure detail when ok is false.

The registered MCP tool name.

Consolidate Duplicates

Copy Effect Values

Copy verified scalar effect-property values from one effect to the matching effect on another clip. Both clips must already have the same effect applied. Legacy CEP deliberately refuses Blend Mode because Premiere can corrupt its enum value on cross-clip writes.

Display name of the effect to copy values for

Node ID of the source clip

Node ID of the target clip

Failure detail when ok is false.

The registered MCP tool name.

Copy Effect Values

Copy Effects Between Clips

Copy all effects (or a specific effect) from one clip to another. Does not copy intrinsic properties like Motion/Opacity unless specified.

Specific effect display name to copy (copies all non-intrinsic effects if omitted)

Node ID of the source clip to copy effects from

Node ID of the target clip to paste effects to

Failure detail when ok is false.

The registered MCP tool name.

Copy Effects Between Clips

Create Bars And Tone

Create a Bars and Tone synthetic media item in the project (useful for leader/calibration)

Audio sample rate in Hz (default: 48000)

Frame height in pixels (default: 1080)

Name for the bars and tone item (default: 'Bars and Tone')

Pixel aspect ratio denominator (default: 1)

Pixel aspect ratio numerator (default: 1)

Timebase as ticks-per-second string (default uses sequence timebase)

Frame width in pixels (default: 1920)

Failure detail when ok is false.

The registered MCP tool name.

Create Bars And Tone

Create Bin

Create a new bin (folder) in the project panel

Name of the new bin

Optional parent bin name or node ID. Creates in root if omitted.

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Create Bin

Create Caption Track

Create a caption/subtitle track in the active sequence from an imported caption file (e.g., .srt, .vtt). Reports structural success only when the host exposes a caption-track readback; otherwise reports an unverified accepted request.

Caption format: 'subtitle' (default), '608', '708', 'teletext', 'ebu', 'op42', 'op47'

Node ID or name of the imported caption project item (e.g., an .srt file)

Offset in seconds from the start of the sequence (default: 0)

Failure detail when ok is false.

The registered MCP tool name.

Create Caption Track

Create Context Edit Plan

Create a non-mutating, evidence-backed edit-plan scaffold from indexed Premiere context. It returns ranked source/time candidates and stale-state guards; the model must review them and use preview_edit_plan before any mutation.

Editing goal, such as finding the strongest budget explanation for a rough cut

Maximum 25; default 8

Project context ID returned by manage_project_context capture

Optional exact sequence ID filter

Planning mode; default rough_cut

Failure detail when ok is false.

The registered MCP tool name.

Create Context Edit Plan

Create Editorial Context Pack

Create a compact Markdown reading view from already captured local transcript, shot, audio, note, source, or timeline context. It returns stable evidence IDs and context revisions for review, never calls an AI/provider or Premiere, and cannot change the project.

The editorial question used to retrieve and compact local evidence.

Optional context-kind filter. Omit to retrieve all matching local evidence.

project sequence source timeline transcript shot audio note

Strict maximum length of the Markdown reading view.

Maximum matching evidence entries to include.

Project context ID returned by manage_project_context capture.

Optional exact sequence ID filter.

Failure detail when ok is false.

The registered MCP tool name.

Create Editorial Context Pack

Create Editorial Plan

Create a local, evidence-backed editorial workflow plan from captured project context. It never calls an LLM, uploads media, or changes Premiere.

The editorial goal used to retrieve relevant local evidence.

Maximum evidence candidates to include; defaults to 8.

Required only for organize. Rules are supplied by the editor or MCP client; the server does not infer categories from filenames alone.

Required only for platform_cutdown. These are proposed derivative sequence dimensions; this tool does not create or reframe a sequence.

Optional exact sequence ID filter for evidence retrieval.

The workflow to plan. Every workflow remains review-only.

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Create Editorial Plan

Create Project

Create a new Premiere Pro project at the specified path

Full file path for the new .prproj file

Failure detail when ok is false.

The registered MCP tool name.

Create Project

Create Project Backup

Create a collision-safe, byte-verified backup beside an existing .prproj file without opening or modifying the source project.

Absolute or working-directory-relative path to an existing .prproj file

Failure detail when ok is false.

The registered MCP tool name.

Create Project Backup

Create Sequence

Create a new sequence in the project

Name for the new sequence

Optional path to a sequence preset file (.sqpreset). If omitted, a default preset is discovered from the Premiere installation (override with PREMIERE_DEFAULT_SEQUENCE_PRESET).

Failure detail when ok is false.

The registered MCP tool name.

Create Sequence

Create Sequence From Clips

Create a new sequence by automatically placing project items in order

Array of project item names or node IDs to include in order

Name for the new sequence

Failure detail when ok is false.

The registered MCP tool name.

Create Sequence From Clips

Create Sequence From Preset

Create a new sequence from a specific preset file (.sqpreset)

Name for the new sequence

Full path to the .sqpreset file

Failure detail when ok is false.

The registered MCP tool name.

Create Sequence From Preset

Create Smart Bin

Create a smart bin (search bin) in the project panel

Name for the smart bin

Search query for the smart bin

Failure detail when ok is false.

The registered MCP tool name.

Create Smart Bin

Create Subclip

Create a subclip from a project item with in/out points

In-point in seconds

Node ID or name of the source project item

Name for the subclip

Out-point in seconds

Failure detail when ok is false.

The registered MCP tool name.

Create Subclip

Create Subsequence

Create a separate subsequence from selected clips or a time range. This Premiere API does not replace the original timeline clips with a nested-sequence reference.

Whether to ignore track targeting (default: false)

Failure detail when ok is false.

The registered MCP tool name.

Create Subsequence

Crop Clip

Apply or update Premiere's Crop effect on one video clip and read back every requested value. Adding Crop uses the legacy QE catalog only when the clip does not already contain it.

Percent cropped from the bottom edge.

Crop edge feather percentage.

Percent cropped from the left edge.

Timeline video-clip node ID.

Percent cropped from the right edge.

Percent cropped from the top edge.

Whether Crop should scale the remaining image to fill the frame.

Failure detail when ok is false.

The registered MCP tool name.

Crop Clip

Delete Bin

Delete a bin (folder) from the project panel

Name or node ID of the bin to delete

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Delete Bin

Delete Marker

Delete a marker at a specific time position

Optional clip node ID (deletes from sequence if omitted)

Time position of the marker to delete

Failure detail when ok is false.

The registered MCP tool name.

Delete Marker

Delete Multiple Project Items

Delete multiple project items at once from the project panel.

Array of node IDs or names of items to delete

Failure detail when ok is false.

The registered MCP tool name.

Delete Multiple Project Items

Delete Preview Files

Delete all preview/render cache files for the project. Uses QE DOM.

Type of preview files to delete: 'video', 'audio', or 'all' (default: 'all')

Failure detail when ok is false.

The registered MCP tool name.

Delete Preview Files

Delete Project Item

Delete a project item (clip, bin, etc.) from the project panel. This removes it from the project but does not affect timeline instances.

Node ID or name of the project item to delete

Failure detail when ok is false.

The registered MCP tool name.

Delete Project Item

Delete Sequence

Delete a sequence from the project

Sequence name or ID to delete

Failure detail when ok is false.

The registered MCP tool name.

Delete Sequence

Delete Track

Delete a video or audio track from the active sequence

Index of the track to delete (0-based)

Type of track to delete

Failure detail when ok is false.

The registered MCP tool name.

Delete Track

Deselect All Clips

Deselect all clips in the active sequence.

Failure detail when ok is false.

The registered MCP tool name.

Deselect All Clips

Detach Proxy

Detach/remove the proxy from a project item

Node ID or name of the project item

Failure detail when ok is false.

The registered MCP tool name.

Detach Proxy

Detect Active Picture Bounds

Detect the most frequent active-picture crop rectangle in decoded video, exposing probable letterbox or pillarbox bars without modifying the source.

Cropdetect black threshold from 0 through 255 (default: 24)

Existing local video file

Decode sample duration from 1 through 300 seconds (default: 30)

Failure detail when ok is false.

The registered MCP tool name.

Detect Active Picture Bounds

Detect Audio Transients

Find probable beat or edit-point transients from decoded audio peaks. Returns candidates for editorial review; it does not claim musical beat-grid accuracy or change a timeline.

Maximum returned candidates from 1 through 1000 (default: 200)

Existing local audio or video file

Minimum spacing from 0.05 through 10 seconds (default: 0.25)

Minimum transient peak from -60 through 0 dBFS (default: -12)

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Detect Audio Transients

Detect Beats

Estimate a steady beat grid from a local audio or video file without changing Premiere. FFmpeg decodes at most 30 minutes to a bounded mono analysis stream; local onset autocorrelation returns BPM, phase-aligned beat times, confidence, and half/double-time alternatives.

Maximum beat times returned (default: 500).

Absolute path to an existing local audio or video file.

Failure detail when ok is false.

The registered MCP tool name.

Detect Beats

Detect Motion Peaks

Find probable high-motion moments in a bounded local video sample from decoded frame differences. Read-only editorial candidates; camera movement, flashes, cuts, and subject motion are not semantically distinguished.

Existing local video file

Minimum peak spacing from 0.1 through 30 seconds (default: 1)

Decode duration from 1 through 300 seconds (default: 60)

Frame samples per second from 1 through 10 (default: 4)

Minimum mean luma-frame difference from 0 through 255 (default: 12)

Failure detail when ok is false.

The registered MCP tool name.

Detect Motion Peaks

Detect Scene Edits

Safe scene-edit facade. It uses the authenticated Premiere UXP bridge when connected and explicitly confirmed; CEP fallback is intentionally withheld because synchronous scene detection can block the panel.

Must be true because the host operation mutates the project and is not claimed undoable.

How Premiere should materialize detected edits on the current native selection.

Optional idempotency key sent to the UXP bridge.

Failure detail when ok is false.

The registered MCP tool name.

Detect Scene Edits

Detect Silence

Find silent ranges in a media file and return both the silences and the complementary segments worth keeping. Analysis only — nothing in the project or on the timeline is modified. Requires ffmpeg on PATH: Premiere's scripting API exposes no audio-level or waveform data, so silence cannot be measured through the bridge.

Absolute path to the media file to analyse. Provide this or project_item_id.

Shortest run of silence to report, in seconds (default: 1.5).

Level at or below which audio counts as silence, in dBFS. Closer to 0 is more aggressive (default: -30).

Node ID or name of a project item whose media path is resolved through Premiere. Provide this or media_path.

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Detect Silence

Detect Source Scene Changes

Detect probable visual cuts in a local source file using FFmpeg scene scores. Read-only and source-relative; it does not cut a Premiere timeline.

Maximum returned changes (default: 500; maximum: 2000)

Path to an existing local video file

Keep only the strongest event within this interval (default: 0.25)

Scene-score threshold from 0.01 through 1 (default: 0.3)

Failure detail when ok is false.

The registered MCP tool name.

Detect Source Scene Changes

Duplicate Clip

Duplicate a clip on the timeline (copy to same position on next available track)

Node ID of the clip to duplicate

Failure detail when ok is false.

The registered MCP tool name.

Duplicate Clip

Duplicate Sequence

Duplicate an existing sequence

Sequence name or ID to duplicate

Failure detail when ok is false.

The registered MCP tool name.

Duplicate Sequence

Enable Disable Clip

Enable or disable a clip on the timeline

Set to true to enable, false to disable

Node ID of the clip

Failure detail when ok is false.

The registered MCP tool name.

Enable Disable Clip

Encode File

Request an Adobe Media Encoder encode for an external file. The returned job ID is an unverified handoff; verify queue presence or the output file independently.

Optional start time in seconds

Full path to the input file

Optional end time in seconds

Full output file path

Path to an AME preset file (.epr)

Remove from queue on completion (default: true)

Failure detail when ok is false.

The registered MCP tool name.

Encode File

Encode Project Item

Request an Adobe Media Encoder encode for a project item. The returned job ID is an unverified handoff; verify queue presence or the output file independently.

Node ID or name of the project item to encode

Full output file path

Path to an AME preset file (.epr)

Failure detail when ok is false.

The registered MCP tool name.

Encode Project Item

Export Aaf

Unavailable on the CEP backend. Use export_aaf_uxp with an authenticated Premiere 26.3+ UXP bridge.

Audio bit depth (default: 16)

Explode multichannel audio to mono (default: false)

Mix down video to single track (default: true)

Full output file path (e.g., '/Users/me/export.aaf')

Audio sample rate (default: 48000)

Failure detail when ok is false.

The registered MCP tool name.

Export Aaf

Export As Fcp Xml

Export the active sequence as a Final Cut Pro XML file

Full output file path (e.g., '/Users/me/export.xml')

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Export As Fcp Xml

Export As Project

Export a sequence as a standalone Premiere Pro project file

Full path for the exported .prproj file

Sequence name or ID. Uses active sequence if omitted.

Failure detail when ok is false.

The registered MCP tool name.

Export As Project

Export Frame

Export the current frame as an image file

Full output file path (e.g., '/Users/me/frame.png'). Extension determines format.

Time position in seconds to export. Uses current playhead if omitted.

Failure detail when ok is false.

The registered MCP tool name.

Export Frame

Export Omf

Export the active sequence as an OMF file (Open Media Framework, for audio post-production)

Embed audio in OMF (true) or reference external files (false). Default: true

Audio format: 0=AIFF, 1=WAV. Default: 1

Audio bit depth (default: 16)

Handle length in frames when trimming (default: 1000)

Include pan information in the OMF (default: false)

Full output file path (e.g., '/Users/me/export.omf')

Audio sample rate (default: 48000)

Trim audio to used range plus handles (default: true)

Failure detail when ok is false.

The registered MCP tool name.

Export Omf

Export Sequence

Export the active sequence using Adobe Media Encoder

Full output file path (e.g., '/Users/me/exports/video.mp4')

Path to an AME preset file (.epr). Uses default H.264 if omitted.

Export only the work area (default: false, exports entire sequence)

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Export Sequence

Export Sequence Clip Review Frames

Export one file-verified composite frame at the midpoint of each clip on a chosen video track in one bridge request. Read-only in Premiere; it does not mute tracks or claim visual quality.

Maximum clips to sample (default: 20; maximum: 50)

Existing directory for clip_001.png and subsequent review frames

Zero-based video track index (default: 0)

Failure detail when ok is false.

The registered MCP tool name.

Export Sequence Clip Review Frames

Export Sequence Marker Review Frames

Export up to 24 file-verified composite frames at active-sequence marker positions in one bridge request for marker-driven review. It reads markers and writes image files only; it does not add, update, or remove Premiere markers.

Optional positive exclusive upper bound for marker positions in seconds.

Maximum chronological marker frames to export (default: 12; minimum: 1; maximum: 24).

Optional exact Premiere marker type to include (for example Comment or Chapter).

Existing directory where marker_review_001.png through marker_review_NNN.png will be written

Optional non-negative lower bound for marker positions in seconds.

Failure detail when ok is false.

The registered MCP tool name.

Export Sequence Marker Review Frames

Export Sequence Review Frames

Export 2-24 evenly spaced, file-verified frames from an active-sequence range in one bridge round trip for visual review. This samples rendered output; it does not prove playback, audio, or editorial quality.

Optional positive range end in seconds (default: sequence end)

Number of evenly spaced frames to export (default: 6; minimum: 2; maximum: 24)

Existing directory where review_001.png through review_NNN.png will be written

Optional non-negative range start in seconds (default: sequence start)

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Export Sequence Review Frames

Extract Selection

Extract (remove and close gap) the content between sequence in/out points.

Failure detail when ok is false.

The registered MCP tool name.

Extract Selection

Find Items By Media Path

Find project items whose media path contains the given search string

Partial file path to search for

Failure detail when ok is false.

The registered MCP tool name.

Find Items By Media Path

Find Project Item By Name

Find a project item by name (searches recursively through bins)

Name of the project item to find

Failure detail when ok is false.

The registered MCP tool name.

Find Project Item By Name

Freeze Frame

Create a freeze frame from a clip at a specific time. Exports the frame and imports it back as a still image.

Duration of the freeze frame on the timeline (default: 2)

Full path for the exported frame (e.g., /path/to/freeze.png)

Time in the sequence to freeze (in seconds). Uses playhead if omitted.

Failure detail when ok is false.

The registered MCP tool name.

Freeze Frame

Generate Media Contact Sheet

Generate a new, disk-verified PNG contact sheet from evenly sampled source frames. Refuses to overwrite an existing output and does not modify Premiere or the source.

Grid columns from 2 through 8 (default: 4)

Existing local video file

New .png output path

Grid rows from 2 through 8 (default: 3)

Thumbnail width from 160 through 1280 pixels (default: 320)

Failure detail when ok is false.

The registered MCP tool name.

Generate Media Contact Sheet

Get Active Sequence

Get detailed information about the currently active sequence

Failure detail when ok is false.

The registered MCP tool name.

Get Active Sequence

Get Advanced Feature Support

Report public-API support, prerequisites, entitlements, and user-assisted boundaries for Premiere collaboration and AI features

Backend being evaluated (default: cep, the current production MCP transport)

Whether the operator has confirmed Frame.io account/project access

Whether the operator has confirmed Adobe generative AI entitlement

Whether required Adobe/cloud services are reachable

Optional Premiere version such as 26.3.0 for version-specific eligibility

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Get Advanced Feature Support

Get All Project Paths

Get all unique media file paths used in the project. Useful for asset management and archiving.

Failure detail when ok is false.

The registered MCP tool name.

Get All Project Paths

Get Av Feature Support

Report the documented automation boundary for advanced audio and modern color management, including actionable reasons for UI-only features.

Failure detail when ok is false.

The registered MCP tool name.

Get Av Feature Support

Get Bin Contents

Get detailed contents of a specific bin (folder) including all nested items, media paths, offline status, color labels, and metadata. Searches by bin name or node ID.

Bin name, node ID, or path (e.g., 'Footage', 'Footage/Raw')

Maximum direct children to return. Pair with recursive false for the smallest bounded response.

Maximum nested-bin depth when recursive is true. Defaults to the legacy unlimited recursion.

Zero-based offset into the bin's direct children. Pair with limit for a bounded page.

Include items from sub-bins recursively (default: true)

Failure detail when ok is false.

The registered MCP tool name.

Get Bin Contents

Get Bridge Telemetry

Inspect privacy-preserving aggregate bridge health: pending command/response counts, busy operations, queue age, and CEP heartbeat state without returning project or personal data.

Failure detail when ok is false.

The registered MCP tool name.

Get Bridge Telemetry

Get Capabilities

Report Windows/macOS support, Premiere Pro backend coverage, enabled authority, and whether live host verification is still required. Use tool_names or tool_offset/tool_limit to return a bounded tool catalog.

Maximum tool catalog entries to return. Omit with tool_offset to preserve the complete legacy response.

Optional exact tool-name allowlist. Returns only those catalog entries while retaining the overall capability summary.

Zero-based offset into the filtered tool catalog. Pair with tool_limit for an explicitly sized page.

Failure detail when ok is false.

The registered MCP tool name.

Get Capabilities

Get Clip Adjustment Layer

Check if a clip is an adjustment layer

Node ID of the clip

Failure detail when ok is false.

The registered MCP tool name.

Get Clip Adjustment Layer

Get Clip At Playhead

Get all clips at the current playhead position across all tracks.

Track type to check (default: both)

Failure detail when ok is false.

The registered MCP tool name.

Get Clip At Playhead

Get Clip At Position

Get the clip at a specific time position on a track

Time position in seconds

Track index (0-based)

Track type

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Get Clip At Position

Get Clip Links

Get information about linked clips (audio/video linked together) for a given clip.

Node ID of the clip

Failure detail when ok is false.

The registered MCP tool name.

Get Clip Links

Get Clip Markers

Get all markers on a specific project item (source clip markers, not sequence markers).

Node ID or name of the project item

Failure detail when ok is false.

The registered MCP tool name.

Get Clip Markers

Get Clip Properties

Get detailed properties of a specific clip by its node ID

The node ID of the clip

Failure detail when ok is false.

The registered MCP tool name.

Get Clip Properties

Get Clip Speed

Get the playback speed and reverse state of a clip

Node ID of the clip

Failure detail when ok is false.

The registered MCP tool name.

Get Clip Speed

Get Clip Volume

Read an audio clip's Volume > Level in dB. Use this to verify a level actually applied - setValue() clamps silently. Does not report Essential Sound Amplify automation.

Node ID of the audio clip

Failure detail when ok is false.

The registered MCP tool name.

Get Clip Volume

Get Color Label

Get the color label of a project item

Node ID or name of the project item

Failure detail when ok is false.

The registered MCP tool name.

Get Color Label

Get Color Space

Get the color space information for a project item

Node ID or name of the project item

Failure detail when ok is false.

The registered MCP tool name.

Get Color Space

Get Duplicate Media

Find project items that reference the same source media file. Useful for consolidation.

Failure detail when ok is false.

The registered MCP tool name.

Get Duplicate Media

Get Effect Properties

List all properties of a specific effect on a clip, including current values

Display name of the effect (e.g., 'Motion', 'Opacity', 'Lumetri Color')

Node ID of the clip

Failure detail when ok is false.

The registered MCP tool name.

Get Effect Properties

Get Encoder Presets

List available Adobe Media Encoder export presets, with the .epr path of each so it can be passed to export_sequence or encode_project_item. Presets are discovered by scanning the .epr files Adobe ships on disk (Premiere's ExtendScript API exposes no preset enumeration).

Filter to presets whose name or format bucket matches this (e.g. 'H.264', 'ProRes', 'Proxy'). Omit to list all.

Failure detail when ok is false.

The registered MCP tool name.

Get Encoder Presets

Get Export File Extension

Get the file extension that would be used when exporting the active sequence with a given preset

Full path to the export preset file (.epr)

Failure detail when ok is false.

The registered MCP tool name.

Get Export File Extension

Get Footage Interpretation

Get footage interpretation settings for a project item

Node ID or name of the project item

Failure detail when ok is false.

The registered MCP tool name.

Get Footage Interpretation

Get Full Clip Info

Get exhaustive information about a specific clip: all effects with every property value, source media details, footage interpretation, metadata, markers, speed, enabled state, color label, linked clips, and proxy status.

Node ID of the clip on the timeline

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Get Full Clip Info

Get Full Project Overview

Get a comprehensive overview of the project. Use include_bin_tree false or sequence_offset/sequence_limit for a bounded response on large projects.

Include the recursive bin tree (default: true). Set false to return project statistics and sequences only.

Maximum recursive bin-tree depth when include_bin_tree is true (default: 10).

Maximum sequences to include. Omit to preserve the complete legacy response.

Zero-based offset into project sequences.

Failure detail when ok is false.

The registered MCP tool name.

Get Full Project Overview

Get Full Sequence Info

Get exhaustive information about a sequence: settings, all tracks with lock/mute/target state, all clips with positions/effects/speed/enabled state, all markers, transitions, in/out points, and work area.

Sequence name or ID. Uses active sequence if omitted.

Failure detail when ok is false.

The registered MCP tool name.

Get Full Sequence Info

Get Graphics White Luminance

Get the graphics white luminance value (HDR setting) for the project

Failure detail when ok is false.

The registered MCP tool name.

Get Graphics White Luminance

Get Insertion Bin

Get the current target bin for new imports (the bin that is currently focused in the Project panel)

Failure detail when ok is false.

The registered MCP tool name.

Get Insertion Bin

Get Item Info

Get detailed type info about a project item (is it a sequence, multicam, merged clip, etc.)

Node ID or name of the project item

Failure detail when ok is false.

The registered MCP tool name.

Get Item Info

Get Keyframes

Get all keyframes for a specific effect property on a clip

Display name of the effect

Node ID of the clip

Display name of the property

Failure detail when ok is false.

The registered MCP tool name.

Get Keyframes

Get Linked Items

Get all clips in the sequence that are linked to the same source as a given clip

Node ID of the clip

Failure detail when ok is false.

The registered MCP tool name.

Get Linked Items

Get Metadata

Get metadata for a project item. Disable either XML payload when a bounded identity/path response is sufficient.

Include the potentially large Project Metadata XML payload (default: true). Set false for a bounded identity/path response.

Include the potentially large XMP XML payload (default: true). Set false for a bounded identity/path response.

Node ID or name of the project item

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Get Metadata

Get Mogrt Component

Get MOGRT (Motion Graphics Template) component parameters from a clip

Node ID of the MOGRT clip on the timeline

Failure detail when ok is false.

The registered MCP tool name.

Get Mogrt Component

Get Next Edit Point

Find the next or previous edit point (clip boundary) from the playhead position.

Direction to search (default: next)

Track type to check (default: both)

Failure detail when ok is false.

The registered MCP tool name.

Get Next Edit Point

Get Offline Media

Find all offline/missing media in the project with their expected file paths. Essential for diagnosing broken links.

Failure detail when ok is false.

The registered MCP tool name.

Get Offline Media

Get Playhead Position

Get the current playhead (CTI) position in the active sequence

Failure detail when ok is false.

The registered MCP tool name.

Get Playhead Position

Get Premiere State

Get a comprehensive snapshot of the current Premiere Pro state: project info, active sequence, playhead position, selected clips, and available sequences. The best first call to understand the current context.

Failure detail when ok is false.

The registered MCP tool name.

Get Premiere State

Get Project Info

Get information about the currently open Premiere Pro project

Failure detail when ok is false.

The registered MCP tool name.

Get Project Info

Get Project Item Info

Get detailed information about a project item (media file in the project panel): media path, resolution, duration, frame rate, codec info, metadata, color label, offline status, in/out points, and proxy status.

Node ID or name of the project item

Failure detail when ok is false.

The registered MCP tool name.

Get Project Item Info

Get Project Panel Metadata

Get the current project panel metadata/column configuration as XML

Failure detail when ok is false.

The registered MCP tool name.

Get Project Panel Metadata

Get Project Scratch Disks

Get the current scratch disk paths for the project.

Failure detail when ok is false.

The registered MCP tool name.

Get Project Scratch Disks

Get Qe Clip Info

Get QE DOM information about a clip, including properties not available through the standard API.

Clip index on the track (0-based)

Track index (0-based)

Track type

Failure detail when ok is false.

The registered MCP tool name.

Get Qe Clip Info

Get Render Queue Status

Get the current status of the Adobe Media Encoder render queue

Failure detail when ok is false.

The registered MCP tool name.

Get Render Queue Status

Get Selected Clips

Get the currently selected clips in the active sequence

Failure detail when ok is false.

The registered MCP tool name.

Get Selected Clips

Get Sequence Count

Get the total number of sequences in the project.

Failure detail when ok is false.

The registered MCP tool name.

Get Sequence Count

Get Sequence In Out Points

Get the current sequence in and out points

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Get Sequence In Out Points

Get Sequence Markers By Type

Get all markers of a specific type (comment, chapter, web link, etc.) from a sequence.

Type of marker to filter

Comment Chapter Segmentation WebLink FlashCuePoint

Sequence name or ID. Uses active sequence if omitted.

Failure detail when ok is false.

The registered MCP tool name.

Get Sequence Markers By Type

Get Sequence Settings

Get the settings (resolution, frame rate, etc.) of a sequence

Sequence ID or name. Uses active sequence if omitted.

Failure detail when ok is false.

The registered MCP tool name.

Get Sequence Settings

Get Sequence Structure

Get a complete structural overview of the active sequence: all tracks, all clips with positions, gaps, and clip metadata. Essential for understanding timeline state before making edits.

Failure detail when ok is false.

The registered MCP tool name.

Get Sequence Structure

Get Source Monitor Info

Get information about the clip currently loaded in the Source Monitor.

Failure detail when ok is false.

The registered MCP tool name.

Get Source Monitor Info

Get Source Monitor Position

Get the current time indicator position in the Source Monitor

Failure detail when ok is false.

The registered MCP tool name.

Get Source Monitor Position

Get Target Tracks

Get which tracks are currently targeted for editing.

Failure detail when ok is false.

The registered MCP tool name.

Get Target Tracks

Get Timeline Gaps

Find all gaps (empty spaces) on the timeline between clips. Useful for identifying where content is missing or where clips can be tightened.

Minimum gap duration in seconds to report (default: 0.04 = ~1 frame at 24fps)

Which track type to analyze (default: both)

Failure detail when ok is false.

The registered MCP tool name.

Get Timeline Gaps

Get Timeline Summary

Get a human-readable summary of the timeline: total duration, clip count per track, total gaps, coverage percentage, used media files, effect usage, and marker overview. Great for a quick understanding of sequence state.

Failure detail when ok is false.

The registered MCP tool name.

Get Timeline Summary

Get Total Clip Count

Get the total number of clips across all tracks in the active sequence.

Failure detail when ok is false.

The registered MCP tool name.

Get Total Clip Count

Get Track Info

Get detailed information about a specific track: name, clip count, muted, locked, targeted, and list of all clips.

Track index (0-based)

Track type

Failure detail when ok is false.

The registered MCP tool name.

Get Track Info

Get Unused Media

Find all project items that are NOT used in any sequence. Useful for cleaning up projects.

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Get Unused Media

Get Used Media Report

Get a report of all media files used in a sequence: which source files are used, how many times each appears, on which tracks, and whether any sources are offline.

Sequence name or ID. Uses active sequence if omitted.

Failure detail when ok is false.

The registered MCP tool name.

Get Used Media Report

Get Value At Time

Get the interpolated value of an effect property at a specific time

Display name of the effect

Node ID of the clip

Display name of the property

Time in seconds to query the value at

Failure detail when ok is false.

The registered MCP tool name.

Get Value At Time

Get Version Info

Get Premiere Pro version and build information.

Failure detail when ok is false.

The registered MCP tool name.

Get Version Info

Get Work Area

Get the current work area in and out points

Failure detail when ok is false.

The registered MCP tool name.

Get Work Area

Get Workspaces

List all available workspace layouts in Premiere Pro

Failure detail when ok is false.

The registered MCP tool name.

Get Workspaces

Get Xmp Metadata

Get the raw XMP metadata for a project item (includes EXIF, IPTC, Dublin Core, etc.)

Node ID or name of the project item

Failure detail when ok is false.

The registered MCP tool name.

Get Xmp Metadata

Has Proxy

Check if a project item has a proxy attached

Node ID or name of the project item

Failure detail when ok is false.

The registered MCP tool name.

Has Proxy

Import Ae Comps

Import After Effects compositions from an .aep file

Full path to the .aep file

Array of composition names to import. If omitted, imports all comps.

Target bin name or node ID (optional)

Failure detail when ok is false.

The registered MCP tool name.

Import Ae Comps

Import Edl

Unavailable by design: CMX 3600 EDL import opens Premiere UI that can block the CEP bridge. No import is attempted; convert the EDL to FCP7 XML and use import_fcp_xml for unattended interchange.

Absolute path to the CMX 3600 .edl file that was requested for import.

Failure detail when ok is false.

The registered MCP tool name.

Import Edl

Import Fcp Xml

Import a Final Cut Pro XML file into the current project

Full path to the FCP XML file

Failure detail when ok is false.

The registered MCP tool name.

Import Fcp Xml

Import Folder

Import an entire folder of media into the project

Path to the folder to import

Failure detail when ok is false.

The registered MCP tool name.

Import Folder

Import Image Sequence

Import a numbered image sequence as a single video clip.

Full path to the first image in the sequence (e.g., /path/to/frame_001.png)

Target bin name to import into (optional, imports to root if omitted)

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Import Image Sequence

Import Media

Import media files into the project

Array of file paths to import

Suppress import dialogs (default: true)

Optional bin name or node ID to import into. Imports to root if omitted.

Failure detail when ok is false.

The registered MCP tool name.

Import Media

Import Mogrt

Import a Motion Graphics Template (.mogrt) file and add it to the timeline

Duration in seconds (default: 5)

Full path to the .mogrt file

Start time in seconds (default: 0)

Video track index (default: 0)

Failure detail when ok is false.

The registered MCP tool name.

Import Mogrt

Import Mogrt From Library

Import a MOGRT from a named Adobe Creative Cloud Library.

Name of the Adobe Creative Cloud Library that contains the MOGRT

Name of the MOGRT in the library

Start time in seconds (default: 0)

Video track index (default: 0)

Failure detail when ok is false.

The registered MCP tool name.

Import Mogrt From Library

Import Sequences

Import sequences from another Premiere Pro project file

Full path to the source .prproj file

Non-empty array of sequence IDs to import from the source project.

Failure detail when ok is false.

The registered MCP tool name.

Import Sequences

Insert From Source

Insert the clip from the Source Monitor at the playhead position (insert edit — shifts existing clips).

Target audio track index (default: 0)

Target video track index (default: 0)

Failure detail when ok is false.

The registered MCP tool name.

Insert From Source

Inspect Cmx3600 Edl

Parse a local CMX 3600 EDL into bounded event, reel, track, transition, and timecode facts without importing it into Premiere.

Existing local .edl file

Failure detail when ok is false.

The registered MCP tool name.

Inspect Cmx3600 Edl

Inspect Dom Object

Inspect a Premiere Pro DOM object and list its properties, methods, and values. Useful for exploring the API and debugging.

Examples:
- "app.project" → project properties
- "app.project.activeSequence" → sequence properties
- "app.project.activeSequence.videoTracks[0].clips[0]" → first clip on V1
- "app.project.activeSequence.videoTracks[0].clips[0].components[0]" → first component of a clip

Max depth for nested inspection (default: 1, max: 3)

Dot-path to the DOM object to inspect (e.g., 'app.project.activeSequence')

Failure detail when ok is false.

The registered MCP tool name.

Inspect Dom Object

Inspect Edit Readiness

Audit the active sequence in one read-only bridge request for empty timelines, primary-track gaps, disabled clips, muted tracks, and excessive Motion scale. Structural diagnostics only; it cannot judge story, framing, sound, or final delivery.

Ignore smaller gaps caused by time rounding (default: 0.001)

Warn above this Motion scale percentage (default: 110)

Video track used for gap inspection (default: 0)

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Inspect Edit Readiness

Inspect Fcpxml Interchange

Inspect a local FCPXML document's root version, sequence/clip counts, bounded asset declarations, and text-only parser warnings before deliberate Premiere import.

Existing local .fcpxml or .xml file

Failure detail when ok is false.

The registered MCP tool name.

Inspect Fcpxml Interchange

Inspect Media Streams

Inspect a local media file with ffprobe and return container, stream, codec, time-base, channel, and chapter metadata. Read-only and independent of Premiere.

Existing local media file

Failure detail when ok is false.

The registered MCP tool name.

Inspect Media Streams

Inspect Project Item Av Metadata

Inspect a project item's documented effective/original color space, LUT IDs, available color-space overrides, and audio channel shape.

Project item node ID or exact name

Failure detail when ok is false.

The registered MCP tool name.

Inspect Project Item Av Metadata

Inspect Project Recovery

Read-only recovery inspection: diagnose the active project path and list adjacent Premiere Auto-Save project candidates without opening, copying, or restoring anything.

Failure detail when ok is false.

The registered MCP tool name.

Inspect Project Recovery

Inspect Sequence Av Settings

Inspect documented audio, tone-mapping, linear-compositing, bit-depth, render-quality, and display settings for the active sequence.

Failure detail when ok is false.

The registered MCP tool name.

Inspect Sequence Av Settings

Inspect Sequence Review Report

Build one read-only sequence handoff report with timeline structure, primary-track gaps, disabled clips, muted tracks, marker timing, and offline-source evidence. Media paths are never returned; marker comments require an explicit opt-in. It does not prove rendered pixels, audio quality, caption correctness, rights, or editorial approval.

Include marker comments. Defaults to false because comments can contain private editorial notes.

Maximum marker entries to return from the start of the sequence (default: 50, maximum: 200).

Video track used for gap inspection (default: 0).

Sequence name or ID. Uses the active sequence if omitted.

Failure detail when ok is false.

The registered MCP tool name.

Inspect Sequence Review Report

Inspect Stabilizer Status

Read Warp Stabilizer presence, exposed status properties, and conservative analysis state for one clip or every video clip in the active sequence. Read-only: unknown or localized host values remain unknown rather than being reported as solved.

Optional clip node ID. Omit to inspect every video clip in the active sequence.

Failure detail when ok is false.

The registered MCP tool name.

Inspect Stabilizer Status

Invert Selection

Invert the current clip selection in the active sequence (selected become deselected and vice versa).

Failure detail when ok is false.

The registered MCP tool name.

Invert Selection

Is Work Area Enabled

Check whether the work area bar is enabled on the active sequence

Failure detail when ok is false.

The registered MCP tool name.

Is Work Area Enabled

Lift Selection

Lift (remove without closing gap) the content between sequence in/out points or selected clips.

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Lift Selection

Link Selection

Link the currently selected video and audio clips in the active sequence

Failure detail when ok is false.

The registered MCP tool name.

Link Selection

List Available Audio Effects

List all available audio effects in Premiere Pro. Uses QE DOM.

Failure detail when ok is false.

The registered MCP tool name.

List Available Audio Effects

List Available Audio Transitions

List all available audio transitions. Uses QE DOM and reports an unavailable or empty legacy catalog as an error rather than an assumed usable list.

Failure detail when ok is false.

The registered MCP tool name.

List Available Audio Transitions

List Available Effects

List available video effects in Premiere Pro. Uses the full QE catalog when exposed; otherwise returns a verified, explicitly partial set of common effects resolved by exact name.

Failure detail when ok is false.

The registered MCP tool name.

List Available Effects

List Available Transitions

List all available video transitions. Uses QE DOM. Returns a hint set on PPro 2026 where the transition registry list is empty even though by-name lookup works.

Failure detail when ok is false.

The registered MCP tool name.

List Available Transitions

List Clip Effects

List all effects/components on a clip with their properties and current values. Essential for debugging effect issues.

Node ID of the clip to inspect

Failure detail when ok is false.

The registered MCP tool name.

List Clip Effects

List Markers

List all markers on the active sequence or a specific clip

Optional clip node ID to list clip markers instead of sequence markers

Failure detail when ok is false.

The registered MCP tool name.

List Markers

List Project Items

List all items in the project panel (clips, bins, sequences)

Optional bin path to list items from (e.g., 'Footage/Raw'). Lists root items if omitted.

Failure detail when ok is false.

The registered MCP tool name.

List Project Items

List Sequence Tracks

List all tracks (video and audio) in a sequence

Sequence ID or name. Uses active sequence if omitted.

Failure detail when ok is false.

The registered MCP tool name.

List Sequence Tracks

List Sequences

List all sequences in the project

Failure detail when ok is false.

The registered MCP tool name.

List Sequences

Lock Track

Lock or unlock a video track

True to lock, false to unlock

Video track index (0-based)

Failure detail when ok is false.

The registered MCP tool name.

Lock Track

Manage Project Context

Capture, enrich, inspect, or clear a durable local Premiere project-context index. Capture stores bounded active-sequence/source metadata; enrich adds transcripts, shots, audio observations, or notes without re-analyzing unchanged sources. Never include secrets or unrelated customer data.

Capture active context, enrich it, inspect status, or clear one local project index

Project context ID returned by capture; optional for status to list projects

For enrich, up to 512 transcript, shot, audio, or note records

Optional stable enrichment ID for deterministic replacement

Small scalar metadata object; path and credential-like keys are discarded

Optional stale-analysis guard from the source record

Transcript, visual description, audio observation, or editor note

Optional stale-placement guard from context status

For enrich, replace prior enrichments while retaining captured core records

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Manage Project Context

Manage Proxies

Create, attach, or toggle proxies for a project item. Note: 'create' only requests a proxy encode from Adobe Media Encoder and returns an unverified handoff. Independently verify the AME queue or output file before calling this tool again with action 'attach' and proxy_path set to the output_path you passed here. There is no single-call create-and-attach in Premiere's ExtendScript API.

Action to perform on proxies

Node ID or name of the project item

Full output path for the proxy to be rendered to (required for 'create')

Path to a proxy ingest preset (.epr) for 'create'. If omitted, the first preset found in Premiere's IngestPresets/Proxy folder is used.

Path to an existing proxy file (required for 'attach')

Failure detail when ok is false.

The registered MCP tool name.

Manage Proxies

Match Frame

Get source media info for the frame at the current playhead on a specific track. Useful for match frame operations.

Track index (default: 0)

Track type (default: video)

Failure detail when ok is false.

The registered MCP tool name.

Match Frame

Move Clip

Move a clip to a new position on the timeline

New start time in seconds

Optional new track index to move the clip to

Node ID of the clip to move

Failure detail when ok is false.

The registered MCP tool name.

Move Clip

Move Clip To Track

Move a clip to a different track. Uses QE DOM.

Node ID of the clip

Target track index (0-based)

Failure detail when ok is false.

The registered MCP tool name.

Move Clip To Track

Move Item To Bin

Move a project item to a different bin

Node ID or name of the item to move

Name or node ID of the target bin

Failure detail when ok is false.

The registered MCP tool name.

Move Item To Bin

Move Items To Bin

Move multiple project items to a target bin at once.

Array of node IDs or names of items to move

Name or node ID of the target bin

Failure detail when ok is false.

The registered MCP tool name.

Move Items To Bin

Move Playhead To Edit

Move the playhead to the next or previous edit point.

Direction (default: next)

Failure detail when ok is false.

The registered MCP tool name.

Move Playhead To Edit

Multiple Undo

Unavailable: Premiere exposes no supported, observable undo-stack API for multiple scripted undo steps.

Number of undo steps (default: 1)

Failure detail when ok is false.

The registered MCP tool name.

Multiple Undo

Mute Track

Mute or unmute an audio track

True to mute, false to unmute

Audio track index (0-based)

Failure detail when ok is false.

The registered MCP tool name.

Mute Track

Nest Clips

Unavailable on the legacy CEP backend: Premiere's documented createSubsequence API only creates a separate sequence and cannot safely replace the selected timeline clips with a nested-sequence reference.

Name for the nested sequence

Failure detail when ok is false.

The registered MCP tool name.

Nest Clips

Normalize Loudness File

Create a new loudness-normalized media derivative with FFmpeg, then remeasure that exact output using EBU R128. Never overwrites the input or an existing output file.

Existing local audio or video file

True-peak ceiling from -9 through 0 dBFS (default: -1.5)

New output path; must not already exist

Integrated loudness target from -70 through -5 LUFS (default: -16)

Post-render integrated-loudness tolerance (default: 1 LU)

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Normalize Loudness File

Open In Source

Open a project item in the Source Monitor for preview and trimming.

Node ID or name of the project item to open

Failure detail when ok is false.

The registered MCP tool name.

Open In Source

Open Project

Open a Premiere Pro project file

Full file path to the .prproj file

Failure detail when ok is false.

The registered MCP tool name.

Open Project

Overwrite Clip

Overwrite a project item onto validated timeline tracks and verify a new source placement at the requested time

Audio track index (0-based, default: 0)

Node ID or name of the project item to add

Start time in seconds on the timeline (default: 0)

Video track index (0-based, default: 0)

Failure detail when ok is false.

The registered MCP tool name.

Overwrite Clip

Overwrite From Source

Overwrite the clip from the Source Monitor at the playhead position (overwrite edit — replaces existing clips).

Target audio track index (default: 0)

Target video track index (default: 0)

Failure detail when ok is false.

The registered MCP tool name.

Overwrite From Source

ping

Ping

Health check — verify the CEP plugin is running and connected to Premiere Pro. Call this before other tools to confirm connectivity.

Failure detail when ok is false.

The registered MCP tool name.

Ping

Plan Shot Match

Compare two bounded local-media frame samples and return measured waveform/parade/saturation deltas plus coarse correction directions. Read-only planning only; it does not grade Premiere or claim that primaries alone can match the shots.

Existing local reference video file

Reference source time from 0 through 86400 seconds (default: 0)

Existing local target video file

Target source time from 0 through 86400 seconds (default: 0)

Failure detail when ok is false.

The registered MCP tool name.

Plan Shot Match

Plan Silence Review Markers

Create a bounded, non-mutating review plan that maps FFmpeg-detected source-media silences onto one known 1x timeline placement. It clips candidates to the supplied source in/out span, redacts the source path, and never adds markers, cuts clips, or changes Premiere.

Maximum candidate ranges to return (default: 50, maximum: 200).

Absolute path to the local source media file to analyse.

Shortest run of silence to consider (default: 1.5).

Level at or below which audio counts as silence, in dBFS (default: -30).

Source-media in point used by the placement (default: 0).

Exclusive source-media out point used by the placement. Defaults to the detected media duration when available.

Timeline time where this 1x source placement begins.

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Plan Silence Review Markers

Play Source Monitor

Request playback of the clip in the Source Monitor. The legacy API does not provide a same-call position readback, so movement is not reported as verified.

Playback speed (1.0 = normal, 2.0 = 2x, -1.0 = reverse). Default: 1.0

Failure detail when ok is false.

The registered MCP tool name.

Play Source Monitor

Play Timeline

Request playback of the active sequence timeline through QE. The legacy API does not provide a same-call playhead readback, so movement is not reported as verified.

Failure detail when ok is false.

The registered MCP tool name.

Play Timeline

Preview Brand Spot

Preview a brand-spot assembly from existing project items with an optional workspace-contained MOGRT overlay. Preview is local-only; it does not read or import the MOGRT file.

Operator-approved root containing mogrt_path; required whenever mogrt_path is supplied.

Exact existing project-item node IDs in playback order; external media paths are deliberately not imported by this workflow.

Empty destination audio track index, default 0.

Planned spacing between asset starts; defaults to 5 seconds for a motion demo and 4 seconds for spots.

Optional absolute .mogrt path, which must be inside approved_workspace_path.

Scale-motion style for product and brand spots; defaults to alternate.

Exact ID of an existing empty destination sequence. It must be active at apply time.

MOGRT start time in seconds, default 0.4.

Empty title-overlay video track index, default 1 and distinct from video_track_index.

Transition duration, default 0.75 seconds for demos and 0.5 seconds for spots.

Transition name; defaults to Cross Dissolve. Use none to disable transitions.

Empty destination video track index, default 0.

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Preview Brand Spot

Preview Edit Plan

Validate and preview a compound timeline edit without changing Premiere. Returns a confirmation token required by apply_edit_plan.

An edit plan containing insert_clip and remove_clip operations (maximum 100)

Failure detail when ok is false.

The registered MCP tool name.

Preview Edit Plan

Preview Editorial Plan

Revalidate an exact server-issued editorial plan against the saved project-context revisions and return an opaque confirmation token. This tool is read-only and cannot apply the plan.

Unchanged plan returned by create_editorial_plan from this running server instance.

Failure detail when ok is false.

The registered MCP tool name.

Preview Editorial Plan

Preview Motion Graphics Demo

Preview a contained motion-graphics demo assembly from existing project items. It never creates demo assets, imports files, creates a sequence, or changes Premiere; apply requires an exact confirmation token.

Exact existing project-item node IDs in playback order; external media paths are deliberately not imported by this workflow.

Empty destination audio track index, default 0.

Planned spacing between asset starts; defaults to 5 seconds for a motion demo and 4 seconds for spots.

Failure detail when ok is false.

The registered MCP tool name.

Preview Motion Graphics Demo

Preview Product Spot

Preview a product-spot assembly from existing project items. The eventual apply is limited to explicit empty tracks, revalidates item IDs, and reports host readback without claiming visual delivery verification.

Scale-motion style for product and brand spots; defaults to alternate.

Exact ID of an existing empty destination sequence. It must be active at apply time.

Failure detail when ok is false.

The registered MCP tool name.

Preview Product Spot

Preview Project Intake

Inspect a bounded Premiere project against an explicit facility intake template and return a path-redacted report plus a non-mutating organization proposal. It never changes Premiere or persists the template.

Include observed media paths in findings. Defaults to false; hashes are returned instead.

Maximum project items to inspect; defaults to 2000. Truncation returns an incomplete report.

Versioned facility policy. Unknown fields and unsafe matching expressions are rejected by the intake engine.

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Preview Project Intake

Razor All Tracks

Razor (split) all clips at the playhead position across all tracks, or at a specific time.

Time to razor at in seconds (uses playhead position if omitted)

Which track types to razor (default: both)

Failure detail when ok is false.

The registered MCP tool name.

Razor All Tracks

Read Sequence Captions

Diagnose whether the active Premiere scripting host can enumerate caption tracks. It never treats an empty result as proof that the sequence has no captions, because most CEP builds expose caption creation but not caption reads.

Sequence ID or name. Defaults to the active sequence.

Failure detail when ok is false.

The registered MCP tool name.

Read Sequence Captions

Read Video Scopes

Read waveform percentiles, RGB parade percentiles, saturation, and near-black/near-white RGB occupancy from one bounded decoded local-media frame. Read-only; this is a sampled analytical proxy, not Premiere's rendered scopes.

Existing local video file

Source-relative frame time from 0 through 86400 seconds (default: 0)

Failure detail when ok is false.

The registered MCP tool name.

Read Video Scopes

redo

Redo

Redo the last undone action in Premiere Pro.

Failure detail when ok is false.

The registered MCP tool name.

Redo

Refresh Media

Refresh a project item to pick up changes to the source file

Node ID or name of the item to refresh

Failure detail when ok is false.

The registered MCP tool name.

Refresh Media

Relink Media

Relink an offline media item to a new file path

Node ID or name of the item to relink

New file path for the media

Failure detail when ok is false.

The registered MCP tool name.

Relink Media

Remove All Effects

Remove ALL effects from a clip. Uses QE DOM.

Node ID of the clip

Failure detail when ok is false.

The registered MCP tool name.

Remove All Effects

Remove Effect

Remove an effect from a clip by its index or name. Returns a capability error when the host cannot remove an individual component.

Index of the effect to remove (0-based). Use get_clip_properties to see effects list.

Name of the effect to remove (alternative to effect_index)

Node ID of the clip

Failure detail when ok is false.

The registered MCP tool name.

Remove Effect

Remove Effect By Name

Remove all instances of a specific effect from a clip by display name. Returns a capability error when the host cannot remove individual components.

Display name of the effect to remove

Node ID of the clip

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Remove Effect By Name

Remove From Timeline

Remove a clip from the timeline

Node ID of the clip to remove

Whether to ripple delete (close the gap). Default: false

Failure detail when ok is false.

The registered MCP tool name.

Remove From Timeline

Remove Keyframe

Remove a keyframe at a specific time from an effect property

Display name of the effect

Node ID of the clip

Display name of the property

Time in seconds of the keyframe to remove

Failure detail when ok is false.

The registered MCP tool name.

Remove Keyframe

Remove Keyframe Range

Remove all keyframes in a time range from an effect property

Display name of the effect

End of the range in seconds

Node ID of the clip

Display name of the property

Start of the range in seconds

Failure detail when ok is false.

The registered MCP tool name.

Remove Keyframe Range

Remove Selected Clips

Remove all currently selected clips from the timeline.

If true, close the gap after removing (ripple delete). Default: false

Failure detail when ok is false.

The registered MCP tool name.

Remove Selected Clips

Rename Bin

Rename a bin (folder) in the project panel

Name or node ID of the bin to rename

New name for the bin

Failure detail when ok is false.

The registered MCP tool name.

Rename Bin

Rename Clip

Rename a clip on the timeline. Uses QE DOM.

New name for the clip

Node ID of the clip

Failure detail when ok is false.

The registered MCP tool name.

Rename Clip

Rename Project Item

Rename a project item in the project panel.

Node ID or name of the project item

New name for the item

Failure detail when ok is false.

The registered MCP tool name.

Rename Project Item

Rename Track

Rename a video or audio track.

New track name

Track index (0-based)

Track type

Failure detail when ok is false.

The registered MCP tool name.

Rename Track

Replace Clip

Replace a clip on the timeline with a different project item, preserving position and duration

Node ID or name of the new project item to replace with

Node ID of the clip to replace

Failure detail when ok is false.

The registered MCP tool name.

Replace Clip

Replace Clip Media

Unavailable by design: the legacy ExtendScript overwrite route cannot prove that replacing media preserves the original clip's trim, position, linked audio, or adjacent clips, so this tool performs no mutation.

Node ID of the timeline clip to replace media on

Node ID or name of the new source project item

Failure detail when ok is false.

The registered MCP tool name.

Replace Clip Media

Reverse Clip

Unavailable: Premiere does not expose a supported scripting API for reversing a timeline clip's playback direction.

Node ID of the clip

True to reverse, false for normal (default: true)

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Reverse Clip

Ripple Delete

Ripple delete a clip (removes clip and closes the gap). Uses QE DOM.

Node ID of the clip to ripple delete

Failure detail when ok is false.

The registered MCP tool name.

Ripple Delete

Roll Edit

Perform a verified roll edit at the outgoing cut of a clip using the public timeline DOM.

Node ID of the clip

Offset in seconds (positive = roll right, negative = roll left)

Failure detail when ok is false.

The registered MCP tool name.

Roll Edit

Save Project

Save the current Premiere Pro project

Failure detail when ok is false.

The registered MCP tool name.

Save Project

Save Project As

Save the current project to a new location

Full file path to save the project to (e.g., '/Users/me/projects/MyProject.prproj')

Failure detail when ok is false.

The registered MCP tool name.

Save Project As

Scene Edit Detection

Perform scene edit detection on the selected clips in the active sequence. Defaults to creating markers rather than cutting.

Create markers (default) or apply cuts to the selected clips

When applying cuts, also cut linked audio (default: false)

Scene-detection sensitivity (default: MediumSensitivity)

Failure detail when ok is false.

The registered MCP tool name.

Scene Edit Detection

Search Project Context

Search a durable Premiere project-context index for relevant sources, timeline placements, transcript passages, shots, audio observations, and notes. Returns bounded evidence with stable IDs and revisions; it never changes Premiere.

Optional context-kind filter

Maximum 50; default 12

Project context ID returned by manage_project_context capture

Natural-language or keyword query matched against indexed evidence

Optional exact sequence ID filter

Failure detail when ok is false.

The registered MCP tool name.

Search Project Context

Search Project Items

Search for project items by name, media file extension, offline status, or color label. Returns matching items with full details.

Filter by color label index (0-15)

Filter by file extension (e.g., 'mp4', 'wav', 'png'). Without dot.

Filter by item type (default: all)

Maximum results to return (default: 100)

If true, only return offline/missing items

Search query (matched against item name, case-insensitive substring match)

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Search Project Items

Select All Clips

Select all clips in the active sequence, or all clips on a specific track.

Specific track index (optional, selects all tracks if omitted)

Track type (default: both)

Failure detail when ok is false.

The registered MCP tool name.

Select All Clips

Select Clips By Color

Select all clips whose source project item has a specific color label.

Label color index (0=Violet, 1=Iris, 2=Caribbean, 3=Lavender, 4=Cerulean, 5=Forest, 6=Rose, 7=Mango, 8=Purple, 9=Blue, 10=Teal, 11=Magenta, 12=Tan, 13=Green, 14=Brown, 15=Yellow)

Failure detail when ok is false.

The registered MCP tool name.

Select Clips By Color

Select Clips By Name

Select all clips in the active sequence that match a name (substring match). Optionally filter by track type and index.

If true, add to existing selection instead of replacing it (default: false)

Clip name to search for (case-insensitive substring match)

Specific track index to search (optional, searches all if omitted)

Track type to search (default: both)

Failure detail when ok is false.

The registered MCP tool name.

Select Clips By Name

Select Clips In Range

Select all clips that overlap a time range in the active sequence.

End of selection range in seconds

Start of selection range in seconds

Specific track index (optional)

Track type (default: both)

Failure detail when ok is false.

The registered MCP tool name.

Select Clips In Range

Select Disabled Clips

Select all disabled clips in the active sequence.

Failure detail when ok is false.

The registered MCP tool name.

Select Disabled Clips

Select Item

Select a project item in the Project panel

Node ID or name of the project item to select

Failure detail when ok is false.

The registered MCP tool name.

Select Item

Set Active Sequence

Set the active sequence by name or ID

Sequence name or ID to make active

Failure detail when ok is false.

The registered MCP tool name.

Set Active Sequence

Set All Tracks Targeted

Set all tracks targeted or untargeted. Useful before insert/overwrite edits.

Whether to target (true) or untarget (false) all tracks

Which track type(s) to affect (default: both)

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Set All Tracks Targeted

Set Anti Alias Quality

Set the anti-alias quality on a clip's Motion effect (useful for scaled/rotated clips).

Enable (true) or disable (false) anti-aliasing

Node ID of the clip

Failure detail when ok is false.

The registered MCP tool name.

Set Anti Alias Quality

Set Blend Mode

Set the blend mode on a video clip. Uses the Opacity effect's Blend Mode property.

Blend mode name

Normal
Dissolve
Darken
Multiply
Color Burn
Linear Burn
Darker Color
Lighten
Screen
Color Dodge
Linear Dodge
Lighter Color
Overlay
Soft Light
Hard Light
Vivid Light
Linear Light
Pin Light
Hard Mix
Difference
Exclusion
Subtract
Divide
Hue
Saturation
Color
Luminosity

Node ID of the video clip

Failure detail when ok is false.

The registered MCP tool name.

Set Blend Mode

Set Clip Anchor Point

Set the Anchor Point property on a video clip's Motion effect.

Node ID of the clip

Anchor point X in pixels

Anchor point Y in pixels

Failure detail when ok is false.

The registered MCP tool name.

Set Clip Anchor Point

Set Clip Opacity

Set the opacity of a video clip (0-100).

Node ID of the clip

Opacity value (0 = transparent, 100 = fully opaque)

Failure detail when ok is false.

The registered MCP tool name.

Set Clip Opacity

Set Clip Pan

Set and read back the pan (left/right balance) on an audio clip, including Channel Volume layouts.

Node ID of the audio clip

Pan value (-100 = full left, 0 = center, 100 = full right)

Failure detail when ok is false.

The registered MCP tool name.

Set Clip Pan

Set Clip Position

Set the Position property on a video clip's Motion effect. Values are in pixels.

Node ID of the clip

X position in pixels

Y position in pixels

Failure detail when ok is false.

The registered MCP tool name.

Set Clip Position

Set Clip Properties

Set supported clip properties (opacity, scale, position, rotation). Clip speed is unsupported and fails before mutation.

Node ID of the clip

Opacity value (0-100)

Horizontal position

Vertical position

Rotation in degrees

Scale percentage (100 = original size)

Unsupported by Premiere's public scripting APIs. Supplying this returns an actionable error without mutating the clip.

Failure detail when ok is false.

The registered MCP tool name.

Set Clip Properties

Set Clip Properties Batch

Apply Motion/Opacity values to up to 16 clips after preflighting every target property. The handler reads each requested value back and never reports a partial batch as verified.

Each item changes one or more supported opacity, Motion scale, position, or rotation values.

Timeline clip node ID.

Opacity percentage.

Motion horizontal position in sequence pixels.

Motion vertical position in sequence pixels.

Motion rotation in degrees.

Motion scale percentage.

Unsupported; supplying it fails before any clip is changed.

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Set Clip Properties Batch

Set Clip Rotation

Set the Rotation property on a video clip's Motion effect.

Rotation in degrees (0-360, can exceed for multiple rotations)

Node ID of the clip

Failure detail when ok is false.

The registered MCP tool name.

Set Clip Rotation

Set Clip Scale

Set the Scale property on a video clip's Motion effect.

Node ID of the clip

Scale value (100 = original size, 200 = 2x, 50 = half)

Failure detail when ok is false.

The registered MCP tool name.

Set Clip Scale

Set Clip Selection

Select or deselect a clip in the active sequence

Node ID of the clip

True to select, false to deselect

Failure detail when ok is false.

The registered MCP tool name.

Set Clip Selection

Set Clip Speed Qe

Unavailable: Premiere does not expose a supported scripting API for changing a timeline clip's speed.

Node ID of the clip

Reverse playback direction (default: false)

Speed as percentage (100 = normal, 200 = 2x, 50 = half speed)

Failure detail when ok is false.

The registered MCP tool name.

Set Clip Speed Qe

Set Clip Start Time

Set the start time (timecode offset) of a project item. This shifts where timecode begins for the source media.

Node ID or name of the project item

New start time in seconds

Failure detail when ok is false.

The registered MCP tool name.

Set Clip Start Time

Set Clip Volume

Set an audio clip's Volume > Level in dB. Does not read or change Essential Sound Amplify automation.

Node ID of the audio clip

Volume in dB (0 = unity, negative = quieter, positive = louder)

Failure detail when ok is false.

The registered MCP tool name.

Set Clip Volume

Set Clips Volume

Set the volume (in dB) on every audio clip of a track, or on a list of clip indices. One round trip instead of one call per clip - essential for sequences with dozens of clips.

Optional clip indices on that track. Omit to apply to all clips.

Audio track index (0-based)

Volume in dB applied to every selected clip (0 = unity, max +15)

Failure detail when ok is false.

The registered MCP tool name.

Set Clips Volume

Set Color Label

Set the color label on a project item or clip

Node ID or name of the project item

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Set Color Label

Set Color Value

Set a color value on an effect property (e.g., tint color, fill color)

Alpha (0-255)

Blue (0-255)

Name of the component/effect

Green (0-255)

Node ID of the clip

Name of the color property

Red (0-255)

Failure detail when ok is false.

The registered MCP tool name.

Set Color Value

Set Effect Property

Set the value of a specific effect property on a clip

Display name of the effect (e.g., 'Motion', 'Opacity')

Node ID of the clip

Display name of the property (e.g., 'Scale', 'Position', 'Opacity')

Number or string value to set. Use the exact JSON string reported for a MOGRT text or graphic parameter.

Failure detail when ok is false.

The registered MCP tool name.

Set Effect Property

Set Footage Interpretation

Set footage interpretation settings for a project item

Override frame rate

Node ID or name of the project item

Pixel aspect ratio (1.0 = square pixels)

Failure detail when ok is false.

The registered MCP tool name.

Set Footage Interpretation

Set Frame Blend

Enable or disable frame blending on a clip. Uses QE DOM.

True to enable frame blending, false to disable

Node ID of the clip

Failure detail when ok is false.

The registered MCP tool name.

Set Frame Blend

Set Graphics White Luminance

Set the graphics white luminance value (HDR setting) for the project

White luminance value in nits

Failure detail when ok is false.

The registered MCP tool name.

Set Graphics White Luminance

Set Item In Out

Set in and/or out points on a project item in the project panel (marks source range for editing).

In point in seconds

Node ID or name of the project item

Media type: 1=video, 2=audio, 4=all (default: 4)

Out point in seconds

Failure detail when ok is false.

The registered MCP tool name.

Set Item In Out

Set Keyframe Interpolation

Set the interpolation type of a keyframe (Linear, Hold, or Bezier)

Display name of the effect

Interpolation type

Node ID of the clip

Display name of the property

Time in seconds of the keyframe

Failure detail when ok is false.

The registered MCP tool name.

Set Keyframe Interpolation

Set Metadata

Replace project metadata XML on a project item and verify the exact readback. Partial field/value writes are intentionally rejected because Premiere requires a complete Project Metadata XML payload.

Legacy partial-write argument. It is no longer executed because it cannot form a valid Project Metadata XML payload; use metadata_xml and updated_fields instead.

Node ID or name of the project item

Complete Project Metadata XML previously read from get_metadata, with the intended field values applied.

Exact Project Metadata field paths changed in metadata_xml (for example, Column.Intrinsic.Description).

Legacy partial-write argument. It is no longer executed; read projectMetadata first, update the complete XML, then supply metadata_xml and updated_fields.

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Set Metadata

Set Offline

Set a project item offline, or ask Premiere to refresh it back online when offline is false.

Node ID or name of the project item

true to take media offline (default); false to refresh an existing offline item

Failure detail when ok is false.

The registered MCP tool name.

Set Offline

Set Override Frame Rate

Override the frame rate of a project item (useful for image sequences or misinterpreted media)

Frame rate to set (e.g., 23.976, 24, 29.97, 30, 60)

Node ID or name of the project item

Failure detail when ok is false.

The registered MCP tool name.

Set Override Frame Rate

Set Override Pixel Aspect Ratio

Override the pixel aspect ratio of a project item

PAR denominator (e.g., 1 for square pixels)

Node ID or name of the project item

PAR numerator (e.g., 1 for square pixels)

Failure detail when ok is false.

The registered MCP tool name.

Set Override Pixel Aspect Ratio

Set Playhead Position

Set the playhead (CTI) position in the active sequence

Time position in seconds to move the playhead to

Failure detail when ok is false.

The registered MCP tool name.

Set Playhead Position

Set Poster Frame

Set the poster frame (thumbnail) for a project item at a specific time.

Node ID or name of the project item

Time in seconds for the poster frame

Failure detail when ok is false.

The registered MCP tool name.

Set Poster Frame

Set Project Item Audio Channel Mapping

Map one output audio channel of a project item to a source channel using Premiere's documented AudioChannelMapping API.

Zero-based output channel index to configure

Project item node ID or exact name

Zero-based source channel index to map

Failure detail when ok is false.

The registered MCP tool name.

Set Project Item Audio Channel Mapping

Set Project Panel Metadata

Set the project panel metadata/column configuration from XML and verify that Premiere reads back the exact XML

XML string containing the project panel metadata configuration

Failure detail when ok is false.

The registered MCP tool name.

Set Project Panel Metadata

Set Project Scratch Disk

Set the project's scratch disk paths for captured video, audio, and previews.

Path for audio previews

Path for captured audio

Path for captured video

Path for video previews

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Set Project Scratch Disk

Set Scale To Frame Size

Enable 'Scale to Frame Size' on a project item so it fills the sequence frame

Node ID or name of the project item

Failure detail when ok is false.

The registered MCP tool name.

Set Scale To Frame Size

Set Scale Width Height

Set independent Scale Width and Scale Height on a clip (requires Uniform Scale to be OFF).

Node ID of the clip

Scale height percentage

Scale width percentage

Failure detail when ok is false.

The registered MCP tool name.

Set Scale Width Height

Set Scratch Disk Path

Set the scratch disk path for a specific media type

Full directory path for the scratch disk

Type: 'capturedVideo', 'capturedAudio', 'videoPreview', 'audioPreview', 'autoSave', 'ccLibraries'

Failure detail when ok is false.

The registered MCP tool name.

Set Scratch Disk Path

Set Sequence Audio Settings

Change audio settings of the active sequence (sample rate, channel type).

Channel type: 0=Mono, 1=Stereo, 2=5.1, 3=Multichannel

Audio sample rate (e.g., 44100, 48000, 96000)

Failure detail when ok is false.

The registered MCP tool name.

Set Sequence Audio Settings

Set Sequence Display Format

Set the timecode display format for the active sequence.

Audio: 0=Audio Samples, 1=Milliseconds

Video: 0=24 Timecode, 1=25 Timecode, 2=29.97 Drop-frame, 3=29.97 Non-drop-frame, 4=30 Timecode, 5=50 Timecode, 6=59.94 Drop-frame, 7=59.94 Non-drop-frame, 8=60 Timecode, 9=Frames, 10=Feet+Frames 16mm, 11=Feet+Frames 35mm

Failure detail when ok is false.

The registered MCP tool name.

Set Sequence Display Format

Set Sequence Field Type

Set the field order of the active sequence.

0=No Fields (Progressive), 1=Upper Field First, 2=Lower Field First

Failure detail when ok is false.

The registered MCP tool name.

Set Sequence Field Type

Set Sequence Frame Rate

Change the frame rate of the active sequence.

New frame rate (e.g., 23.976, 24, 25, 29.97, 30, 50, 59.94, 60)

Failure detail when ok is false.

The registered MCP tool name.

Set Sequence Frame Rate

Set Sequence In Out Points

Set the sequence in and out points (for export range, etc.)

In-point in seconds

Out-point in seconds

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Set Sequence In Out Points

Set Sequence Pixel Aspect Ratio

Change the pixel aspect ratio of the active sequence, or return a capability error when the legacy host does not expose a writable setting.

Pixel aspect ratio string (for example '1.0' for square pixels or '1.4222' for 16:9 DV).

Failure detail when ok is false.

The registered MCP tool name.

Set Sequence Pixel Aspect Ratio

Set Sequence Resolution

Change the resolution (frame size) of the active sequence.

Height in pixels

Width in pixels

Failure detail when ok is false.

The registered MCP tool name.

Set Sequence Resolution

Set Sequence Settings

Modify and read back sequence frame-size settings.

Frame height in pixels

Sequence name or ID. Uses active sequence if omitted.

Frame width in pixels

Failure detail when ok is false.

The registered MCP tool name.

Set Sequence Settings

Set Source In Out

Set in and/or out points on the clip currently open in the Source Monitor.

In point in seconds (optional)

Out point in seconds (optional)

Failure detail when ok is false.

The registered MCP tool name.

Set Source In Out

Set Start Time

Set the start time (timecode offset) for a project item

Node ID or name of the project item

Start time in seconds

Failure detail when ok is false.

The registered MCP tool name.

Set Start Time

Set Target Track

Set a track as targeted (active for insert/overwrite edits). Only one video and one audio track can be targeted at a time.

Whether to target (true) or untarget (false) the track

Track index (0-based)

Track type

Failure detail when ok is false.

The registered MCP tool name.

Set Target Track

Set Time Interpolation

Set time interpolation type for a clip (Frame Sampling, Frame Blending, Optical Flow). Uses QE DOM.

0 = Frame Sampling, 1 = Frame Blending, 2 = Optical Flow

Node ID of the clip

Failure detail when ok is false.

The registered MCP tool name.

Set Time Interpolation

Set Transcode On Ingest

Enable or disable transcoding on ingest for the project

True to enable transcode on ingest, false to disable

Failure detail when ok is false.

The registered MCP tool name.

Set Transcode On Ingest

Set Uniform Scale

Toggle uniform scale on a clip's Motion effect. When enabled, Scale Width and Scale Height are linked.

Node ID of the clip

true for uniform (linked), false for non-uniform (independent width/height)

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Set Uniform Scale

Set Work Area

Set the work area (bar) in and out points

Work area in-point in seconds

Work area out-point in seconds

Failure detail when ok is false.

The registered MCP tool name.

Set Work Area

Set Workspace

Switch to a specific workspace layout (e.g., 'Editing', 'Color', 'Audio', 'Effects', 'Graphics')

Name of the workspace to activate (use get_workspaces to see available options)

Failure detail when ok is false.

The registered MCP tool name.

Set Workspace

Set Xmp Metadata

Merge a raw XMP XML patch into a project item's existing XMP metadata without removing unrelated fields.

Node ID or name of the project item

Well-formed XMP XML containing only the fields to add or replace

Failure detail when ok is false.

The registered MCP tool name.

Set Xmp Metadata

Set Zero Point

Set the starting timecode (zero point) of a sequence

Sequence name or ID. Uses active sequence if omitted.

Start time in seconds for the timecode origin

Failure detail when ok is false.

The registered MCP tool name.

Set Zero Point

Setup Ducking

Build a verified Volume > Level keyframe curve for one audio clip. Ducking-window times are relative to that clip's start; overlapping or out-of-range windows are rejected before any keyframe write.

Normal clip level in dB (defaults to 0).

Non-overlapping windows during which this clip should be quieter.

Level during the window, in dB.

Window end, relative to clip start.

Window start, relative to clip start.

Fade length on each side of a window in seconds (defaults to 0.2).

Timeline audio-clip node ID.

Failure detail when ok is false.

The registered MCP tool name.

Setup Ducking

Slide Edit

Perform a verified slide edit on a clip using adjacent clips from the public timeline DOM.

Node ID of the clip

Offset in seconds (positive = slide right, negative = slide left)

Failure detail when ok is false.

The registered MCP tool name.

Slide Edit

Slip Edit

Perform a verified slip edit on a clip using public source in/out properties.

Node ID of the clip

Offset in seconds (positive = slip forward in source, negative = slip backward)

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Slip Edit

Speed Change

Unavailable: Premiere does not expose a supported scripting API for changing a timeline clip's speed.

Node ID of the clip

Reverse playback direction (default: false)

Speed as percentage (100 = normal, 200 = double, 50 = half)

Failure detail when ok is false.

The registered MCP tool name.

Speed Change

Split Clip

Split every clip on one track that spans a timeline time, then verify both resulting boundaries. Requires QE DOM; effect-keyframe redistribution remains unverified.

Timeline time in seconds where clips on the selected track will split

Track index (0-based, default: 0)

Track type (default: video)

Failure detail when ok is false.

The registered MCP tool name.

Split Clip

Stabilize Clip

Apply the Warp Stabilizer effect to a clip for video stabilization. Uses QE DOM.

Stabilization method (default: 'Subspace Warp')

Subspace Warp
Position
Position, Scale, Rotation

Node ID of the clip to stabilize

Stabilization smoothness percentage (default: 50). Higher = smoother but more cropping.

Failure detail when ok is false.

The registered MCP tool name.

Stabilize Clip

Start Batch Encode

Request Adobe Media Encoder to start the render queue; reports only accepted handoff, not queue progress or output-file creation.

Failure detail when ok is false.

The registered MCP tool name.

Start Batch Encode

Stop Playback

Request that active-sequence timeline playback stop through QE. The legacy API does not provide a same-call playhead readback, so stopped state is not reported as verified.

Failure detail when ok is false.

The registered MCP tool name.

Stop Playback

Toggle Track Visibility

Toggle a video track's visibility (eye icon)

Video track index (0-based)

True to show, false to hide

Failure detail when ok is false.

The registered MCP tool name.

Toggle Track Visibility

Trim Clip

Trim exactly one source in/out point and verify the corresponding visible timeline edge. Refuses retimed clips and, by default, trims that would leave effect keyframes outside the visible clip.

How to handle effect keyframes beyond the trimmed visible range: reject (default) leaves the timeline unchanged; preserve explicitly keeps them and reports their count.

New source in-point in seconds (relative to the clip's source media). Specify exactly one edit point.

New source out-point in seconds (relative to the clip's source media). Specify exactly one edit point.

Node ID of the clip to trim

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Trim Clip

undo

Undo

Undo the last action in Premiere Pro

Number of times to undo (default: 1)

Failure detail when ok is false.

The registered MCP tool name.

Undo

Unlink Selection

Unlink the currently selected video and audio clips in the active sequence

Failure detail when ok is false.

The registered MCP tool name.

Unlink Selection

Unnest Sequence

Unnest a nested sequence on the timeline, replacing it with the contents of the nested sequence

Node ID of the nested sequence clip on the timeline to unnest

Failure detail when ok is false.

The registered MCP tool name.

Unnest Sequence

Update Marker

Update an existing marker's properties

New color index

New comments

New name

Time position of the marker to update

Failure detail when ok is false.

The registered MCP tool name.

Update Marker

Validate Cmx3600 Edl

Validate a local CMX 3600 EDL's supported event grammar, timecodes, durations, duplicate event IDs, record overlaps, and record gaps before user-assisted Premiere interchange.

CMX timecode rate: 24, 25, 29.97, 30, 50, 59.94, or 60 (default: 24)

Existing local .edl file

Failure detail when ok is false.

The registered MCP tool name.

Validate Cmx3600 Edl

Validate Export Preset

Validate that an Adobe Media Encoder .epr preset exists and ask the active Premiere sequence which output extension it produces

Full path to an Adobe Media Encoder export preset (.epr)

Failure detail when ok is false.

The registered MCP tool name.

Validate Export Preset

Validate Project For Export

Run a non-mutating export readiness audit for an active or named sequence. It reports blocking offline media, empty timelines, inaccessible preset/output paths, duration, and optional timeline gaps without queuing an export.

Report gaps on populated tracks as warnings (defaults to true).

Optional intended delivery path; its parent folder is checked.

Optional .epr preset path to check.

Treat an empty sequence as a blocking error (defaults to true).

Sequence ID or name. Defaults to the active sequence.

Failure detail when ok is false.

The registered MCP tool name.

Validate Project For Export

Verify Delivery Conformance

Verify a local exported file against an explicit delivery contract using ffprobe and optional EBU R128 analysis. Returns pass, fail, or not_evaluated per check; it does not prove Premiere render lineage or visual approval.

Allowed ffprobe demuxer-family aliases, such as mov or mp4. This cannot distinguish exact subtypes when ffprobe reports a shared alias family.

Expected audio channel count

Expected audio codec name, such as aac or pcm_s24le

Expected audio sample rate

Expected duration in seconds

Allowed absolute duration difference (default: 0.05)

Expected frames per second; rational ffprobe rates are compared numerically

Allowed absolute frame-rate difference (default: 0.001)

Expected video height in pixels

Allowed absolute loudness difference (default: 1 LU)

Optional maximum true peak from -100 through 0 dBFS

Optional maximum selected-video-stream bitrate in kilobits per second

Optional minimum selected-video-stream bitrate in kilobits per second

Existing local delivery file

Optional integrated loudness target from -100 through 0 LUFS

Expected video codec name, such as h264 or prores

Expected video width in pixels

Tool-specific result data when ok is true.

Failure detail when ok is false.

Whether the tool completed successfully.

The registered MCP tool name.

Verify Delivery Conformance

Verify Delivery File

Verify that an exported delivery is a non-empty regular file and calculate a SHA-256 or SHA-512 checksum; optionally compare expected size and checksum

Checksum algorithm (default: sha256)

Optional expected hexadecimal checksum to compare

Optional exact expected file size in bytes

Minimum acceptable file size in bytes (default: 1)

Full path to the exported delivery file

Failure detail when ok is false.

The registered MCP tool name.

Verify Delivery File

Verify Fcpxml Media References

Verify FCPXML file:// media references only inside caller-approved existing roots. References outside those roots are never statted or exposed as local paths.

One to sixteen existing absolute roots that may be inspected

Existing local .fcpxml or .xml file

Failure detail when ok is false.

The registered MCP tool name.

Verify Fcpxml Media References

Verify Premiere Connection

Run a safe, read-only first-run check. It proves that this MCP server, the selected Premiere bridge, an active project, and an active sequence are connected without returning project names, paths, or media details.

Bridge to check. Defaults to CEP. This check never falls back to a different bridge.

Failure detail when ok is false.

The registered MCP tool name.

Verify Premiere Connection