Conversions across 221 color spaces, tested against cited sources: CSS strings, gamut, LUTs
Premiere is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
What it does
Adobe Premiere Pro for AI agents: 660+ tools; edits are read back, and unchecked ones say so.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user premiere-mcp '--' npx -y premiere-mcp
# 2 — ask your agent for something these tools do
# edit_music_video, color_grade_footage, multicam_editing and 497 more
Premiere costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. This one runs on your machine: your client starts Premiere as a process under your own user, with your files and your network, so the tool surface below is what it can do to your computer rather than to a server somewhere else. Its scan result is on the Security tab — read the surface before you approve it.
This is a public server: you run it yourself and this marketplace is not in the path. You need Node.js — the current LTS (24) is the safe choice; npx comes with it. Claude Code registers it in one command; --scope user makes it available in every project. The '--' is in quotes so that PowerShell passes it on.
claude mcp add --scope user premiere-mcp '--' npx -y premiere-mcpReconnect, or start a new session, and the tools appear in the model’s tool list.
One config entry your client uses to start the process locally. A local server runs with your file system and your network, which is why it is priced without metering.
500 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
Read from its source code. A server that builds its tool list when it starts can list more tools than this.
Tool-chain workflow for a beat-driven cut: mark the beats, build the sequence from those markers, then verify the cut lands where the markers are
No parameter schema on file.
Tool-chain workflow for a numeric Lumetri grade, read back and propagated — with scopes and a real composited frame as the check, not eyeballing a claim
No parameter schema on file.
Tool-chain workflow to sync multiple angles into a multicam sequence and cut between them, verifying sync rather than assuming it
No parameter schema on file.
Tool-chain workflow for a dialogue edit: silence removal, loudness to spec, ducking, and captions — every step measured
No parameter schema on file.
Tool-chain workflow to cut down and reframe for a vertical/square platform, with a platform export preset and a real frame check
No parameter schema on file.
Tool-chain workflow for a transcript-driven documentary assembly: index and log the material, string out selects, then structure
No parameter schema on file.
Tool-chain workflow for a spot: exact-duration cut, graphics, grade, and a broadcast-spec delivery check
No parameter schema on file.
Tool-chain workflow to diagnose and speed up a heavy project: find what is broken or wasteful, then fix it with proxies, cache and consolidation
No parameter schema on file.
Tool-chain workflow to repair and deliver audio: measure the problem, apply the matching repair, then re-measure to prove it improved
No parameter schema on file.
The first 90 seconds on an unfamiliar host: prove the bridge and the engine, orient in the project, make one small edit, verify it by readback, undo it, and report what was proven
No parameter schema on file.
What to do when a tool returns verified:false, a call times out, or Premiere stops answering: classify the failure, check independently whether the edit landed, roll back deliberately, and report the honest state
No parameter schema on file.
Tool-chain workflow to conform a sequence to a delivery spec and ship it: settings mismatches first, media health second, picture and audio QC third, then an export that is probed before it is called delivered
No parameter schema on file.
Tool-chain workflow to caption a sequence: transcribe to a file, edit the cues where they are actually editable (on disk), validate, ingest, then prove the caption track exists
No parameter schema on file.
Tool-chain workflow to add an effect or a motion move to a clip: identify the clip, add by matchName, learn the real parameter names, set values, ease the keyframes, and prove the FRAME changed rather than just the DOM
No parameter schema on file.
Tool-chain workflow to bring review notes into a sequence as markers, reconcile every one against the source list, and send the state back out — plus the review reel a human actually watches
No parameter schema on file.
Lists the media items, sequences and bins in the project, a page at a time (200 by default) so a big show project does not flood the reply. Filter by name, type or bin; nextOffset gets the next page.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| includeBins | boolean | no | Whether to include bin information in the results |
| includeMetadata | boolean | no | Whether to include detailed metadata for each item |
| limit | number | no | Items per page (default 200, max 2000) |
| offset | number | no | Start of the page; use nextOffset from the previous reply |
| nameContains | string | no | Only items whose name contains this (case-insensitive) |
| type | string | no | Only footage or only sequences |
| binPath | string | no | Only items inside this bin, e.g. "Renders/SH010" |
Lists all sequences in the current Premiere Pro project with their IDs, names, and basic properties.
No parameter schema on file.
Lists all video and audio tracks in a specific sequence with their properties and clips.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Gets comprehensive information about the current project including name, path, settings, and status.
No parameter schema on file.
Read-only readiness check for the live CEP bridge and Premiere Pro host. Run this before an editing workflow to confirm the bridge responds and report the Premiere version, project, and active sequence without changing the project.
No parameter schema on file.
Reports the local MCP runtime, installed bridge status, tool/resource/prompt catalog sizes, and supported versus experimental integration surfaces. Set checkConnection to true to run the read-only live Premiere connection check; otherwise no Premiere request is made. Set probeLocalTools to true to…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| checkConnection | boolean | no | — |
| probeLocalTools | boolean | no | — |
Runs a non-destructive export readiness audit for the active or requested sequence. Checks timeline content, offline media, missing export preset/output folder inputs, gaps, markers, and basic audio/video track state before an agent queues an export.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | Optional sequence ID to validate. Defaults to the active sequence. |
| outputPath | string | no | — |
| presetPath | string | no | — |
| requireNonEmptyTimeline | boolean | no | When true, an empty timeline is an error. Defaults to true. |
| checkGaps | boolean | no | When true, timeline gaps are reported as warnings. Defaults to true. |
Discovers readable user Adobe Media Encoder .epr presets from local AME preset folders. Factory preset enumeration is not claimed complete.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| directories | array | no | — |
Generates clean demo stills, creates a sequence, lays the shots out on the timeline, adds dissolves, and applies subtle scale animation for a polished minimalist ad-style demo.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceName | string | no | Optional sequence name. Defaults to "Apple Like Motion Demo". |
Builds a production-oriented promo timeline from real media assets. Supports either template defaults or an explicit clipPlan for LLM-directed pacing, transitions, motion, trims, and per-clip effects.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceName | string | yes | Name for the new sequence |
| assetPaths | array | yes | Absolute paths to video or image assets in playback order |
| clipDuration | number | no | — |
| videoTrackIndex | number | no | Target video track index. Defaults to 0 |
| transitionName | string | no | — |
| transitionDuration | number | no | Transition duration in seconds. Defaults to 0.5 |
| motionStyle | no | — | |
| clipPlan | array | no | — |
Builds a branded ad assembly from real media assets, supports optional MOGRT overlay, and allows explicit clipPlan control. Default polish is optional so creative direction can come from LLM planning instead of hardcoded passes.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceName | string | yes | Name for the new sequence |
| assetPaths | array | yes | Absolute paths to source assets in edit order |
| mogrtPath | string | no | Optional absolute path to a .mogrt title or branding template |
| clipDuration | number | no | Default spacing in seconds for asset placement. Defaults to 4.0 |
| videoTrackIndex | number | no | Base video track for the main assets. Defaults to 0 |
| titleTrackIndex | number | no | Video track for the optional MOGRT overlay. Defaults to 1 |
| titleStartTime | number | no | Timeline start time in seconds for the optional MOGRT. Defaults to 0.4 |
| transitionName | string | no | — |
| transitionDuration | number | no | Transition duration in seconds. Defaults to 0.5 |
| motionStyle | no | — | |
| clipPlan | array | no | — |
| applyDefaultPolish | boolean | no | — |
Creates a new Adobe Premiere Pro project. Use this when the user wants to start a new video editing project from scratch.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | yes | The name for the new project, e.g., "My Summer Vacation" |
| location | string | yes | — |
Opens an existing Adobe Premiere Pro project from a specified file path.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| path | string | yes | The absolute path to the .prproj file to open |
Saves the currently active Adobe Premiere Pro project.
No parameter schema on file.
Saves the current project with a new name and location.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | yes | The new name for the project |
| location | string | yes | The absolute directory path where the project should be saved |
Closes the current project. Verified: reports whether the project was saved before closing.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| saveFirst | boolean | no | Save the project before closing. Default false. |
| closeIfLast | boolean | no | Close Premiere if this is the last open project. Default false. |
Lists all currently open Premiere Pro projects with their names, paths, and sequence counts. Verified via app.projects collection.
No parameter schema on file.
Lists recently modified Premiere Pro project files on disk, sorted by modification time. Excludes Auto-Save copies. Uses Spotlight (mdfind) — returns paths, names, and modification dates.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| limit | number | no | Maximum number of results. Default 10. |
| excludeAutosave | boolean | no | Exclude Adobe Premiere Pro Auto-Save files. Default true. |
Reads the current macOS system clipboard as text. Useful for reading timecodes, clip names, or any text the user copied. Verified via Node.js pbpaste.
No parameter schema on file.
Writes text to the macOS system clipboard. Useful for exporting timecodes, marker lists, clip metadata, or any text for pasting elsewhere. Verified via Node.js pbcopy.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| text | string | yes | The text to write to the clipboard |
Returns the render bar status of the active sequence: which time ranges are fully rendered (green), partially rendered (yellow), unrendered (red), or empty (no content). Verified via QE getGreenBarTimes/getRedBarTimes/getYellowBarTimes.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | Sequence ID. Defaults to the active sequence. |
Renders preview files for the active sequence's unrendered segments (equivalent to Sequence > Render In to Out). Uses QE renderPreview(). Does not export media — writes to the preview cache only.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | Sequence ID. Defaults to the active sequence. |
| renderAll | boolean | no | — |
Assigns an Essential Sound category to a project item. Categories: "dialog", "music", "sfx", "ambience". Verified: setProjectMetadata writes ESP.Tag and related keys. The panel will reflect the category after the next project refresh.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | The nodeId of the project item to categorize |
| category | string | yes | The Essential Sound category |
Opens a project item in the Source Monitor by passing the DOM ProjectItem directly. More reliable than open_in_source which uses file paths. Optionally cues to a timecode. Verified via app.sourceMonitor.openProjectItem().
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | The nodeId of the project item to open in the Source Monitor |
| timecode | string | no | Optional timecode to cue to after opening (e.g. "00:00:01:00") |
Moves the playhead to the start of the active sequence (frame 0). Verified via setPlayerPosition.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Moves the playhead to the last frame of the active sequence. Verified via setPlayerPosition + sequence end time.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Moves the playhead to the sequence in-point.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Moves the playhead to the sequence out-point.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Moves the playhead by a number of frames (positive = forward, negative = backward). Verified via setPlayerPosition.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| frames | number | yes | Frames to step. Positive = forward, negative = backward. |
| sequenceId | string | no | — |
Returns whether the timeline is currently playing, the playback speed, and the current playhead position.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Ripple-trims the head of a clip to the current playhead (Q-key equivalent): removes the material before the playhead, keeps the clip where it starts, and moves everything after it left on every track so sync holds. Linked audio is trimmed with it. Refuses if the playhead is outside the clip or a…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | yes | 0-based video track index |
| clipIndex | number | yes | 0-based clip index on the track |
Ripple-trims the tail of a clip to the current playhead (W-key equivalent): removes the material after the playhead and moves everything later left on every track so sync holds. Linked audio is trimmed with it. Verified by start/end/in readback.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | yes | 0-based video track index |
| clipIndex | number | yes | 0-based clip index on the track |
Moves the nearest edit point of the clip to the current playhead (E-key equivalent). An abutting neighbour is rolled so no gap or overlap opens; linked audio/video moves with it. Refuses when the media has no handle left (extending past the media would play black). Verified by start/end/in readback.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | yes | 0-based video track index |
| clipIndex | number | yes | 0-based clip index whose nearest edge to extend |
Nudges a clip and its linked audio/video ±N frames on the timeline (Alt+Left/Right equivalent). Refuses when the destination is occupied. Verified by start readback of every linked item.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | yes | 0-based video track index |
| clipIndex | number | yes | 0-based clip index |
| frames | number | yes | Frames to nudge. Positive = forward, negative = backward. |
Creates a J-cut: the linked audio of clip N starts the given number of frames before its picture (audio leads video), rolling the audio edit so the previous audio clip gives up the same span. Refuses when the audio has no head handle. Verified by start/end/in readback.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| videoTrackIndex | number | yes | 0-based video track index |
| clipIndex | number | yes | 0-based index of the clip whose audio should lead |
| frames | number | yes | How many frames earlier the audio should start |
Creates an L-cut: the linked audio of clip N runs the given number of frames past its picture (audio trails video), rolling the audio edit so the next audio clip gives up the same span. Refuses when the audio has no tail handle. Verified by start/end/in readback.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| videoTrackIndex | number | yes | 0-based video track index |
| clipIndex | number | yes | 0-based index of the clip whose audio should trail |
| frames | number | yes | How many frames later the audio should end |
Classic 3-point edit: opens a source clip, sets source in/out, then inserts or overwrites at the sequence playhead. Verified: sourceMonitor.openProjectItem + setInPoint/setOutPoint confirmed working.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | Source clip nodeId |
| sourceIn | string | no | Source in-point timecode (e.g. "00:00:01:00") |
| sourceOut | string | no | Source out-point timecode |
| sequenceTimecode | string | no | Where to place in sequence. Defaults to current playhead. |
| mode | string | no | Edit mode. Default "overwrite". |
| videoTrackIndex | number | no | Target video track. Default 0. |
| audioTrackIndex | number | no | Target audio track. Default 0. |
Closes the gap containing a time by moving every later clip on every track left by the gap length. Only gaps empty on ALL video and audio tracks are closed, so sync holds; anything narrower is refused. Verified by reading back every moved clip start.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| timecode | string | yes | A time inside the gap: HH:MM:SS:FF, or a number of seconds |
| sequenceId | string | no | — |
Closes every gap that is empty on all tracks (the one before the first clip only with includeLeadingGap), latest first, by moving later clips left. Verified by rescanning for gaps and reading back every moved clip start.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | no | — |
| includeLeadingGap | boolean | no | — |
Removes all empty video and/or audio tracks from the active sequence. Verified via QE removeEmptyVideoTracks/removeEmptyAudioTracks.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| video | boolean | no | Remove empty video tracks. Default true. |
| audio | boolean | no | Remove empty audio tracks. Default true. |
Returns the currently selected clips in the active sequence timeline. Confirmed via Sequence.getSelection().
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Selects specific clips in the sequence timeline by track/clip index pairs. Confirms selection via getSelection() readback.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clips | array | yes | List of clips to select by track+clip index |
| sequenceId | string | no | — |
Creates a sequence marker at a given timecode with optional name, comment, type, and color. Uses the confirmed MarkerCollection.createMarker() API.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| timecode | number | yes | Marker time in seconds |
| name | string | no | Marker name |
| comment | string | no | Marker comment/notes |
| type | string | no | Marker type. Default Comment. |
| colorIndex | number | no | Color index 0-7 |
| durationSeconds | number | no | Duration in seconds for ranged markers |
| sequenceId | string | no | — |
Sets Lumetri Color basic correction values on a clip: exposure, contrast, highlights, shadows, whites, blacks, temperature, tint, saturation. Verified via param readback.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | no | Video track index, default 0 |
| clipIndex | number | no | Clip index on track, default 0 |
| exposure | number | no | -5 to 5 |
| contrast | number | no | -100 to 100 |
| highlights | number | no | -100 to 100 |
| shadows | number | no | -100 to 100 |
| whites | number | no | -100 to 100 |
| blacks | number | no | -100 to 100 |
| temperature | number | no | -100 to 100 |
| tint | number | no | -100 to 100 |
| saturation | number | no | 0 to 200, default 100 |
Sets Lumetri Color creative adjustments: faded film, sharpen, vibrance, saturation.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | no | — |
| clipIndex | number | no | — |
| fadedFilm | number | no | 0 to 100 |
| sharpen | number | no | 0 to 100 |
| vibrance | number | no | -100 to 100 |
| saturation | number | no | 0 to 200 |
Sets Lumetri Color vignette: amount, midpoint, roundness, feather.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | no | — |
| clipIndex | number | no | — |
| amount | number | no | -10 to 10 |
| midpoint | number | no | 0 to 100 |
| roundness | number | no | -100 to 100 |
| feather | number | no | 0 to 100 |
Reads all named Lumetri Color parameter values from a clip and returns them as JSON. Useful for copying grades.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | no | — |
| clipIndex | number | no | — |
Copies the full Lumetri Color grade state from a source clip and returns it as a JSON blob for use with paste_grade_to_clips.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | no | Source video track, default 0 |
| clipIndex | number | no | Source clip index, default 0 |
Pastes a Lumetri grade (from copy_grade) to one or more target clips specified by track/clip index pairs.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| gradeJson | string | yes | JSON string from copy_grade containing param indices and values |
| targets | array | yes | Target clips |
| sequenceId | string | no | — |
Triggers Lumetri auto white balance on a clip by setting the Auto Tone Analytics Data param with mAutoTonePressed:true.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | no | — |
| clipIndex | number | no | — |
Sets the project-wide LUT interpolation method. 0=linear, 1=tetrahedral (default). Verified via getLUTInterpolationMethod readback.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| method | number | yes | 0=linear, 1=tetrahedral |
Flips a clip horizontally by applying the Horizontal Flip effect. Verified by component readback; a clip already carrying the effect is reported as already flipped.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | no | — |
| clipIndex | number | no | — |
Flips a clip vertically by applying the Vertical Flip effect. Verified by component readback; a clip already carrying the effect is reported as already flipped.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | no | — |
| clipIndex | number | no | — |
Adds an opacity fade-in to a clip: keyframe at 0% at the clip start, 100% at the specified frame offset. Verified via keyframe readback.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | no | — |
| clipIndex | number | no | — |
| durationFrames | number | yes | Number of frames for the fade-in |
Adds an opacity fade-out to a clip: 100% at durationFrames before the end, 0% at the last frame. Verified via keyframe readback.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | no | — |
| clipIndex | number | no | — |
| durationFrames | number | yes | Number of frames for the fade-out |
Resets all Motion component properties (position, scale, rotation, anchor) to their defaults.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | no | — |
| clipIndex | number | no | — |
Copies all Motion component values from a source clip to one or more target clips.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| sourceTrackIndex | number | yes | Source video track |
| sourceClipIndex | number | yes | Source clip index |
| targets | array | yes | Target clips |
Applies letterbox bars by setting Motion component crop top/bottom values. Use aspect e.g. "2.39:1" or explicit cropPercent.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | no | — |
| clipIndex | number | no | — |
| aspect | string | no | Target aspect ratio e.g. "2.39:1", "2.35:1", "1.85:1" |
| cropPercent | number | no | Explicit crop percent for top AND bottom (0-50) |
Applies a Ken Burns (slow push/pan) effect by adding position and scale keyframes at the start and end of the clip.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | no | — |
| clipIndex | number | no | — |
| startScale | number | no | Scale at start, default 100 |
| endScale | number | no | Scale at end, default 110 |
| startX | number | no | X position at start (0.5=center), default 0.5 |
| startY | number | no | Y position at start (0.5=center), default 0.5 |
| endX | number | no | X position at end, default 0.5 |
| endY | number | no | Y position at end, default 0.5 |
Applies scale-to-frame-size to ONE clip via QE, confirmed by a qeClip.scaleToFrameSize readback. To normalise a whole track or a list of clips in a single call, use set_scale_to_frame_size_batch instead of looping this.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | no | — |
| clipIndex | number | no | — |
| enabled | boolean | no | Default true |
Applies scale-to-frame-size to MANY clips in one call — a whole video track, every video track, or an explicit clip-id list. Each clip is confirmed by a qeClip.scaleToFrameSize readback and reported individually in applied[]/failed[]/unverified[], so a partial result is visible rather than…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| enabled | boolean | no | — |
| sequenceId | string | no | Sequence to act on. Defaults to the active sequence. |
| trackIndex | number | no | 0-based video track index. Omit to cover EVERY video track in the sequence. |
| clipIds | array | no | — |
Adds a volume fade-in to an audio clip: keyframe at -∞ dB at start, 0 dB at durationFrames. Verified via keyframe readback.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| audioTrackIndex | number | no | Audio track index, default 0 |
| clipIndex | number | no | Clip index, default 0 |
| durationFrames | number | yes | Fade-in duration in frames |
Adds a volume fade-out to an audio clip. Verified via keyframe readback.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| audioTrackIndex | number | no | — |
| clipIndex | number | no | — |
| durationFrames | number | yes | Fade-out duration in frames |
Sets the clip gain (dB) on an audio clip. Distinct from the rubber-band volume. Verified via Level param readback.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| audioTrackIndex | number | no | — |
| clipIndex | number | no | — |
| gainDb | number | yes | Gain in dB, e.g. -6 to reduce by 6dB |
Adds a Constant Power audio crossfade at the out-point of the given audio clip. The transition is proven by readback — QE transition enumeration first, the transition count in an FCP XML export as a fallback — and a crossfade that did not appear is reported as a failure with the reason, not as an…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| audioTrackIndex | number | no | Audio track index, default 0 |
| clipIndex | number | yes | Index of the FIRST clip — transition goes between this and the next |
| durationFrames | number | no | Transition duration in frames, default 15 |
Mutes/unmutes the audio for a linked video clip by disabling its linked audio clip.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | no | Video track index, default 0 |
| clipIndex | number | no | Clip index, default 0 |
| mute | boolean | no | True to mute, false to unmute. Default true. |
Analyzes the loudness of a media file using ffmpeg ebur128 filter. Returns integrated LUFS, true peak, and LRA.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| filePath | string | yes | Absolute path to the audio/video file to analyze |
Analyzes a media file peak level and sets the clip gain to normalize to a target dBFS. Verified via gain readback.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| audioTrackIndex | number | no | — |
| clipIndex | number | no | — |
| targetDbfs | number | no | Target peak in dBFS, default -1 |
Exports only the in/out marked range of the active sequence using exportAsMediaDirect with work area mode.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| outputPath | string | yes | Absolute output file path |
| presetPath | string | yes | Absolute path to .epr preset file |
| sequenceId | string | no | — |
Returns the full catalog of AME export formats and their available presets (24 formats, 300+ presets). Verified via app.encoder.getExporters().
| Parameter | Type | Required | Notes |
|---|---|---|---|
| format | string | no | Filter to a specific format name e.g. "H.264". Returns all if omitted. |
Creates a custom AME export preset by taking a base preset and modifying specific params. Writes a .epr file. Returns the preset file path.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| format | string | yes | Exporter format name, e.g. "H.264", "QuickTime", "H.265 (HEVC)" |
| basePresetName | string | no | Base preset name to modify. Uses first preset if omitted. |
| params | object | yes | Params to set, e.g. {"TargetBitrate":"8","Width":"1920","Height":"1080"} |
| outputPresetPath | string | yes | Absolute path to write the .epr file |
Exports the active sequence using a named social media preset. Presets: youtube_1080p, youtube_4k, instagram_1080p, instagram_reels, tiktok, twitter.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| outputPath | string | yes | Absolute output file path |
| preset | string | yes | Social preset name |
| sequenceId | string | no | — |
Exports just the audio mix of the active sequence as WAV or AAC.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| outputPath | string | yes | Absolute output path (.wav or .aac) |
| format | string | no | Format, default wav |
| sequenceId | string | no | — |
Verifies an exported media file using ffprobe: checks duration, fps, resolution vs expected. Returns a QC pass/fail.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| filePath | string | yes | Absolute path to the exported file to verify |
| expectedDurationSecs | number | no | Expected duration in seconds (tolerance ±1s) |
| expectedFps | number | no | Expected frame rate |
| expectedWidth | number | no | — |
| expectedHeight | number | no | — |
Exports all sequence markers to a CSV file: time, name, comment, type, color. Verified via seq.markers enumeration.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| outputPath | string | yes | Absolute path to write the CSV file |
| sequenceId | string | no | — |
Creates sequence markers from a CSV file with columns: time (seconds), name, comment, type.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| csvPath | string | yes | Absolute path to a CSV file with columns: time,name,comment,type |
| sequenceId | string | no | — |
Adds a custom metadata column to the project schema. Type: 0=string, 1=integer, 2=real, 3=boolean. Verified via addPropertyToProjectMetadataSchema.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| columnId | string | yes | Unique column ID e.g. "mcp.shotCode" |
| displayName | string | yes | Column display name |
| type | number | no | 0=string (default) |
Sets a project metadata value on a project item by nodeId. Verified via setProjectMetadata.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | Project item nodeId |
| key | string | yes | Metadata key e.g. "mcp.shotCode" or built-in column ID |
| value | string | yes | Value to set |
Returns all project panel column values for a project item (name, label, media type, custom fields, etc.). Verified via getProjectColumnsMetadata.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | Project item nodeId |
Sets the color label on multiple project items at once.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemIds | array | yes | Array of project item nodeIds |
| labelColor | string | yes | Label color name e.g. "Iris", "Cerulean", "Lavender" |
Renames multiple project items by nodeId.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| renames | array | yes | — |
Assembles a gap-free review reel from a list of sequences. Creates a new sequence and overwrites each source sequence content sequentially. Critical for daily VFX review. Verified via sequence structure diff.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceIds | array | yes | Ordered list of sequence IDs to assemble |
| reelName | string | yes | Name for the new reel sequence |
| handles | number | no | Optional handle frames to add before/after each sequence |
Duplicates the active (or specified) sequence and bumps its version suffix (_v001 → _v002, or appends _v001). Returns the new sequence ID and name.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | Sequence to version up. Defaults to active sequence. |
| setActive | boolean | no | Set the new version as active. Default true. |
Returns a status board of all sequences in the project with their name, label color, track count, duration, and clip count.
No parameter schema on file.
Creates sequence markers from a newline-delimited notes file. Format per line: "HH:MM:SS:FF Note text" or "SS.ms Note text".
| Parameter | Type | Required | Notes |
|---|---|---|---|
| notesPath | string | yes | Absolute path to the notes text file |
| sequenceId | string | no | — |
| markerType | string | no | Default Comment |
| colorIndex | number | no | Color index 0-7 |
Exports all sequence markers to a formatted text file for sharing with directors/supervisors.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| outputPath | string | yes | Absolute path to write the notes file |
| sequenceId | string | no | — |
| format | string | no | Default text |
Runs a quick QC check on the active sequence: checks for offline media, reports unrendered ranges, checks for gaps, counts tracks. Returns a QC report.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Generates a VFX pull list from the active sequence: clip name, source path, source in/out TC, sequence in/out TC, duration, handles. Returns JSON array.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| handles | number | no | Handle frames to add each side, default 8 |
| trackIndex | number | no | Video track to pull from, default 0 |
Exports the active sequence as a cut list CSV: shot name, source TC in, source TC out, sequence TC in, sequence TC out, duration.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| outputPath | string | yes | Absolute path to write the CSV |
| sequenceId | string | no | — |
| trackIndex | number | no | Video track to use, default 0 |
Exports the active sequence as a standalone .prproj file. Verified via seq.exportAsProject().
| Parameter | Type | Required | Notes |
|---|---|---|---|
| outputPath | string | yes | Absolute path for the output .prproj file |
| sequenceId | string | no | — |
Compares two sequences and returns a human-readable change list: added/removed/moved clips, timing changes.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceIdA | string | yes | First sequence ID (older version) |
| sequenceIdB | string | yes | Second sequence ID (newer version) |
Returns the full project panel tree path for a project item (including bin hierarchy). Verified via item.treePath.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | Project item nodeId |
Sets text content on a MOGRT (Motion Graphics Template) clip. Finds the clip by track/index and updates a text param by display name.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | no | Video track index, default 0 |
| clipIndex | number | no | Clip index, default 0 |
| paramName | string | yes | The text param display name to set |
| text | string | yes | The new text value |
Sets a parameter value on a MOGRT clip (text, color, number). Finds param by display name.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | no | — |
| clipIndex | number | no | — |
| paramName | string | yes | The param display name |
| value | yes | The new value |
Lists all exposed parameters of a MOGRT clip with their names, types, and current values.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | no | — |
| clipIndex | number | no | — |
Applies the "Timecode" (Metadata & Timecode Burn-in) video effect to a clip for review copies. Verified via QE addVideoEffect + component fingerprint.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | no | — |
| clipIndex | number | no | — |
Returns the list of available renderers (GPU/software) from Premiere. Verified via qe.project.getRendererNames().
No parameter schema on file.
Sets the active GPU renderer by name. Verified via qe.project.setRenderer() + readback.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| rendererName | string | yes | Renderer name from get_renderer_names |
Sets or clears sync lock on a timeline track. Verified via QE track.setSyncLock() + isSyncLocked() readback.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackType | string | yes | Track type |
| trackIndex | number | yes | 0-based track index |
| locked | boolean | yes | True to lock, false to unlock |
Renders audio preview files for the active sequence. Equivalent to Sequence > Render Audio. Verified via QE seq.renderAudio().
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Returns the list of Adobe Productions (Team Projects) available to the logged-in user. Verified via qe.ea.getProductionList().
No parameter schema on file.
Returns all 325 Lumetri preset names available in the project. Verified via app.project.getAllLumetriPresetsList().
| Parameter | Type | Required | Notes |
|---|---|---|---|
| folder | string | no | Filter to a preset folder name e.g. "Creative", "Cinematic" |
Sets the sequence in/out points using QE (more reliable than DOM for non-standard timecodes).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| inPoint | string | no | In point timecode e.g. "00:00:01:00" |
| outPoint | string | no | Out point timecode |
| sequenceId | string | no | — |
Returns QE sequence properties: CTI, in/out points, work area, preview preset, editing mode GUID, render flags.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Moves playhead to the next sequence marker after the current position.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Moves playhead to the previous sequence marker before the current position.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Moves the playhead to a specific timecode string (e.g. "00:00:05:00") in the active sequence.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| timecode | string | yes | Timecode e.g. "00:00:05:00" |
| sequenceId | string | no | — |
Sets playhead to in-point and starts playback.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Returns all cut points on all tracks as a list of {track, clip, name, startSecs, endSecs}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| videoOnly | boolean | no | — |
Compares each clip's source fps/size to the sequence settings. Returns list of mismatching clips.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Returns which tracks have content vs are empty, with clip counts per track.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Extracts N evenly-spaced frame thumbnails from a video file path as JPEGs. Returns array of output file paths.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| filePath | string | yes | Source video file path |
| count | number | no | Number of thumbnails. Default 10. |
| outputDir | string | no | Output directory. Default /tmp/premiere-mcp-bridge/generated-assets/ |
Reverses a clip on the timeline using QE setReverse(). Verified via clip.reversed property.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| reverse | boolean | yes | — |
| sequenceId | string | no | — |
Enables/disables frame blending on a clip via QE setFrameBlend(). Verified via clip.frameBlend property.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| enabled | boolean | yes | — |
| sequenceId | string | no | — |
Sets time interpolation type on a clip: 0=frame sampling, 1=frame blend, 2=optical flow.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| type | number | yes | — |
| sequenceId | string | no | — |
Sets the border color of a clip via QE setBorderColor(). Pass RGB 0-255.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| r | number | yes | — |
| g | number | yes | — |
| b | number | yes | — |
| sequenceId | string | no | — |
Sets the border width of a clip via QE setBorderWidth().
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| width | number | yes | — |
| sequenceId | string | no | — |
Renames a clip on the timeline via QE setName(). Verified via DOM clip.name readback.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| name | string | yes | — |
| sequenceId | string | no | — |
Returns all parameter names and values for a clip's effect component at the given index, using QE getParamList/getParamValue.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| componentIndex | number | yes | — |
| sequenceId | string | no | — |
Sets a parameter value on a clip's effect component by name using QE setParamValue(). Works where DOM setValue() fails.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| componentIndex | number | yes | — |
| paramName | string | yes | — |
| value | string | yes | Value as string |
| sequenceId | string | no | — |
Removes a specific effect component from a clip by component index, using QE QEComponent.remove(). Does not affect Motion/Opacity.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| componentIndex | number | yes | — |
| sequenceId | string | no | — |
Reports a clip's effect stack order next to the order you want. Premiere's scripting cannot move an effect within the stack, so this changes nothing and returns success:false with how to do it by hand (Effect Controls panel, or remove and re-apply, which loses that effect's keyframes).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| newOrder | array | yes | Component displayNames in desired order |
| sequenceId | string | no | — |
Applies an audio effect to a clip on the timeline by effect name using QE addAudioEffect(). Verified: fingerprints component count before/after.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| effectName | string | yes | — |
| audioTrack | boolean | no | True for audio track. Default true. |
| sequenceId | string | no | — |
Applies Adaptive Noise Reduction to an audio clip via QE.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| sequenceId | string | no | — |
Lists all audio effect components on an audio clip with their QE parameter names.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| sequenceId | string | no | — |
Analyzes audio peak and RMS levels of a media file using ffprobe astats filter. Returns per-channel stats.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| filePath | string | yes | Path to the audio/video file |
Applies Dynamics Processing audio effect to an audio clip via QE.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| sequenceId | string | no | — |
Adds volume automation keyframes to an audio track by setting level values at specific timecodes.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| keyframes | array | yes | — |
| sequenceId | string | no | — |
Reads captions from the active sequence and writes them as an SRT file. Uses read_sequence_captions then formats as SRT.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| outputPath | string | yes | Output .srt file path |
| sequenceId | string | no | — |
Validates an SRT file: checks CPS (chars/sec), line length, overlapping/missing cues. Returns list of violations.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| srtPath | string | yes | — |
| maxCps | number | no | Max chars per second. Default 17. |
| maxLineLength | number | no | Max chars per line. Default 42. |
Auto-fixes common SRT issues: splits cues over the CPS limit, enforces minimum gap between cues. Writes fixed file.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| srtPath | string | yes | — |
| outputPath | string | no | Output path. Default: overwrites input. |
| maxCps | number | no | — |
| minGapMs | number | no | Min gap between cues in ms. Default 80. |
Converts a Whisper-format JSON transcript (with word-level timestamps) into an SRT file.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| jsonPath | string | yes | Path to Whisper JSON transcript |
| outputPath | string | yes | Output .srt file path |
| maxCps | number | no | — |
| maxLineLength | number | no | — |
Compares two SRT files and returns a diff: added, removed, and changed cues.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| srtPathA | string | yes | — |
| srtPathB | string | yes | — |
Creates sequence markers from an SRT file — one marker per cue with the cue text as the marker comment.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| srtPath | string | yes | — |
| sequenceId | string | no | — |
| markerType | string | no | Marker type. Default Comment. |
Opens a Final Cut Pro XML file into a new sequence. Confirmed: app.openFCPXML(path, sequenceName).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| filePath | string | yes | — |
| sequenceName | string | no | Name for the resulting sequence |
Returns a summary of the project: sequence count, total clips, bin count, codec mix, total media duration.
No parameter schema on file.
Writes a sidecar file adjacent to the project. Confirmed: app.project.writeSidecarFile(name, ext, content).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| fileName | string | yes | — |
| fileExtension | string | yes | — |
| contents | string | yes | — |
Returns the current Creative Cloud / Productions login status via qe.ea.isLoggedIn() and getUserEmail().
No parameter schema on file.
Searches all sequences by name pattern (case-insensitive contains). Returns matching sequence IDs and names.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| pattern | string | yes | Search pattern (case-insensitive substring) |
Sets the sequence work area to span all content on V1 (first clip start → last clip end).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Returns the full project bin hierarchy as a nested JSON tree with bin names, IDs, and item counts.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| includeItems | boolean | no | Include individual items in each bin. Default false. |
Searches all sequences for clips that have a specific effect by display name. Returns clip locations.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| effectName | string | yes | Effect displayName to search for |
Returns all effects on a clip with their parameter names and values as a structured report.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| sequenceId | string | no | — |
Enables or disables a specific effect component on a clip by display name.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| effectName | string | yes | — |
| enabled | boolean | yes | — |
| sequenceId | string | no | — |
Adds Constant Power audio crossfades at every cut on all audio tracks in the active sequence.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| durationSeconds | number | no | Crossfade duration in seconds. Default 0.5. |
| sequenceId | string | no | — |
Flushes the QE sequence cache via qe.seq.flushCache().
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Sets the sequence preview quality: max render quality flag and preview frame size.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| useMaxQuality | boolean | no | — |
| presetPath | string | no | — |
| width | number | no | — |
| height | number | no | — |
| sequenceId | string | no | — |
Returns the original and override color space of a project item.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | — |
Sets the color space override on a project item (same as set_color_space_override). Pass a name from get_item_color_management overrideColorSpaceList, e.g. "Rec. 709", "Rec. 2100 PQ". Verified by readback.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | — |
| colorSpaceName | string | yes | — |
Returns comprehensive clip info: speed, reverse state, color space, in/out points, linked items, effect count, marker count, type flags.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | — |
Relinks offline project items by transforming their paths: replace oldPrefix with newPrefix. Reports how many items were relinked.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| oldPrefix | string | yes | — |
| newPrefix | string | yes | — |
Sets the poster frame timecode on a project item via setStartTime.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | — |
| timeSecs | number | yes | — |
Applies Gaussian Blur effect to a clip with a specified amount. Uses QE addVideoEffect + setParamValue. Verified pattern.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| amount | number | yes | Blur amount |
| sequenceId | string | no | — |
Applies Unsharp Mask effect to a clip via QE.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| amount | number | no | Sharpening amount. Default 50. |
| sequenceId | string | no | — |
Enables or disables all applied effects on a clip (skips built-in Motion/Opacity/Time Remapping).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| enabled | boolean | yes | — |
| sequenceId | string | no | — |
Removes all applied effects from a clip via QE removeEffects(). Does not remove built-in Motion/Opacity.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| sequenceId | string | no | — |
Same as apply_lut, addressed by track/clip index: selects the Lumetri Input LUT dropdown entry whose render matches the .cube, verified against ffmpeg lut3d.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| lutPath | string | yes | Absolute path to the .cube LUT file |
| sequenceId | string | no | — |
| installIfMissing | boolean | no | — |
Lists all effect components on a clip using the QE getComponentAt/getParamList path. Returns component names and param lists.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| sequenceId | string | no | — |
Converts a timecode string to frame number and seconds at the active sequence frame rate. Pure computation.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| timecode | string | yes | — |
| frameRate | number | no | Frame rate override. Default: active sequence fps. |
Converts a frame number to a timecode string at the active sequence frame rate. Pure computation.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| frames | number | yes | — |
| frameRate | number | no | — |
Places a clip as picture-in-picture in a corner at a given size. Sets Motion Position and Scale. Args: trackIndex, clipIndex, corner (top-left/top-right/bottom-left/bottom-right), sizePercent (default 25).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| corner | string | no | — |
| sizePercent | number | no | — |
| sequenceId | string | no | — |
Arranges clips in a 2x2 or 3x3 grid by setting Position and Scale on each clip's Motion component.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clips | array | yes | — |
| cols | number | no | — |
| sequenceId | string | no | — |
Arranges 2 or 3 clips side-by-side horizontally or vertically using crop and position params.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clips | array | yes | — |
| orientation | string | no | — |
| sequenceId | string | no | — |
Resets all Motion component params to defaults: Position (0.5,0.5), Scale 100, Rotation 0, Anchor (0.5,0.5), Uniform Scale true.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| sequenceId | string | no | — |
Aligns selected clips spatially by setting their Position param: left/center/right (X axis) or top/middle/bottom (Y axis).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clips | array | yes | — |
| alignment | string | yes | — |
| sequenceId | string | no | — |
Returns action-safe (10%) and title-safe (20%) bounds in pixels for the active sequence. Pure computation from frameSizeH/V.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Sets clip crop via Motion component params (Crop Left/Top/Right/Bottom, each 0–100%).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| left | number | no | — |
| top | number | no | — |
| right | number | no | — |
| bottom | number | no | — |
| sequenceId | string | no | — |
Animates clip scale from 100% to targetScale% over the clip duration using two keyframes.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| targetScale | number | no | — |
| sequenceId | string | no | — |
Animates clip scale from targetScale% to 100% over the clip duration.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| startScale | number | no | — |
| sequenceId | string | no | — |
Toggles the Uniform Scale checkbox on a clip's Motion component.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| uniformScale | boolean | yes | — |
| sequenceId | string | no | — |
Moves N clips to evenly-spaced positions within a time range on a given track.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndices | array | yes | — |
| startSecs | number | yes | — |
| endSecs | number | yes | — |
| sequenceId | string | no | — |
Stretches/compresses a clip to exactly fill its available gap or a target duration using QE setSpeed. Verified: setSpeed(ratio,...) confirmed working.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| targetDurationSecs | number | no | Target duration. Omit to fill gap to next clip. |
| sequenceId | string | no | — |
Sets a clip to an exact target duration by speed change (default) or by trimming the out point.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| targetSeconds | number | yes | — |
| method | string | no | — |
| sequenceId | string | no | — |
Reads clip.getSpeed() and clip.duration, reports actual vs expected duration and whether the speed applied correctly.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| expectedSpeedPercent | number | no | — |
| sequenceId | string | no | — |
Returns speed, duration, isReversed, frameBlend, timeInterpolationType for a clip.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| sequenceId | string | no | — |
Resets clip speed to 100% via QE setSpeed(1.0,...). Useful after speed ramps.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| sequenceId | string | no | — |
Given a source file's FPS and a target speed%, reports whether playback will judder and recommends Optical Flow if needed. Pure computation.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sourceFps | number | yes | — |
| targetSpeedPercent | number | yes | — |
Renders the clip at the specified speed to a temp file via ffmpeg, imports it, and replaces the timeline clip. Permanent bake.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| speedPercent | number | yes | — |
| outputDir | string | yes | Directory for the baked file |
| sequenceId | string | no | — |
Sets Lumetri HSL Secondary keying params: showMask, invertMask, temperature, tint, contrast, saturation. All confirmed scriptable via setValue.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| showMask | boolean | no | — |
| invertMask | boolean | no | — |
| temperature | number | no | — |
| tint | number | no | — |
| contrast | number | no | — |
| saturation | number | no | — |
| denoise | number | no | — |
| blur | number | no | — |
| sequenceId | string | no | — |
Runs ffprobe signalstats on a media file to detect illegal luma/chroma levels. Returns frame count with levels outside 0-100 IRE.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mediaPath | string | yes | Absolute path to media file to check |
Uses ffmpeg palettegen to extract the dominant colors from a clip. Returns array of hex color strings.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mediaPath | string | yes | — |
| startSecs | number | no | — |
| durationSecs | number | no | — |
| colorCount | number | no | — |
Sets the override color space on a project item. Pass a name from get_item_color_management overrideColorSpaceList, e.g. "Rec. 709", "Rec. 2100 HLG". Verified by readback. An override cannot be cleared by script; set it back to the original instead.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | — |
| colorSpaceName | string | yes | — |
Copies the Lumetri grade from a source clip to a target clip (reads all params from source, applies to target).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sourceTrackIndex | number | yes | — |
| sourceClipIndex | number | yes | — |
| targetTrackIndex | number | yes | — |
| targetClipIndex | number | yes | — |
| sequenceId | string | no | — |
Saves all readable Lumetri params for a clip to a JSON file for later restoration or reference.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| outputPath | string | yes | Absolute path for the JSON output file |
| sequenceId | string | no | — |
Exports a single frame with a false-color exposure visualization via ffmpeg. Args: mediaPath, timeSecs, outputPath.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mediaPath | string | yes | — |
| timeSecs | number | yes | — |
| outputPath | string | yes | — |
Creates a ranged (duration) sequence marker with a start time and duration in seconds.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| startSecs | number | yes | — |
| durationSecs | number | yes | — |
| name | string | no | — |
| comment | string | no | — |
| type | string | no | — |
| sequenceId | string | no | — |
Updates the type of an existing sequence marker found by approximate timecode.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| timeSecs | number | yes | — |
| type | string | yes | — |
| toleranceSecs | number | no | — |
| sequenceId | string | no | — |
Returns all sequence markers whose name or comment contains "TODO" (case-insensitive). Useful for review tracking.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Formats all Chapter markers in the active sequence as a YouTube description timestamps block. Returns the text string.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Copies all markers from one sequence to another, preserving times, names, types, and comments.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sourceSequenceId | string | yes | — |
| targetSequenceId | string | yes | — |
Creates a subclip from a sequence marker's time range. The subclip is created from the first clip on V1 that overlaps the marker.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| markerName | string | yes | Name of the ranged marker to use |
| projectItemId | string | yes | Source project item nodeId to subclip |
| sequenceId | string | no | — |
Creates an animated GIF from a time range in a media file using ffmpeg palettegen+paletteuse pipeline.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mediaPath | string | yes | — |
| startSecs | number | no | — |
| durationSecs | number | no | — |
| fps | number | no | — |
| width | number | no | — |
| outputPath | string | yes | — |
Exports a JPEG frame at each sequence marker position using ffmpeg. Returns array of output paths.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mediaPath | string | yes | Source media file path to extract frames from |
| outputDir | string | yes | — |
| sequenceId | string | no | — |
Exports a single frame at the current playhead position. Tries QE exportFrameJPEG, falls back to capture_frame.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| outputPath | string | yes | Absolute output path (.jpg or .png) |
| sequenceId | string | no | — |
Lists all .epr preset files in the Adobe AME presets directory. Returns name and path for each.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| filter | string | no | Filter presets by name (case-insensitive substring) |
Returns the current AME encode queue status: whether encoding is complete, file extension in use.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Exports the active sequence as a CMX3600 EDL file. Uses FCPXML as an intermediate format, converted on the Node.js side.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| outputPath | string | yes | Absolute output path for the .edl file |
| sequenceId | string | no | — |
REPORT ONLY -- this does NOT export anything. It lists the Chapter markers in the sequence with their start/end ticks so you can drive the exports yourself; presetPath, outputDir and filePrefix are accepted but ignored. For an export that actually writes files, use export_per_marker_range (marker…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| presetPath | string | yes | Path to .epr preset file |
| outputDir | string | yes | — |
| filePrefix | string | no | — |
| sequenceId | string | no | — |
Opens a project item in the Source Monitor, sets in/out points, name, and color label in one call.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | — |
| inPoint | string | no | Timecode e.g. "00:00:01:00" |
| outPoint | string | no | — |
| name | string | no | — |
| labelColor | number | no | Label color index 0-7 |
Creates a subclip for each ranged marker on a project item. Subclip names = marker names.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | Source project item nodeId |
Extracts N evenly-spaced thumbnail JPEGs from a media file using ffmpeg. Returns array of paths.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mediaPath | string | yes | — |
| count | number | no | — |
| outputDir | string | yes | — |
Extracts a frame at 50% duration from each of two project items for visual comparison. Returns two image paths.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId1 | string | yes | — |
| projectItemId2 | string | yes | — |
| outputDir | string | yes | — |
Returns info about what is currently loaded in the Source Monitor: item name, path, in/out points, duration.
No parameter schema on file.
Reads a CSV file (name, inTimecode, outTimecode, label columns) and sets in/out + label on matching project items.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| csvPath | string | yes | Absolute path to CSV file |
| sequenceId | string | no | — |
Takes all footage items in a bin, in project-panel order, and assembles them onto V1 of a sequence via sequential overwrite edits. The bin is resolved by binId, a "/"-separated path, or a deep-searched name; an ambiguous or missing bin places nothing. Reports the bin actually used and refuses…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| binName | string | yes | — |
| binId | string | no | — |
| sequenceId | string | no | Target sequence. Defaults to active sequence. |
| startAtSecs | number | no | — |
Ensures all clip start times align to whole-frame boundaries. Reports any clips that were moved.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Copies frame rate, resolution, and field type from one sequence to another.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sourceSequenceId | string | yes | — |
| targetSequenceId | string | yes | — |
Returns comprehensive sequence info: name, ID, duration, fps, resolution, track counts, clip counts, marker counts, work area, preview codec path.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Selects all clips that overlap a time range on specified tracks (or all video tracks if omitted).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| startSecs | number | yes | — |
| endSecs | number | yes | — |
| trackIndices | array | no | — |
| sequenceId | string | no | — |
Lists all sequences in the project that are not nested inside any other sequence.
No parameter schema on file.
Enables or disables all clips on a track within a time range.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| enabled | boolean | yes | — |
| startSecs | number | no | — |
| endSecs | number | no | — |
| sequenceId | string | no | — |
Returns all markers across all sequences in the project as a flat list with sequence name, marker name, time, type.
No parameter schema on file.
Resets the sequence work area to span the full sequence duration.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Sets the sequence start timecode (zero point) e.g. "01:00:00:00" for broadcast.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| timecode | string | yes | — |
| sequenceId | string | no | — |
Creates a new subsequence for each pair of Chapter markers, duplicating the sequence and trimming to each range.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| markerType | string | no | — |
Returns comprehensive project item info: name, path, type, duration, fps, resolution, colorSpace, embeddedLUTID, proxyPath, marker count, treePath.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | — |
Checks if a project item's source file exists on disk. Returns exists, path, and file size.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | — |
Returns all items in a bin and all of its sub-bins as a flat list with their tree paths. The bin is resolved by binId, a "/"-separated path, or a deep-searched name; a name that does not resolve is an ERROR -- it does NOT silently fall back to listing the whole project. The response reports the…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| binName | string | no | — |
| binId | string | no | — |
Finds all timeline clips across all sequences that reference a given project item by nodeId.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | — |
For all offline items whose path starts with oldPrefix, attempts to relink by replacing with newPrefix.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| oldPrefix | string | yes | — |
| newPrefix | string | yes | — |
Sets an override frame rate on a project item. Confirmed via item.setOverrideFrameRate(fps).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | — |
| frameRate | number | yes | — |
Returns the full XMP metadata XML string from a project item. Useful for reading all metadata fields.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | — |
Returns a comprehensive project media report: total clips, total duration, codec mix, frame rate mix, resolution mix, offline count.
No parameter schema on file.
For each clip in the active sequence, reports hasProxy and proxyPath.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Reports application-level state in one call: whether a document is open, the open project view IDs, the current project-panel selection, app version/build/path, and whether proxy playback is enabled. Read-only.
No parameter schema on file.
Forces Premiere to refresh its UI (app.refresh()). Useful after scripted changes that the panels have not picked up. Returns success only if the call did not throw; there is no readback for a UI repaint, so verified is not claimed.
No parameter schema on file.
Returns the items currently selected in the Project panel, for the current view or a named view. Uses app.getProjectViewSelection / getCurrentProjectViewSelection — distinct from get_sequence_selection, which reads the TIMELINE selection.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| viewId | string | no | Project view GUID from get_app_state. Defaults to the current view. |
Selects items in the Project panel by nodeId. Verifies by reading the selection back and comparing counts.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemIds | array | yes | nodeIds of project items to select |
| viewId | string | no | Project view GUID. Defaults to the current view. |
Reads the PROJECT-level Project-panel metadata blob (column layout/config) via app.project.getProjectPanelMetadata(). NOTE: this is a different API from get_project_panel_metadata, which despite its name reads a single ITEM's metadata via ProjectItem.getProjectMetadata(). Use this one for panel…
No parameter schema on file.
Writes the PROJECT-level Project-panel metadata blob via app.project.setProjectPanelMetadata(). Reads the blob back and reports verified:false if it did not change. Pass a blob previously obtained from get_project_panel_columns.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| metadata | string | yes | The panel metadata blob to write |
Reports the project's Adobe/shared location copy settings: isAdobeLocationCopyEnabled, isSharedLocationCopyEnabled, and the configured shared location path. These govern where Premiere copies media for collaboration.
No parameter schema on file.
Enables Adobe location copy, enables shared location copy, or disables copy-to-location entirely. Reads the flags back and reports verified accordingly.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mode | string | yes | — |
Reports the color-management capabilities and current values for this build: supported graphics white luminance values, current luminance, supported LUT interpolation methods, and the current method. Read this before calling set_graphics_white_luminance or set_lut_interpolation so you pass a value…
No parameter schema on file.
Turns log color management on or off for the project (app.project.setLogColorManagement). There is no getter for this flag, so verified is not claimed — the call is reported as dispatched.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| enabled | boolean | yes | — |
Exports the ENTIRE PROJECT as Final Cut Pro XML via app.project.exportFinalCutProXML(). Distinct from export_as_fcp_xml, which exports a single SEQUENCE via Sequence.exportAsFinalCutProXML(). Verifies the file exists on disk afterwards.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| outputPath | string | yes | Absolute path for the .xml file |
| suppressUI | boolean | no | Suppress Premiere UI during export. Default true. |
Pauses or resumes Premiere's growing-file monitoring (app.project.pauseGrowing). Relevant when ingesting media that is still being written. No getter exists, so verified is not claimed.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| paused | boolean | yes | — |
Reports the boolean/positional flags on a timeline clip that other tools do not surface: isSpeedReversed, parentTrackIndex, isSelected, isAdjustmentLayer, isMGT, disabled, mediaType, and the clip matchName. Read-only.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | 0-based video track index |
| clipIndex | number | yes | 0-based clip index |
| sequenceId | string | no | — |
Reports a project item's full color-management state: original/override color space, the list of valid override color spaces, embedded and input LUT IDs, and whether the media is color managed. Read this before set_clip_color_space so the name you pass is accepted.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | — |
Overrides a project item's pixel aspect ratio (ProjectItem.setOverridePixelAspectRatio). Takes a numerator and denominator. No direct getter for the override exists, so the call is reported as dispatched rather than verified.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | — |
| numerator | number | yes | PAR numerator, e.g. 1 |
| denominator | number | yes | PAR denominator, e.g. 1 |
Finds project items whose media path matches a substring, using ProjectItem.findItemsMatchingMediaPath() on the root item. This is the DOM's own matcher; find_items_by_media_path walks the tree manually instead. Useful for locating every item that references one source file.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| pathSubstring | string | yes | Substring of the media path to match |
| ignoreSubclips | boolean | no | Exclude subclips from results. Default false. |
Returns the ComponentCollection attached to a project item via ProjectItem.videoComponents() — the MASTER clip effects, which are distinct from the per-timeline-clip components that list_clip_effects reports. Master clip effects apply everywhere the item is used.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | — |
Navigates keyframes on an effect parameter: reports the nearest, next, and previous keyframe to a given time, whether a keyframe exists exactly at that time, whether the param has any keyframes, and the interpolated value at that time. Uses ComponentParam…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| componentIndex | number | yes | Index into clip.components |
| paramIndex | number | yes | Index into component.properties |
| timeSeconds | number | yes | Time to search around, in seconds |
| sequenceId | string | no | — |
Reports Adobe Media Encoder integration state: the last export media folder, and the count of available exporters. Read-only; does not launch AME.
No parameter schema on file.
Controls whether AME writes XMP metadata embedded in the output file and/or as a sidecar (app.encoder.setEmbeddedXMPEnabled / setSidecarXMPEnabled). No getters exist for these flags, so the calls are reported as dispatched.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| embedded | boolean | no | Embed XMP in the output file |
| sidecar | boolean | no | Write a sidecar XMP file |
QE-level project introspection not available through the documented DOM: project size on disk, the undo stack index, and how many metadata cache entries are still pending indexing. Read-only.
No parameter schema on file.
Creates a bin via the QE API (qe.project.newBin), optionally a smart bin (newSmartBin). An alternative to create_bin when the DOM path misbehaves; verifies by counting root items before and after.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | yes | — |
| smart | boolean | no | Create a smart bin instead of a regular bin. Default false. |
Imports a media file via the QE API (qe.project.import), which accepts an isNumberedStills flag for image sequences. Verifies by counting project items before and after. Alternative route to import_media.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| filePath | string | yes | Absolute path to the media file |
| numberedStills | boolean | no | Treat as a numbered still sequence. Default false. |
Reports QE-only sequence settings that the DOM does not expose: the preset list, multicam state, audio frame rate, audio/video display formats, field type, PAR, editing mode GUID, and preview codec. Read-only.
No parameter schema on file.
Reports QE-only clip settings the DOM does not expose: anti-alias quality, border colour and width, start/end percent, scale-to-frame-size, switch sources, static clip gain, frame blend and time interpolation type. Read-only.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
Locks or unlocks a single track via the QE track API (setLock), verifying against the DOM track isLocked() readback. Complements lock_track.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| locked | boolean | yes | — |
| audio | boolean | no | Target an audio track instead of video. Default false. |
Reports whether Premiere is still working on a media item: indexing, audio conforming, audio peak generation, pending state, whether it contains a speech track, its metadata size, and offline state. Use this to tell "playback is slow because Premiere is still ingesting" apart from a real…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | no | Video track of a timeline clip whose project item to inspect. Default 0. |
| clipIndex | number | no | Clip index on that track. Default 0. |
Relinks a project item to a media file via QEProjectItem.linkMedia(). Verifies by reading isOffline() back afterwards. An alternative to relink_media.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | no | Video track of the timeline clip. Default 0. |
| clipIndex | number | no | Clip index. Default 0. |
| mediaPath | string | yes | Absolute path to the media file to link |
| renameClip | boolean | no | Rename the clip to match the new media. Default false. |
Creates a proxy for a project item via QEProjectItem.createProxy(). Note that generating a proxy does NOT switch playback to it — call set_proxies_enabled(true) as well, which is the usual reason proxies appear to have no effect.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | no | Video track of the timeline clip. Default 0. |
| clipIndex | number | no | Clip index. Default 0. |
| presetPath | string | yes | Absolute path to the ingest/proxy preset (.epr) |
Opens a project item in the Source Monitor via QEProjectItem.openInSource() — a zero-argument QE route that avoids the path handling in open_in_source.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | no | Video track of the timeline clip. Default 0. |
| clipIndex | number | no | Clip index. Default 0. |
Reports Productions / Team Projects status using only READ-ONLY qe.ea calls: login state, user identity, whether this is a Production, share/sync command availability, unshared changes, local media presence, archived production list, invite list, admin flag, and remote server build. Does not…
No parameter schema on file.
Reports read-only state from Premiere's cloud task queue dispatcher (qe.tqm): active region, supported regions, and the queue list object type. Does NOT log in, create queues, or fetch auth tokens. Exploratory — this surface is undocumented.
No parameter schema on file.
Attaches a custom key/value property to a sequence via Sequence.attachCustomProperty(). Useful for stamping pipeline metadata (shot code, version, status) onto a sequence. No getter exists for these properties, so the call is reported as dispatched rather than verified.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| key | string | yes | — |
| value | string | yes | — |
| sequenceId | string | no | — |
Reports whether Premiere is currently PLAYING BACK proxies (the global Toggle Proxies state). This is separate from whether proxies are attached: a clip can have a proxy attached and still play at full resolution because the toggle is off, which is the usual reason "I made proxies but playback is…
No parameter schema on file.
Turns proxy playback on or off globally — the scripted equivalent of the Toggle Proxies button. Attaching proxies alone does not switch playback to them; this is what does. Verifies by reading the flag back.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| enabled | boolean | yes | true = play proxies, false = play full-resolution originals |
Computes a structural checksum of the active sequence (clip positions + names hash). Changes if anything moves or is renamed.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Saves the current sequence structure (all clip positions, names, effects count) to a JSON file for later comparison.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| outputPath | string | yes | — |
| sequenceId | string | no | — |
Compares the current sequence state to a previously saved snapshot JSON. Returns a diff of any changes.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| snapshotPath | string | yes | — |
| sequenceId | string | no | — |
Reads an application-level property via app.properties.getProperty(key).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| key | string | yes | — |
Sets an application-level property via app.properties.setProperty(key, value) with readback verification.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| key | string | yes | — |
| value | string | yes | — |
Reads Premiere's Auto Save preferences (enabled, interval in minutes, max project versions, also-save-current-project, save-to-cloud) plus the auto-save folder. Wraps the BE.Prefs.AutoSave.* keys so callers do not have to know them. Read-only.
No parameter schema on file.
Sets Premiere's Auto Save preferences with per-key readback verification. IMPORTANT: app.properties writes the LIVE preference; Premiere only flushes preferences to its prefs file on a graceful quit, so a crash or force-quit before then reverts the change. Set persistToPrefsFile (default true) to…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| enabled | boolean | no | BE.Prefs.AutoSave.DoSave — master Auto Save switch. |
| intervalMinutes | integer | no | Minutes between auto-saves. |
| maxVersions | integer | no | How many auto-save versions to keep before the oldest is discarded. |
| alsoSaveCurrentProject | boolean | no | — |
| saveToCloud | boolean | no | Auto-save backups to Creative Cloud. |
| persistToPrefsFile | boolean | no | — |
Reads a .prproj FILE ON DISK without opening it in Premiere, and reports its format version, whether it is gzip-compressed, a structural node census (including ObjectUID definition counts that match what Premiere reports for sequences/master clips/bins), the SHA-256, and whether the container…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectPath | string | yes | Absolute path to a .prproj file. Any other extension is refused. |
| countStrings | array | no | — |
| xmlExcerptAround | string | no | — |
Edits a .prproj FILE ON DISK by literal string replacement, writing the result to a NEW file. This reaches project state that ExtendScript cannot (Premiere exposes no scripted menu bus), but it is deliberately hard to misuse and is DISABLED by default: set …=1 to enable. Refuses unless every…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sourcePath | string | yes | Absolute path to the .prproj to read. Never modified. |
| outputPath | string | yes | Absolute path to write. Must not already exist. |
| replacements | array | yes | — |
| dryRun | boolean | no | — |
| allowCensusChange | boolean | no | — |
Returns the visibility state of key Premiere panels using app.isWindowVisible().
| Parameter | Type | Required | Notes |
|---|---|---|---|
| panels | array | no | — |
Returns a static report of the confirmed API surface: QE clip methods, QE sequence methods, confirmed DOM methods, and the honest wall of inaccessible features.
No parameter schema on file.
Applies a Morph Cut transition at a clip's out-point using QE, then verifies the transition by readback (QE transition enumeration, falling back to the transition count in an FCP XML export). Reports the transition as verified and the background frame ANALYSIS as separately unverified — until the…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| durationFrames | integer | no | Transition length in frames. Default: one second of the sequence timebase. |
| sequenceId | string | no | — |
Sets sequence preview render quality: maxRenderQuality (bool), maxBitDepth (bool), previewWidth/Height. Uses QE sequence methods.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| maxRenderQuality | boolean | no | — |
| maxBitDepth | boolean | no | — |
| previewWidth | number | no | — |
| previewHeight | number | no | — |
| sequenceId | string | no | — |
Returns the logged-in Adobe/Premiere account info via qe.ea: email, username, and login status.
No parameter schema on file.
Imports items from another .prproj file into the current project via QE importProject.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectPath | string | yes | Absolute path to .prproj file |
| includeSequences | boolean | no | — |
Returns all QE-level sequence properties: CTI, inPoint, outPoint, workInPoint, workOutPoint, editingMode GUID, track counts, preview codec, quality flags.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Quick check: does the active sequence have any unrendered (red/yellow) segments? Returns a simple bool plus counts.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Opens an FCP XML file as a new project via app.openFCPXML(path, sequenceName). Confirmed on 26.3.2.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| xmlPath | string | yes | — |
| sequenceName | string | no | — |
Imports a media file (video, audio, image) into the current Premiere Pro project. Target a nested bin with binId (a bin nodeId, unambiguous — preferred) or binName, which also accepts a "/"-separated path. An unresolvable bin fails without importing; the bin actually used is read back in the…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| filePath | string | yes | The absolute path to the media file to import |
| binName | string | no | — |
| binId | string | no | — |
Imports a Final Cut Pro 7 XML (XMEML) file into the current project. Premiere creates a new sequence with the cuts/clips defined in the XML. The import requests Premiere UI suppression, but malformed or unsupported XML can still be rejected by Premiere. Use legacy FCP7 XML, not modern FCPXML 1.x…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| filePath | string | yes | The absolute path to the FCP7 XML file (.xml extension typical) |
Reports that CMX 3600 EDL import is unavailable through this dialog-safe MCP server. Premiere's EDL API opens an interactive sequence/source-media dialog that blocks CEP. Use import_fcp_xml for unattended timeline interchange instead.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| filePath | string | yes | The absolute path to the .edl file |
Imports all media files from a folder into the current Premiere Pro project. Target a nested bin with binId (a bin nodeId, unambiguous — preferred, e.g. straight from create_bin) or binName, which also accepts a "/"-separated path. An unresolvable or ambiguous bin fails before anything is…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| folderPath | string | yes | The absolute path to the folder containing media files |
| binName | string | no | — |
| recursive | boolean | no | Whether to import from subfolders recursively |
| binId | string | no | — |
Creates a new bin (folder) in the project panel to organize media. Nest it by naming a parent: parentBinId (a bin nodeId, unambiguous — preferred) or parentBinName. parentBinName resolves a nested bin too — pass a "/"-separated path like "Scenes/Scene-008" to walk the hierarchy, or a single name…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | yes | The name for the new bin |
| parentBinName | string | no | — |
| parentBinId | string | no | — |
Creates a new sequence from a specific installed .sqpreset file without opening Premiere's New Sequence dialog. For footage-driven edits, prefer create_sequence_from_clips; for an empty copy of an existing sequence, use duplicate_sequence with clearContents=true.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | yes | The name for the new sequence |
| presetPath | string | yes | — |
| frameRate | number | no | — |
Creates a copy of an existing sequence with a new name. Set clearContents=true to get an EMPTY copy that inherits the source sequence's exact settings (frame rate, resolution, track layout) — the reliable way to auto-create a correctly-specced blank target, since create_sequence ignores frame rate.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | The ID of the sequence to duplicate. Defaults to the active sequence. |
| newName | string | yes | The name for the new sequence copy |
| clearContents | boolean | no | — |
Deletes a sequence from the project.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | yes | The ID of the sequence to delete |
Takes a recovery snapshot of a sequence by cloning it into a tagged copy named "[recovery] <label> @ <timestamp>". Use this BEFORE a risky or bulk edit so you can get the pre-edit state back with restore_recovery_checkpoint. The snapshot travels with the project (it is a real sequence), so it…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| label | string | no | — |
Lists the recovery checkpoints in the project — every sequence whose name carries the "[recovery]" tag — with each one's parsed label and creation timestamp, most recent first. Use this to find a snapshot to restore_recovery_checkpoint, or to prune old ones with delete_sequence.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| labelContains | string | no | — |
Restores a recovery checkpoint by cloning it into a fresh working sequence (optionally made active), leaving the checkpoint itself intact so it can be restored again. This does NOT surgically rewind the original sequence in place — Premiere offers no safe API for that — it hands you a clean copy…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| checkpointSequenceId | string | yes | — |
| newName | string | no | — |
| setActive | boolean | no | Open the restored sequence as the active timeline. Default true. |
Adds a media clip from the project panel to a sequence timeline at a specific track and time.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| projectItemId | string | yes | The ID of the project item (clip) to add |
| trackIndex | number | yes | The index of the video or audio track (0-based) |
| time | number | yes | The time in seconds where the clip should be placed on the timeline |
| insertMode | string | no | Whether to overwrite existing content or insert and shift |
| linkAudio | boolean | no | — |
| sourceInPoint | number | no | — |
| sourceOutPoint | number | no | — |
Places MANY clips onto one sequence in a single round-trip — the fast path for rebuilding a whole edit (e.g. a Descript/EDL stringout). Equivalent to calling add_to_timeline (overwrite) once per clip, but ~50x faster because it loops inside one ExtendScript pass instead of one file round-trip per…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| mode | string | no | — |
| clips | array | yes | Ordered list of clips to place. All use overwrite mode. |
Removes a clip from the timeline. Pass sequenceId when the clip ID came from list_sequence_tracks for a non-active sequence.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the clip on the timeline to remove |
| sequenceId | string | no | — |
| deleteMode | string | no | Whether to ripple delete (close gap) or lift (leave gap) |
Moves a clip along the timeline, keeping it on its current track. To move a clip to a different track, use move_clip_to_track: on this Premiere build that is a reinsert that gives the clip a new id and refuses an occupied destination unless overwrite:true, so it is deliberately a separate call…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the clip to move |
| newTime | number | yes | The new time position in seconds |
Trims a clip (and its linked audio/video) to new SOURCE in/out points, or to a timeline duration, keeping every remaining frame where it was on the timeline. Snaps to the frame grid, refuses trims past the media or into a neighbour, and restores the clip if Premiere does not apply the edit.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the clip on the timeline to trim |
| inPoint | number | no | The new in point in seconds from the start of the clip |
| outPoint | number | no | — |
| duration | number | no | — |
Splits a clip at a specific time point, creating two separate clips.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the clip to split |
| splitTime | number | yes | — |
Cuts across multiple tracks in a sequence at an absolute timeline time. If no track arrays are provided, all video and audio tracks are cut.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | Optional sequence ID. Defaults to the active sequence. |
| time | number | yes | Absolute timeline time in seconds where the cut should occur. |
| videoTrackIndices | array | no | Optional video track indices to cut. Defaults to all video tracks. |
| audioTrackIndices | array | no | Optional audio track indices to cut. Defaults to all audio tracks. |
Applies a visual or audio effect to a clip, identifies the exact newly created component (reporting its matchName), and verifies parameter readbacks. Effects resolve by display name only, so a stock name can silently resolve to a third-party plugin; pass expectedMatchName to enforce the effect's…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the clip to apply the effect to |
| effectName | string | yes | The name of the effect to apply (e.g., "Gaussian Blur", "Lumetri Color") |
| parameters | object | no | Key-value pairs for the effect's parameters |
| expectedMatchName | string | no | — |
Crops a timeline clip using Premiere Pro's built-in Crop video effect. Reuses an existing Crop effect on the clip when present; otherwise adds one. Omitted parameters keep their current/default values.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the timeline video clip to crop |
| left | number | no | Percent to crop from the left edge (0-100) |
| right | number | no | Percent to crop from the right edge (0-100) |
| top | number | no | Percent to crop from the top edge (0-100) |
| bottom | number | no | Percent to crop from the bottom edge (0-100) |
| zoom | boolean | no | Crop effect Zoom toggle: scales the cropped image back up to fill the frame |
| edgeFeather | number | no | Edge Feather amount in pixels |
Adds a transition (e.g., cross dissolve) between two adjacent clips on the timeline.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId1 | string | yes | The ID of the first clip (outgoing) |
| clipId2 | string | yes | The ID of the second clip (incoming) |
| transitionName | string | yes | The name of the transition to add (e.g., "Cross Dissolve") |
| duration | number | yes | The duration of the transition in seconds |
Adds a transition to the beginning or end of a single clip. Check status and verified in the result: accepted_unverified means Premiere accepted the command but inspection could not prove the edit, so do not retry automatically.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the clip |
| transitionName | string | yes | The name of the transition |
| position | string | yes | Whether to add the transition at the start or end of the clip |
| duration | number | yes | The duration of the transition in seconds |
Adjusts the volume (gain) of an audio clip on the timeline.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the audio clip to adjust |
| level | number | yes | The new audio level in decibels (dB). Can be positive or negative. |
Analyzes a media file's audio for silent stretches using ffmpeg's silencedetect filter, run locally via child_process -- NOT via Premiere's scripting API, which has no audio-level/RMS reading capability at all (confirmed: every audio tool in this codebase only writes levels, never reads them).…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mediaPath | string | no | Direct filesystem path to the media file to analyze |
| projectItemId | string | no | — |
| noiseThresholdDb | number | no | — |
| minDurationSeconds | number | no | — |
Adds keyframes to audio levels for dynamic volume changes.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the audio clip |
| keyframes | array | yes | Array of keyframe data |
High-level wrapper around add_audio_keyframes that builds a ducking curve from a base level + ducking windows. Computes 4 keyframes per window (pre-fade, duck-in, duck-out, post-fade) plus boundary keyframes at clip start/end. Replaces the manual "8 keyframes per video" pattern from Sprint 3.…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the music/SFX clip to apply ducking to |
| baseDb | number | yes | Sustained level in dB (e.g. -25 for music bed under voice) |
| duckingWindows | array | yes | — |
| fadeSeconds | number | no | Ramp time for each transition (default 0.2s = 6 frames @30fps) |
| clipStartTime | number | no | Clip start time anchor for first keyframe (default 0) |
| clipEndTime | number | no | — |
Mutes or unmutes an entire audio track.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | The ID of the sequence. Defaults to the active sequence. |
| trackIndex | number | yes | The index of the audio track |
| muted | boolean | yes | Whether to mute (true) or unmute (false) the track |
Adds a text layer (title) over the video timeline. Requires a MOGRT (.mogrt) template file path. Supports up to 4 text fields (text, text2, text3, text4) — each populates the Nth "AE.ADBE Text" component in the MOGRT (e.g., for Basic Lower Third: text=main title, text2=subtitle).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| text | string | yes | Text for the first AE text component in the MOGRT (typically the main title) |
| text2 | string | no | Text for the second AE text component (e.g., subtitle of a lower third) |
| text3 | string | no | Text for the third AE text component (if present) |
| text4 | string | no | Text for the fourth AE text component (if present) |
| sequenceId | string | no | The sequence to add the text to. Defaults to the active sequence. |
| trackIndex | number | yes | — |
| startTime | number | yes | The time in seconds when the text should appear |
| duration | number | yes | — |
| mogrtPath | string | no | Absolute path to a .mogrt template file (required for text overlays) |
| textPropertyName | string | no | — |
| rollbackOnTextFailure | boolean | no | — |
Applies basic color correction adjustments to a video clip.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the clip to color correct |
| brightness | number | no | — |
| exposure | number | no | Lumetri Exposure (stops). Same parameter as brightness; prefer this name |
| contrast | number | no | Contrast adjustment |
| saturation | number | no | Saturation, where 100 is neutral |
| vibrance | number | no | Vibrance — saturation weighted toward less-saturated tones |
| hue | number | no | — |
| highlights | number | no | Adjustment for the brightest parts of the image |
| shadows | number | no | Adjustment for the darkest parts of the image |
| whites | number | no | White point adjustment |
| blacks | number | no | Black point adjustment |
| temperature | number | no | Color temperature adjustment |
| tint | number | no | Tint adjustment |
Puts a .cube LUT in the clip's Lumetri Input LUT slot and verifies it by render: Input LUT is a dropdown set by index, so each entry is rendered and the one matching ffmpeg's lut3d of the ungraded frame is kept. Takes several seconds. A LUT Premiere does not list cannot be selected;…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the clip |
| lutPath | string | yes | Absolute path to the .cube LUT file |
| intensity | number | no | Ignored: Input LUT has no intensity control. Kept for compatibility. |
| installIfMissing | boolean | no | — |
Renders and exports a sequence to a video file. This is for creating the final video.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | The ID of the sequence to export. Defaults to the active sequence. |
| outputPath | string | yes | The absolute path where the final video file will be saved |
| presetPath | string | no | — |
| presetName | string | no | — |
| sourceRange | string | no | — |
| allowOverwrite | boolean | no | Allow writing to an existing output file. Defaults to false. |
| removeOnCompletion | boolean | no | — |
| format | string | no | Deprecated hint only; the .epr preset controls codec/container. |
| quality | string | no | Deprecated hint only; the .epr preset controls quality. |
| resolution | string | no | Deprecated hint only; the .epr preset controls resolution. |
Exports a single frame from a sequence as an image file. Supported formats (all verified against Premiere's QE exporters): png, jpg/jpeg, tiff/tif, dpx, tga/targa.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | The ID of the sequence. Defaults to the active sequence. |
| time | number | yes | The time in seconds to export the frame from |
| outputPath | string | yes | The absolute path where the image file will be saved |
| format | string | no | The image format (default png) |
Adds a marker to the specified sequence for navigation or notes. The sequence does not have to be the active one.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| time | number | yes | The time in seconds where the marker should be placed |
| name | string | yes | The name/label for the marker |
| comment | string | no | Optional comment or description for the marker |
| color | no | — | |
| duration | number | no | Duration in seconds for a span marker (0 for point marker) |
Deletes a marker from the specified sequence. The sequence does not have to be the active one.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| markerId | string | yes | The ID of the marker to delete |
Updates an existing marker's properties in the specified sequence. The sequence does not have to be the active one.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| markerId | string | yes | The ID of the marker to update |
| name | string | no | New name for the marker |
| comment | string | no | New comment |
| color | no | New colour. … |
Lists all markers in the specified sequence. The sequence does not have to be the active one.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Adds a new video or audio track to the sequence.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | The ID of the sequence. Defaults to the active sequence. |
| trackType | string | yes | Type of track to add |
| position | string | no | Where to add the track relative to existing tracks |
Deletes a video or audio track from the specified sequence. The sequence does not have to be the active one, but it does have to be open in Premiere: there is no DOM track-deletion API, so this falls through to the QE DOM, which only reaches sequences Premiere has open. A sequence QE cannot…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackType | string | yes | Type of track |
| trackIndex | number | yes | The index of the track to delete |
Locks or unlocks a track to prevent/allow editing. The sequence does not have to be the active one.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackType | string | yes | Type of track |
| trackIndex | number | yes | The index of the track |
| locked | boolean | yes | Whether to lock (true) or unlock (false) |
Shows or hides a video track by toggling its output (the eye icon) in the specified sequence. The sequence does not have to be the active one. This is track OUTPUT, not track targeting -- use set_target_track for the V1/A1 patch buttons.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | yes | The index of the video track |
| visible | boolean | yes | Whether to show (true) or hide (false) |
Links or unlinks audio and video components of a clip.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the clip |
| linked | boolean | yes | Whether to link (true) or unlink (false) |
Applies an audio effect to a clip.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the audio clip |
| effectName | string | yes | Name of the audio effect (e.g., "Compressor", "EQ", "Reverb") |
| parameters | object | no | Effect parameters |
Bulk: applies a single audio effect to ALL audio clips of a sequence in one ExtendScript call. Returns per-clip results. Saves N MCP roundtrips when calibrating or applying same chain.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| effectName | string | yes | — |
| parameters | object | no | Effect parameters by displayName (exact or normalized) |
Duplicates a clip on the timeline.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the clip to duplicate |
| offset | number | no | — |
Reverses the playback of a clip.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the clip to reverse |
| maintainAudioPitch | boolean | no | Whether to maintain audio pitch (default: true) |
Enables or disables a clip on the timeline.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the clip |
| enabled | boolean | yes | Whether to enable (true) or disable (false) |
Replaces one timeline clip with another media item, keeping its trim, source in point, effects, settings, keyframes, on/off state, edge transitions and the layout of its linked clips (L/J-cuts, audio on other tracks). The rebuild is rehearsed first and compared, and the swap is undone if anything…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the clip to replace |
| newProjectItemId | string | yes | The ID of the new project item to use |
| preserveEffects | boolean | no | Whether to keep effects and settings (default: true) |
Gets the settings for a sequence (resolution, framerate, etc.).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | The ID of the sequence. Defaults to the active sequence. |
Updates sequence settings. Applies width, height, frameRate and pixelAspectRatio, reads the values back afterwards, and reports any field Premiere accepted but did not actually change. Frame size CAN be changed after creation, contrary to an earlier note in this codebase.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | The ID of the sequence. Defaults to the active sequence. |
| settings | object | yes | Settings to update |
Gets detailed properties of a clip, INCLUDING current Motion values (opacity/scale/rotation/position). Position is returned both normalized (0..1) and in PIXELS (motion.position, using the sequence frame size) so you can verify or copy framing without exporting a frame. Pass sequenceId when the…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the clip |
| sequenceId | string | no | — |
Sets Motion properties of a clip (opacity, scale, rotation, position).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the clip |
| properties | object | yes | Properties to set |
Applies Motion properties (opacity/scale/rotation/position) to MANY clips in a single round-trip — the fast path for per-speaker framing across a whole rebuilt edit. ~50x faster than one set_clip_properties call per clip. Returns a per-clip result array; each result carries an applied map…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| items | array | yes | List of clip + properties pairs |
Adds a sequence to the Adobe Media Encoder render queue.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | The ID of the sequence to render. Defaults to the active sequence. |
| outputPath | string | yes | Output file path |
| presetPath | string | no | Export preset file path |
| presetName | string | no | — |
| sourceRange | string | no | Export source range. Defaults to entire. |
| allowOverwrite | boolean | no | Allow writing to an existing output file. Defaults to false. |
| removeOnCompletion | boolean | no | Pass AME removeOnCompletion. Defaults to true. |
| startImmediately | boolean | no | Whether to start rendering immediately (default: false) |
Reports live render/encode status. Probes the Premiere encoder bridge (app.encoder) to report whether AME hand-off is reachable, and — when an outputPath is given — polls that file on disk (exists, size, last-modified) so a render in progress can actually be tracked. Adobe exposes no direct read…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| outputPath | string | no | — |
Applies video stabilization to reduce camera shake.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the clip to stabilize |
| method | string | no | Stabilization method |
| smoothness | number | no | Stabilization smoothness (0-100) |
Changes the playback speed of a clip.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the clip |
| speed | number | yes | Speed multiplier (0.1 = 10% speed, 2.0 = 200% speed) |
| maintainAudio | boolean | no | Whether to maintain audio pitch when changing speed |
Gets the current playhead (CTI) position in the specified sequence.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | The ID of the sequence. Defaults to the active sequence. |
Sets the playhead (CTI) position in the specified sequence.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | The ID of the sequence. Defaults to the active sequence. |
| time | number | yes | The time in seconds to move the playhead to |
Gets all currently selected clips in the specified sequence.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | The ID of the sequence. Defaults to the active sequence. |
Lists all available video effects in Premiere Pro.
No parameter schema on file.
Lists all available video transitions in Premiere Pro.
No parameter schema on file.
Lists all available audio effects in Premiere Pro.
No parameter schema on file.
Lists all available audio transitions in Premiere Pro.
No parameter schema on file.
Adds a keyframe to a clip component parameter at a specific time.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the clip |
| componentName | string | yes | The display name of the component (e.g., "Motion", "Opacity") |
| paramName | string | yes | The display name of the parameter (e.g., "Position", "Scale") |
| time | number | yes | The time in seconds for the keyframe |
| value | number | yes | The value to set at this keyframe |
Removes a keyframe from a clip component parameter at a specific time.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the clip |
| componentName | string | yes | The display name of the component |
| paramName | string | yes | The display name of the parameter |
| time | number | yes | The time in seconds of the keyframe to remove |
Gets all keyframes for a clip component parameter.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the clip |
| componentName | string | yes | The display name of the component |
| paramName | string | yes | The display name of the parameter |
Animates a SCALAR clip parameter (e.g. Opacity, Scale, Rotation) from a start value to an end value along an eased curve, by baking a dense run of keyframes whose values trace the easing shape. This is the honest path to eased motion: Premiere lets script SET a keyframe interpolation type but…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | The ID of the clip |
| componentName | string | no | The display name of the component (e.g., "Motion", "Opacity") |
| paramName | string | no | — |
| startTime | number | yes | Clip-local start time in seconds |
| endTime | number | yes | Clip-local end time in seconds (must be greater than startTime) |
| startValue | number | yes | Parameter value at startTime |
| endValue | number | yes | Parameter value at endTime |
| easing | string | no | Named easing curve; ignored when bezier is provided |
| bezier | array | no | — |
| samples | integer | no | Number of segments between the endpoints; keyframes written = samples + 1 |
Sets the work area in/out points for a sequence.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | The ID of the sequence. Defaults to the active sequence. |
| inPoint | number | yes | The in point in seconds |
| outPoint | number | yes | The out point in seconds |
Gets the work area in/out points for a sequence.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | The ID of the sequence. Defaults to the active sequence. |
Adds a transition to all clip boundaries on a track. Useful for quickly adding cross dissolves or other transitions between every clip.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | The ID of the sequence. Defaults to the active sequence. |
| trackIndex | number | yes | The video track index (0-based) |
| transitionName | string | yes | The name of the transition (e.g., "Cross Dissolve") |
| duration | number | yes | The duration of each transition in seconds |
Searches for project items by name. Useful for finding media files, sequences, or bins.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | yes | The name to search for (case-insensitive partial match) |
| type | string | no | Filter by item type |
Moves a project item into a different bin (folder).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | The ID of the project item to move |
| targetBinId | string | yes | The ID of the destination bin |
Sets the active sequence in the project.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | yes | The ID of the sequence to activate |
Gets information about the currently active sequence.
No parameter schema on file.
Gets the clip at a specific time position on a track.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | The ID of the sequence. Defaults to the active sequence. |
| trackType | string | yes | The type of track |
| trackIndex | number | yes | The track index (0-based) |
| time | number | yes | The time position in seconds |
Automatically reframes a sequence to a new aspect ratio using AI-powered motion tracking.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | The ID of the sequence to reframe. Defaults to the active sequence. |
| numerator | number | yes | Aspect ratio numerator (e.g., 9 for 9:16) |
| denominator | number | yes | Aspect ratio denominator (e.g., 16 for 9:16) |
| motionPreset | string | no | Motion tracking speed preset |
| newName | string | no | Name for the reframed sequence |
Detects scene changes in selected clips and optionally adds cuts or markers.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | The ID of the sequence. Defaults to the active sequence. |
| action | string | no | Action to take at detected edit points |
| applyCutsToLinkedAudio | boolean | no | Whether to apply cuts to linked audio |
| sensitivity | string | no | Detection sensitivity (e.g., "Low", "Medium", "High") |
| allowUnsafeSynchronous | boolean | no | — |
Transcribes a media file's speech to an .srt subtitle file using a LOCAL OpenAI Whisper install (the whisper CLI), run via child_process -- NOT via Premiere, which has no speech-to-text scripting API at all. This fills the gap before create_caption_track: Premiere can ingest an .srt but cannot…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mediaPath | string | no | Direct filesystem path to the audio/video file to transcribe |
| projectItemId | string | no | — |
| outputDir | string | no | — |
| model | string | no | — |
| language | string | no | — |
| translateToEnglish | boolean | no | — |
| timeoutSeconds | number | no | — |
Creates a caption track on a sequence from an imported caption/subtitle file (e.g. an .srt imported via import_media). Pass the SRT project item ID directly.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | The ID of the sequence. Defaults to the active sequence. |
| projectItemId | string | yes | The ID of the caption file project item (e.g. an imported .srt) |
| startTime | number | no | Offset in seconds from the start of the sequence. Defaults to 0. |
| captionFormat | string | no | — |
Reads caption tracks of a sequence, returning each caption clip as { start, end, text } in seconds. IMPORTANT: Premiere Pro exposes no caption-read API in its scripting DOM, so in practice this returns trackCount:0 / captions:[] even when the sequence HAS a working caption track. The response…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | Optional sequence ID. Defaults to the active sequence. |
Reads and parses an .srt subtitle file off disk into structured cues [{ index, start, end, startTimecode, endTimecode, text }] with start/end in seconds. This is the caption READ path Premiere itself cannot provide (read_sequence_captions is blocked by an Adobe DOM limitation). Robust to a UTF-8…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| srtPath | string | yes | Absolute path to the .srt file to read. |
Reads an .srt file and returns ONLY a QC report on its cues without modifying anything: structural errors (negative time, zero/negative-duration cues) and quality warnings (overlapping cues, out-of-chronological-order starts, empty text), plus a count of malformed blocks. Read-only; no Premiere…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| srtPath | string | yes | Absolute path to the .srt file to validate. |
Writes a complete .srt file from a full list of cues, replacing any existing file at the path. Cues are renumbered sequentially from 1 and written in canonical HH:MM:SS,mmm --> HH:MM:SS,mmm form. Refuses to write cues with structural errors (e.g. end not after start) unless allowInvalid=true,…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| srtPath | string | yes | Absolute path to write the .srt to (overwritten if it exists). |
| cues | array | yes | The full ordered list of cues to write. An empty list writes an empty file. |
| allowInvalid | boolean | no | — |
Edits one cue in an existing .srt file, addressed by its 1-based index, changing any of start / end / text (omitted fields are left unchanged). Reads the file, applies the change, and writes it back with read-back verification. Returns the before/after of the edited cue. Host-independent; no…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| srtPath | string | yes | Absolute path to the .srt file to edit. |
| index | integer | yes | 1-based cue number to edit (as shown by read_srt). |
| start | no | New start: seconds or "HH:MM:SS,mmm". Omit to keep. | |
| end | no | New end: seconds or "HH:MM:SS,mmm". Omit to keep. | |
| text | string | no | New cue text. Omit to keep. |
Inserts a new cue into an existing .srt file. The cue is placed in chronological order by its start time (the file stays time-sorted) and all cues are renumbered. Reads, inserts, and writes back with read-back verification. Host-independent; no Premiere request.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| srtPath | string | yes | Absolute path to the .srt file to edit. |
| start | yes | Cue start: seconds or "HH:MM:SS,mmm". | |
| end | yes | Cue end: seconds or "HH:MM:SS,mmm". | |
| text | string | yes | Cue text; may contain newlines. |
Removes one cue from an existing .srt file, addressed by its 1-based index, and renumbers the rest. Reads, removes, and writes back with read-back verification. Returns the removed cue. Host-independent; no Premiere request.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| srtPath | string | yes | Absolute path to the .srt file to edit. |
| index | integer | yes | 1-based cue number to remove (as shown by read_srt). |
Shifts caption timing in an .srt file to fix sync drift. Adds a fixed offset in seconds (negative pulls captions earlier) to every cue, or to a contiguous 1-based range only (fromIndex..toIndex) when the head is in sync but a later section drifts. Optionally also scales all timing by a positive…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| srtPath | string | yes | Absolute path to the .srt file to retime. |
| offsetSeconds | number | no | Seconds to add to each cue (may be negative). Default 0. |
| scaleFactor | number | no | — |
| fromIndex | integer | no | 1-based first cue the offset applies to. Default 1 (all). |
| toIndex | integer | no | 1-based last cue the offset applies to. Default last (all). |
Reads ground-truth technical metadata from a media file with ffprobe (run via child_process), NOT via Premiere -- so it works on any file on disk whether or not it is imported, online, or offline, and reports the container/stream facts Premiere's own get_metadata cannot: exact codec and profile,…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mediaPath | string | no | Direct filesystem path to the media file to probe |
| projectItemId | string | no | — |
Renders a signal/QC scope image -- waveform, vectorscope, histogram, or RGB parade -- from a single frame of a media file using ffmpeg (run via child_process), NOT via Premiere, whose Lumetri scopes cannot be scripted or exported. Grabs the frame at timeSeconds, applies the chosen scope filter,…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mediaPath | string | no | Direct filesystem path to the media file to analyze |
| projectItemId | string | no | — |
| scope | string | no | — |
| timeSeconds | number | no | — |
| outputPath | string | no | — |
Captures the actual COMPOSITED Program Monitor output -- the real rendered pixels of the sequence at a given time, with all clips, effects, transitions, titles and grades baked in -- and writes it to an image, so an AI can SEE what the edit renders to rather than trusting that an API call…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | Sequence to capture. Defaults to the active sequence. |
| time | number | no | — |
| format | string | no | Image format for the render/export tap (default "png"). |
| outputPath | string | no | — |
| tap | string | no | — |
| probeOnly | boolean | no | — |
Renders a NEW media file at a constant changed speed using ffmpeg (run via child_process), NOT via Premiere. This is the honest escape hatch for time-remapping: Premiere's scripting API has never exposed the time-remap/speed keyframe graph, so agents that "set a speed ramp" through the DOM get…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mediaPath | string | no | Direct filesystem path to the source media file |
| projectItemId | string | no | — |
| speed | number | no | — |
| outputPath | string | no | — |
| includeAudio | boolean | no | — |
| preservePitch | boolean | no | — |
Renders a NEW audio-normalized media file to a broadcast loudness target using ffmpeg's two-pass loudnorm (EBU R128), run via child_process, NOT via Premiere. Premiere exposes no scriptable loudness measurement or normalization, so agents cannot hit a delivery spec (e.g. -14 LUFS for streaming,…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mediaPath | string | no | Direct filesystem path to the source media file |
| projectItemId | string | no | — |
| targetLufs | number | no | — |
| truePeakDb | number | no | Maximum true peak in dBTP (default -1.0). |
| loudnessRange | number | no | Target loudness range (LRA) in LU (default 11). |
| outputPath | string | no | — |
Runs automated quality-control checks on a sequence and returns a list of findings -- the "layout lint" half of the render-truth loop. Walks every video and audio track and flags common editorial defects an agent (or human) cannot easily see from the DOM: GAPS between clips (black/silence), FLASH…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | Sequence to lint. Defaults to the active sequence. |
| flashFrameThresholdFrames | number | no | Clips shorter than this many frames are flagged as flash frames (default 2). |
| gapThresholdFrames | number | no | — |
| checks | array | no | Subset of checks to run. Defaults to all. |
Compares two sequences clip-by-clip and reports exactly what changed between them -- the version-diff for an edit. Walks both timelines and classifies every difference as ADDED (a clip only in B), REMOVED (only in A), MOVED (the same clip at a new start time) or RETIMED (the same clip with a new…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceIdA | string | yes | The "before" sequence (the baseline / original). |
| sequenceIdB | string | yes | The "after" sequence (the edited / current version) to compare against A. |
Builds or refreshes a local, persistent index of media files on disk so footage DISCOVERY stops requiring the media to be imported into Premiere first. Walks a folder (recursively by default), reads each file's technical metadata with ffprobe, and writes a JSON index. Incremental: files whose path…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| rootPath | string | yes | Absolute path of the folder to scan for media. |
| recursive | boolean | no | — |
| extensions | array | no | — |
| indexPath | string | no | — |
| pruneMissing | boolean | no | — |
Searches the local footage index built by index_footage, entirely offline -- no Premiere request. Find the right clip before importing it by filtering on filename substring, file extension, codec, duration/resolution/frame-rate ranges, and whether the file has audio or video. Returns matches with…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | no | — |
| extension | string | no | Match a single file extension (with or without the dot). |
| codec | string | no | Match a video OR audio codec name (e.g. "h264", "prores", "pcm_s24le"). |
| minDurationSeconds | number | no | Only files at least this long. |
| maxDurationSeconds | number | no | Only files at most this long. |
| minWidth | number | no | Minimum video width in pixels. |
| minHeight | number | no | Minimum video height in pixels. |
| minFps | number | no | Minimum video frame rate. |
| maxFps | number | no | Maximum video frame rate. |
| hasAudio | boolean | no | Require (true) or exclude (false) files with an audio stream. |
| hasVideo | boolean | no | Require (true) or exclude (false) files with a video stream. |
| indexPath | string | no | — |
| limit | number | no | Maximum number of results to return (default 100). |
Renames a project item (sequence, bin, clip) by setting its name. Use this when duplicate_sequence does not propagate the new name to the project panel.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | The ID of the project item to rename |
| newName | string | yes | The new name for the project item |
Creates a subclip from a project item with specified in/out points.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | The ID of the source project item |
| name | string | yes | Name for the subclip |
| startTime | number | yes | In point in seconds |
| endTime | number | yes | Out point in seconds |
| hasHardBoundaries | boolean | no | Whether boundaries are hard (cannot be extended) |
| takeAudio | boolean | no | Whether to include audio (default: true) |
| takeVideo | boolean | no | Whether to include video (default: true) |
Relinks an offline or moved media file to a new file path.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | The ID of the project item to relink |
| newFilePath | string | yes | The new absolute file path to relink to |
Sets the color label on a project item.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | The ID of the project item |
| colorIndex | number | yes | — |
Gets the color label index of a project item.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | The ID of the project item |
Gets project metadata and XMP metadata for a project item.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | The ID of the project item |
Sets a project metadata value on a project item.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | The ID of the project item |
| key | string | yes | The metadata key/field name |
| value | string | yes | The metadata value to set |
Gets the footage interpretation settings (frame rate, pixel aspect ratio, field type, etc.) for a project item.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | The ID of the project item |
Sets footage interpretation settings (frame rate, pixel aspect ratio) for a project item.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | The ID of the project item |
| frameRate | number | no | Override frame rate |
| pixelAspectRatio | number | no | Override pixel aspect ratio |
Checks all project items and returns a list of any that are offline (missing media).
No parameter schema on file.
Exports a sequence as Final Cut Pro XML.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | The ID of the sequence to export. Defaults to the active sequence. |
| outputPath | string | yes | The absolute file path for the exported XML file |
Performs an undo operation in Premiere Pro.
No parameter schema on file.
Sets the in and/or out points on a sequence timeline.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | The ID of the sequence. Defaults to the active sequence. |
| inPoint | number | no | The in point in seconds |
| outPoint | number | no | The out point in seconds |
Gets the in and out points of a sequence timeline.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | The ID of the sequence. Defaults to the active sequence. |
Exports a sequence as an AAF file for interchange with other editing/audio applications.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | The ID of the sequence to export. Defaults to the active sequence. |
| outputPath | string | yes | The absolute file path for the exported AAF file |
| mixDownVideo | boolean | no | — |
| explodeToMono | boolean | no | Whether to explode audio to mono (default: false) |
| sampleRate | number | no | Audio sample rate (default: 48000) |
| bitsPerSample | number | no | Audio bits per sample (default: 16) |
Consolidates duplicate media items in the project.
No parameter schema on file.
Refreshes the media for a project item, reloading it from disk.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | The ID of the project item to refresh |
Imports sequences from another Premiere Pro project file.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectPath | string | yes | The absolute path to the source .prproj file |
| sequenceIds | array | yes | Array of sequence IDs to import from the source project |
Creates a subsequence from the in/out points of a sequence.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | The ID of the source sequence. Defaults to the active sequence. |
| ignoreTrackTargeting | boolean | no | Whether to ignore track targeting (default: false) |
Imports a Motion Graphics Template (.mogrt) file into a sequence.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | The ID of the sequence. Defaults to the active sequence. |
| mogrtPath | string | yes | The absolute path to the .mogrt file |
| time | number | yes | The time in seconds where the MOGRT should be placed |
| videoTrackIndex | number | no | The video track index (default: 0) |
| audioTrackIndex | number | no | The audio track index (default: 0) |
Imports a Motion Graphics Template from a Creative Cloud Library.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | The ID of the sequence. Defaults to the active sequence. |
| libraryName | string | yes | The name of the Creative Cloud Library |
| mogrtName | string | yes | The name of the MOGRT in the library |
| time | number | yes | The time in seconds where the MOGRT should be placed |
| videoTrackIndex | number | no | The video track index (default: 0) |
| audioTrackIndex | number | no | The audio track index (default: 0) |
Checks proxy status, attaches a proxy file, or gets the proxy path for a project item.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | The ID of the project item |
| action | string | yes | The proxy action: check status, attach a proxy, or get proxy path |
| proxyPath | string | no | The absolute path to the proxy file (required for attach action) |
Sets a Parametric Equalizer band on an audio clip using QE component params. Finds the EQ component and sets frequency/gain/Q for a specified band (1-5).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | yes | 0-based audio track index |
| clipIndex | number | yes | 0-based clip index |
| band | number | yes | EQ band 1-5 |
| frequency | number | no | Center frequency in Hz |
| gain | number | no | Gain in dB (-24 to +24) |
| q | number | no | Q factor (bandwidth) |
Sets Dynamics Processing compressor parameters on an audio clip. Finds the Dynamics Processing component and sets threshold, ratio, attack, release via QE.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| threshold | number | no | Threshold in dBFS |
| ratio | number | no | Compression ratio (e.g. 4 for 4:1) |
| attack | number | no | Attack time in ms |
| release | number | no | Release time in ms |
Sets a limiter ceiling on an audio clip. Applies Dynamics Processing limiter params via QE.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| ceiling | number | yes | Limiter ceiling in dBFS (e.g. -0.3) |
Applies the DeReverb audio effect to a clip at the given audio track/clip index using QE addAudioEffect.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | yes | 0-based audio track |
| clipIndex | number | yes | — |
| amount | number | no | Amount 0-100. Default 50. |
Normalizes all clips on an audio track to a target peak dBFS. Uses ffprobe to measure each clip peak, then sets clip gain accordingly.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | yes | 0-based audio track index |
| targetDbfs | number | no | Target peak dBFS. Default -3. |
Fills an EMPTY span on one audio track with room tone: audio-only subclips of the source cut to the gap, looped when the gap is longer than the media. Refuses if anything already occupies the span on that track; never places video. Verified by reading back the track coverage.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | yes | 0-based audio track |
| gapStartSecs | number | yes | Gap start in seconds |
| gapDurationSecs | number | yes | Gap duration in seconds |
| roomToneItemId | string | yes | Project item nodeId of the room tone clip |
Exports individual audio tracks as separate files by muting all except the target track and exporting. Args: sequenceId, trackIndices (array), outputDir, format (wav|aac).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndices | array | yes | Audio track indices to export separately |
| outputDir | string | yes | Output directory for stem files |
| format | string | no | Output format. Default wav. |
Reports audio channel mapping for clips in the active sequence — track counts, channel layout, sample rate per clip.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Enables or disables multicam mode on a timeline clip via QE setMulticam(bool). First checks canDoMulticam().
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | yes | 0-based video track |
| clipIndex | number | yes | 0-based clip index |
| enabled | boolean | yes | Enable or disable multicam mode |
Returns the number of angles/tracks in a multicam source sequence. Uses isMulticamClip() to verify and videoTracks.numTracks for count.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Flattens a multicam clip by disabling multicam mode (setMulticam(false)), converting it to a single-stream clip at the current active angle.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
Returns multicam status of a clip: isMulticamClip, canDoMulticam, multicamEnabled from the QE clip.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
Switches the active multicam angle via QE setSwitchSources(sourceIndex). Args: trackIndex, clipIndex, angleIndex.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| angleIndex | number | yes | 0-based angle index |
Creates a multicam source sequence by placing clips from a bin on separate video tracks aligned at their media start timecode. Args: binName, newSeqName, presetPath.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| binName | string | yes | — |
| binId | string | no | — |
| newSequenceName | string | yes | Name for the new multicam source sequence |
| presetPath | string | no | Sequence preset path |
Builds a finished multicam cut: a new sequence whose V1 is a run of real multicam clips, each showing the angle you choose, so the cut stays re-switchable in Premiere. Angles are synced at their media start. Built through an FCP7 XML import because ExtendScript cannot create a multicam source or…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| angleItemIds | array | yes | Project item nodeIds of the camera clips, in angle order (angle 1 first) |
| cuts | array | yes | The edit: one entry per cut, in seconds from the start of the angles |
| sequenceName | string | yes | Name for the new sequence |
Creates a multicam sequence from a list of project item IDs placed on separate tracks, synced at their timecodes.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemIds | array | yes | Array of project item nodeIds (one per angle) |
| sequenceName | string | yes | — |
| presetPath | string | no | — |
Exports two frames from the active sequence at different times and computes their visual difference using ffmpeg PSNR. Returns PSNR score — lower means more different.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| time1Secs | number | yes | First frame time in seconds |
| time2Secs | number | yes | Second frame time in seconds |
| outputDir | string | no | Directory for temp frames. Default /tmp. |
| sequenceId | string | no | — |
PIXEL VERIFICATION: confirms that an effect actually changed the rendered output of a clip — not just that the params were set. Captures a frame before and after applying the effect, runs ffmpeg PSNR, and reports whether a visible pixel difference was detected. Closes the QE silent-no-op honesty…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | yes | 0-based video track index |
| clipIndex | number | yes | 0-based clip index |
| effectName | string | yes | Effect to apply and verify (e.g. "Gaussian Blur") |
| effectParam | string | no | A param name to set to confirm the effect is active (e.g. "Amount") |
| effectParamValue | string | no | Value to set the param to |
| outputDir | string | no | — |
PIXEL VERIFICATION: confirms that a Lumetri color grade actually changed the rendered output. Captures a frame before and after setting grade params, runs ffmpeg PSNR, and reports whether a visible change occurred. Use after lumetri_basic_set or paste_grade_to_clips to close the verify gap.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | yes | 0-based video track index |
| clipIndex | number | yes | 0-based clip index |
| gradeParams | object | yes | The Lumetri params to apply — used to verify this specific grade landed |
| outputDir | string | no | — |
Checks whether a clip is actually contributing pixels: track not muted, clip enabled, opacity > 0, not fully obscured by a higher track. Returns a visibility assessment.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
Executes multiple ExtendScript operations in a single bridge round-trip, dramatically faster than individual tool calls for bulk operations. Each operation is an ExtendScript snippet that returns a JSON string. Results are returned as an array in the same order. Use for bulk property reads, batch…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| operations | array | yes | Array of ExtendScript operations to run in sequence |
| enableQE | boolean | no | Call app.enableQE() once before all operations. Default false. |
Exports the active sequence (or a clip) as a Premiere Pro project file that After Effects can open, enabling a round-trip workflow. AE can then render comps back as media for Premiere. Returns the output .prproj path.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| outputPath | string | yes | Absolute path for the output .prproj file |
| sequenceId | string | no | Sequence to export. Defaults to active sequence. |
Imports Frame.io review notes from a JSON export file and creates sequence markers at the corresponding timecodes. Frame.io exports a JSON with comments + timestamps when you use "Export Comments". Each comment becomes a marker with the reviewer name and comment text.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| jsonPath | string | yes | Path to Frame.io comments JSON export file |
| sequenceId | string | no | Target sequence. Defaults to active. |
| markerColor | number | no | Color index for all imported markers. Default 1 (yellow). |
Reads a ShotGrid/ShotGrid (Autodesk) status CSV (shot name, status, assignee) and updates Premiere sequence labels + metadata to match. Maps ShotGrid statuses to label colors and writes shot code + status to project metadata. The CSV must have columns: shot_name, status, assignee.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| csvPath | string | yes | Path to ShotGrid status CSV export |
| statusToColor | object | no | — |
Scans a video file or exported sequence range for black frames using ffmpeg blackdetect filter. Returns list of black frame time ranges.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| filePath | string | yes | Path to video file to scan |
| threshold | number | no | Black threshold 0-1. Default 0.1. |
| minDuration | number | no | Minimum black duration in seconds. Default 0.1. |
Scans a video file for flash frames (frames significantly brighter than neighbors) using ffmpeg. Returns timecodes of potential flashes.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| filePath | string | yes | Path to video file |
| threshold | number | no | Brightness threshold 0-1. Default 0.9. |
Scans a video file for frozen frames (consecutive identical frames) using ffmpeg freezedetect. Returns list of freeze time ranges.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| filePath | string | yes | Path to video file |
| minDuration | number | no | Min freeze duration in seconds. Default 0.5. |
Scans an audio file for silence using ffmpeg silencedetect. Returns silence start/end times and durations.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| filePath | string | yes | Path to audio/video file |
| noiseDb | number | no | Noise threshold in dB. Default -50. |
| minDuration | number | no | Min silence duration in seconds. Default 0.5. |
Runs a self-test of core MCP tools against the live Premiere host (ping, get_version_info, get_premiere_state, list_sequences) and returns pass/fail for each. Confirms the bridge is healthy.
No parameter schema on file.
Converts the current project into a Production via qe.ea.convertProjectIntoProduction(). Requires Creative Cloud login. Returns production ID on success.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| productionPath | string | yes | Path where the Production folder will be created |
| description | string | no | Production description |
Shares the current Production with team via qe.ea.share(). Requires CC login and an active Production.
No parameter schema on file.
Syncs the current Production with the server via qe.ea.sync(). Pulls remote changes and pushes local changes.
No parameter schema on file.
Returns a list of sync conflicts in the current Production via qe.ea.getConflicts(). Each conflict includes a description and resolution options.
No parameter schema on file.
Resolves a production sync conflict via qe.ea.resolveConflict(conflictId, resolution). Resolution options vary by conflict type.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| conflictId | string | yes | Conflict ID from get_conflicts |
| resolution | string | yes | Resolution action (e.g. "mine", "theirs", "manual") |
Returns the current Production sync status: session sync state, whether the project has unshared changes, and login status.
No parameter schema on file.
Stops playback in the Source Monitor via qe.source.player.stop().
No parameter schema on file.
Steps the Source Monitor playhead by one frame (or N frames) via qe.source.player.step(deltaTimecode).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| frames | number | no | Frames to step. Positive=forward, negative=backward. Default 1. |
Scrubs the Source Monitor to a specific timecode via qe.source.player.scrubTo(timecode). Confirmed method.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| timecode | string | yes | Timecode string e.g. "00:00:01:00" |
Returns the current Source Monitor playhead position via qe.source.player.getPosition().
No parameter schema on file.
Opens a media file by path in the Source Monitor via qe.source.openFilePath(path). Confirmed working.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| filePath | string | yes | Absolute path to the media file |
Sets source monitor in/out points via qe.source.clip.setInPoint(tc) and setOutPoint(tc). Both confirmed. Pass null to clear either point.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| inPoint | string | no | In-point timecode or null to clear |
| outPoint | string | no | Out-point timecode or null to clear |
Returns info about the clip currently loaded in the Source Monitor via qe.source.clip: type, methods available, playhead position.
No parameter schema on file.
Exports the sequence with timecode burn-in: applies a Metadata & Timecode Burn-in effect on an adjustment layer, exports, then removes it. Returns output path.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| outputPath | string | yes | Output file path |
| presetPath | string | no | AME preset path. Default: H.264. |
Exports the active sequence and copies all source media to an archive folder, writing a manifest.json with file names and sizes. Args: outputDir.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| outputDir | string | yes | Directory to write the archive into |
| includeProxy | boolean | no | Include proxy files. Default false. |
Adds the active sequence to the AME queue and starts encoding. Returns job status immediately. Use get_export_progress to poll.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| outputPath | string | yes | Output file path |
| presetPath | string | no | AME .epr preset path |
| workAreaType | number | no | 0=entire, 1=work area. Default 0. |
Exports one media file per PAIR of sequence markers (marker 1 to marker 2, marker 3 to marker 4, ...), by setting the sequence in/out to each range and calling exportAsMediaDirect. Output filenames are built from the opening marker name and assume a .mp4 extension, so a preset that writes another…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| outputDir | string | yes | Output directory |
| presetPath | string | no | AME preset path |
| markerNamePattern | string | no | Filter markers by name prefix. Default: all marker pairs. |
| sequenceId | string | no | Sequence to export from. Defaults to the active sequence. |
Exports multiple sequences with the same AME preset. Args: sequenceIds, outputDir, preset. Returns list of output paths.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceIds | array | yes | Sequence IDs to export |
| outputDir | string | yes | Output directory |
| presetPath | string | no | AME .epr preset path |
Exports the active sequence as OMF via app.project.exportOMF(), then verifies it by checking that a new file arrived at outputPath (the API reports nothing about its own result). Only the path is honoured. 48 kHz / 16-bit.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| outputPath | string | yes | Output .omf file path |
Exports the active sequence as AAF via app.project.exportAAF(), then verifies it by checking that a new file arrived at outputPath (the API reports nothing about its own result). Only the path is honoured. 48 kHz / 16-bit.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| outputPath | string | yes | Output .aaf file path |
Uses ffprobe to verify an exported file: returns duration, fps, resolution, codec, file size, and whether they match expected sequence settings.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| filePath | string | yes | Path to the exported file to verify |
| expectedDurationSecs | number | no | — |
| expectedFps | number | no | — |
| expectedWidth | number | no | — |
| expectedHeight | number | no | — |
Creates a lower-third text overlay at a specified time: two text layers (name + title) positioned at the bottom third of the frame. Uses add_text_overlay internally.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | yes | Main name text |
| title | string | no | Title/role below name |
| startTimeSecs | number | yes | Start time in seconds |
| durationSecs | number | no | Duration in seconds. Default 5. |
| trackIndex | number | no | Video track. Default 1. |
| mogrtPath | string | no | — |
| sequenceId | string | no | — |
Creates a full-screen centered text card clip at a specified time. Single text overlay, centered.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| text | string | yes | Text to display |
| startTimeSecs | number | yes | Start time in seconds |
| durationSecs | number | no | Duration. Default 3. |
| trackIndex | number | no | Video track. Default 1. |
| mogrtPath | string | no | — |
| sequenceId | string | no | — |
Imports a PNG/logo and places it as a clip on the topmost video track spanning the full sequence, with specified opacity. Confirms with clip count readback.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| logoPath | string | yes | Absolute path to the PNG/logo file |
| opacity | number | no | Opacity %. Default 50. |
| corner | string | no | Corner placement. Default top-right. |
| sequenceId | string | no | — |
Sets a color parameter on a MOGRT clip by display name. Finds the first isMGT() clip on the specified track and sets the named color param.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
| paramName | string | yes | Parameter display name |
| r | number | yes | — |
| g | number | yes | — |
| b | number | yes | — |
Finds all MOGRT clips in the active sequence and returns their text parameters — name, track, clip index, and all text param values.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Removes a specific MOGRT clip from the timeline by track+clip index. Verifies removal with clip count readback.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | yes | — |
| clipIndex | number | yes | — |
Places lower-third MOGRTs at multiple timecodes from a data array. Each entry specifies time + text fields. Uses set_mogrt_text internally.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| items | array | yes | Array of lower-third data items |
| durationSecs | number | no | Duration per MOGRT. Default 5. |
| trackIndex | number | no | Video track. Default 1. |
| mogrtPath | string | no | MOGRT template path |
| sequenceId | string | no | — |
Creates a countdown text sequence (5, 4, 3, 2, 1) using text overlay clips. One clip per second. Placed at the specified start time.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| startTimeSecs | number | yes | Start time in seconds for the countdown |
| count | number | no | Count from this number down to 1. Default 5. |
| trackIndex | number | no | Video track. Default 1. |
| mogrtPath | string | no | — |
| sequenceId | string | no | — |
Creates an adjustment layer clip at the specified time/track by importing a transparent solid and placing it. Returns clip info.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| startTimeSecs | number | yes | Start time in seconds |
| durationSecs | number | yes | Duration in seconds |
| trackIndex | number | no | Video track index. Default top track. |
| sequenceId | string | no | — |
Selects all clips on V1 and nests them into a new subsequence. Uses seq.setSelection + nest_clips. Returns the new nested sequence info.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| newSequenceName | string | yes | Name for the nested sequence |
| sequenceId | string | no | — |
Creates a new sequence and populates it with all clips from a named bin, placed sequentially on V1. Args: binName, sequenceName, presetPath.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| binName | string | yes | — |
| binId | string | no | — |
| sequenceName | string | yes | Name for the new sequence |
| presetPath | string | no | Sequence preset path |
Returns a report of all effects on all clips across all video tracks in the active sequence — clip name, track, effect name, effect matchName.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Replaces every timeline clip (video, or audio-only) that uses oldProjectItemId with newProjectItemId (across all sequences, or one with sequenceId), one replace_clip per clip, so each keeps its trim, effects, keyframes and linked audio. A clip whose swap is refused (new media too short, something…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| oldProjectItemId | string | yes | NodeId of the project item to replace |
| newProjectItemId | string | yes | NodeId of the replacement project item |
| sequenceId | string | no | Limit to one sequence. Default: all sequences. |
Clears the sequence in/out points (work area markers) back to full sequence length.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Returns all gaps (empty ranges) in the active sequence across all video tracks. More detailed than get_timeline_gaps.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| trackIndex | number | no | Limit to one track. Default: check all video tracks. |
Sets the starting timecode of the sequence (zero point). Args: timecode string like "01:00:00:00".
| Parameter | Type | Required | Notes |
|---|---|---|---|
| timecode | string | yes | Starting timecode e.g. "01:00:00:00" |
| sequenceId | string | no | — |
Selects all clips on a specified track. Optionally limit to a time range.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trackIndex | number | yes | 0-based video track index |
| startSecs | number | no | Optional start of time range |
| endSecs | number | no | Optional end of time range |
| sequenceId | string | no | — |
Returns the duration of a sequence in seconds, ticks, and frames. Also returns frame size, fps, and total frame count.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
Returns the number of currently open Premiere Pro projects. Quick check via app.projects.numProjects.
No parameter schema on file.
Sets an APPLICATION-level property (app.properties, despite the name; same as set_app_property) and reads it back: fails if the value does not read back as requested. For project-wide settings use the project/sequence settings tools.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| key | string | yes | Property key |
| value | string | yes | Property value |
Gets an application-level property via app.properties.getProperty(key). Returns the property value.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| key | string | yes | Property key |
Lists all available video transitions by name via qe.project.getVideoTransitionList(). Includes Morph Cut.
No parameter schema on file.
Lists all available audio transitions by name via qe.project.getAudioTransitionList(). Returns Constant Power, Constant Gain, Exponential Fade.
No parameter schema on file.
Returns full Creative Cloud / Productions login status: isLoggedIn, userEmail, username, productionList count, sessionSyncStatus. Uses qe.ea confirmed APIs.
No parameter schema on file.
Shows you the cut: renders one frame from the middle of each shot (or at the times you give) and returns them tiled into a single labelled contact sheet image, so you can see what is on screen in one call. Use it after an edit to check the result. Read-only.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | — |
| times | array | no | — |
| maxFrames | number | no | At most this many frames (default 8, max 16) |
| outputPath | string | no | — |
Undoes the whole of the last edit made through this server, however many Premiere steps it took (undo reverses one step; remove_silence or replace_clip take many). Undoes step by step until the sequence is exactly as it was before that call, and if it never gets there redoes everything, so a…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | Revert the last edit on this sequence (default: the last edit anywhere) |
| force | boolean | no | Also undo changes made after that call |
| maxSteps | number | no | Most undo steps to try (default 40, max 200) |
What changed in a sequence since the last edit made through this server, or since the last what_changed: clips added, removed, moved or trimmed, renamed, tracks, markers, and project sequence/item counts. Use it after the user has worked in Premiere by hand, before relying on clip ids from earlier…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequenceId | string | no | Default: the active sequence |
Reads this project's notes: conventions recorded with add_project_note (shot naming, where renders land, bins, the export preset the client wants). Kept as a Markdown file next to the .prproj; get_project_info includes it too.
No parameter schema on file.
Records a convention for this project so later sessions (and teammates) start knowing it, e.g. "shots are SC<seq>_<shot>; comps land in /renders/<shot>/". Appended under a section in the Markdown notes file next to the .prproj.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| note | string | yes | The convention, one line |
| section | string | no | Section heading (default "Conventions") |
Rough cut from a transcript: give the lines you want (quotes, in cut order) and a Whisper .json or .srt transcript of the source clip, and this builds a new sequence with just those moments, end to end. Quotes are found by their words (case and punctuation ignored, near-misses allowed and reported…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | The source clip (project item) the transcript belongs to |
| transcriptPath | string | no | Whisper .json (word timestamps preferred) or .srt of that clip |
| quotes | array | no | Lines to use, in the order they should play |
| ranges | array | no | Source ranges in seconds, used when there are no quotes |
| sequenceName | string | no | Name of the new sequence (default: "<clip> stringout") |
| handleSeconds | number | no | Air kept before and after each line (default 0.15) |
| gapSeconds | number | no | Black between lines (default 0) |
| minScore | number | no | How close a quote must match, 0-1 (default 0.75) |
| dryRun | boolean | no | Only report the matched ranges |
Lines up clips recorded at the same time (several cameras, a camera and a separate sound recorder) by matching their audio waveforms. Returns each clip's offset from the reference in seconds and a match score (0-1; below about 0.3 the audio probably is not the same event). With sequenceName it…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| referenceItemId | string | yes | Project item to sync everything to |
| itemIds | array | yes | Project items to sync to the reference |
| maxOffsetSeconds | number | no | Search range either way (default 30) |
| analyzeSeconds | number | no | How much of each file to compare (default 90) |
| sequenceName | string | no | Build a synced sequence with this name |
Cuts the silent pauses out of a clip and closes each gap on EVERY track, so picture, music and other audio stay in sync (jump-cut style). Detects silence in the clip's own audio with ffmpeg, keeps a little padding either side, and snaps cuts to frames. Without confirm it only returns the plan…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clipId | string | yes | Timeline clip whose audio decides what is silent |
| noiseThresholdDb | number | no | Quieter than this is silence (default -35 dBFS) |
| minSilenceSeconds | number | no | Shortest pause to cut (default 0.5) |
| paddingSeconds | number | no | Pause kept either side of each cut (default 0.1) |
| confirm | boolean | no | Apply the cuts (default: return the plan and ask) |
Brings every versioned shot in the project up to its newest render on disk. Finds project items whose file is named like SH010_comp_v003.mp4, looks for newer versions (same name, higher _v number, same extension) in the folders those files are in plus any renderDirs you give, and relinks each item…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| renderDirs | array | no | Extra folders to search for new versions (absolute paths) |
| recursive | boolean | no | Search subfolders of renderDirs too (default true) |
| dryRun | boolean | no | Only report the plan; change nothing (default false) |
| shotFilter | string | no | Only shots whose name contains this text, e.g. "SH010" or "SQ05" |
Where is this project item used? Lists every timeline use of a clip, or of anything inside a bin: sequence, track and start time. Ask it before deleting or relinking media. Read-only.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectItemId | string | yes | Project item or bin nodeId |
| limit | number | no | Max uses to list (default 50); the total is always reported |
Answers "did my last call run?". Lists the most recent tool calls this server received, newest first, with status (running / ok / failed), start and finish times, and a summary of the result -- including calls whose response the client never saw because it timed out. Check it BEFORE retrying an…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| limit | number | no | How many calls (default 10, max 100) |
| mutatingOnly | boolean | no | Only calls that can change the project |
| sinceSeconds | number | no | Only calls started within this many seconds |
Runs any tool in the background and returns a jobId at once, so a slow call (export, render, transcription, stems, workflow) cannot outlive the client's timeout. Poll get_job with the jobId for status and, when done, the tool's own result. Jobs live in this server process.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tool | string | yes | Name of the tool to run |
| args | object | no | Arguments for that tool |
Status of a background job started with start_job: running / done / failed, elapsed seconds, and when finished the tool's result.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| jobId | string | yes | — |
Lists background jobs started with start_job in this server process, newest first, without their full results.
No parameter schema on file.
Searches THIS server's own tool catalogue by keyword and returns the best-matching tool names with their descriptions, ranked. Use it FIRST whenever you are unsure which tool does a job, instead of guessing a name and getting "Tool not found" -- this catalogue has hundreds of tools and searching…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | yes | — |
| limit | number | no | Max matches to return (default 15, max 100) |
| readOnly | boolean | no | — |
| includeParameters | boolean | no | — |
| includeHidden | boolean | no | — |
Invokes ANY tool this build implements, including tools the active profile does not advertise, by name. Use this when find_tool showed you a tool marked exposed:false -- it is the call path for the rest of the catalogue, so a curated tool list costs you context, not capability. Call…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | yes | — |
| args | object | no | — |
| dryRun | boolean | no | — |
- Every tool, no call limit
- No card, and mcprush charges nothing for it
- Source published under MIT
- Runs on your machine — nothing of it reaches our gateway
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install Premiere or to call it, at any volume.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
| Term | Level | What it prices | Points |
|---|---|---|---|
| capability-exposure | high | capability blast radius (high) — client exposure if the model is manipulated | −6 |
| verification-discount | repo | publisher verification (public source) — no provenance, but the source is public and inspectable | −1 |
| coverage-honesty | source | inspection depth (source) — how much of the target the scan could see | −0 |
What the scan could actually read
A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.
No tools were enumerated, so prompt-injection, capability and toxic-flow analysis had no tool surface to inspect. To grade a package’s real runtime tools, scan the running server: --command "npx -y <package>".
Capability — what it could do if the model were manipulated
Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. high is the level these add up to.
| Tool | Capability tags | Why the tag was assigned |
|---|---|---|
| No per-tool rows for this release — see the note below. | ||
Toxic-flow graph
The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.
The public result for this release does not print the flow graph, so there is nothing to show here. That is not the same as "no paths were found": what the scan did read is above, under coverage.
Supply chain and provenance
This is the first scan of this surface here, so there is nothing yet to compare it against.
Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.
Release history
Always latest — the install command names no version, so it installs the newest release when it runs; the current release on file is 1.6.0. Pin a release below and the command asks for exactly that one.
No release note was published with this version.
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Any signed-in account that does not publish Premiere can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.