Lists all media items, bins, and assets in the current Premiere Pro project. Use this to discover available media before performing operations.

Lists all sequences in the current Premiere Pro project with their IDs, names, and basic properties.

Lists all video and audio tracks in a specific sequence with their properties and clips.

Gets comprehensive information about the current project including name, path, settings, and status.

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.

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.

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.

Discovers readable user Adobe Media Encoder .epr presets from local AME preset folders. Factory preset enumeration is not claimed complete.

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.

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.

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.

Creates a new Adobe Premiere Pro project. Use this when the user wants to start a new video editing project from scratch.

Opens an existing Adobe Premiere Pro project from a specified file path.

Saves the currently active Adobe Premiere Pro project.

Saves the current project with a new name and location.

Imports a media file (video, audio, image) into the current Premiere Pro project.

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 from Final Cut Pro X.

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.

Imports all media files from a folder into the current Premiere Pro project.

Creates a new bin (folder) in the project panel to organize media.

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.

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.

Deletes a sequence from the project.

Adds a media clip from the project panel to a sequence timeline at a specific track and time.

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 clip. Each clip supports per-clip linkAudio and sourceInPoint/sourceOutPoint (Source-monitor in/out). Returns a per-clip result array so one bad clip does not sink the batch, plus an aggregate status: top-level success is true ONLY when every clip placed; status is "success" | "partial" | "failure" with placed/failed/total counts.

Removes a clip from the timeline. Pass sequenceId when the clip ID came from list_sequence_tracks for a non-active sequence.

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 remove-and-reinsert, which can overwrite whatever occupies the destination and gives the clip a new id, so it is deliberately a separate call rather than an option here.

Adjusts the in and out points of a clip on the timeline, effectively shortening it.

Splits a clip at a specific time point, creating two separate clips.

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.

Applies a visual or audio effect to a clip, identifies the exact newly created component, and verifies parameter readbacks.

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.

Adds a transition (e.g., cross dissolve) between two adjacent clips on the timeline.

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.

Adjusts the volume (gain) of an audio clip on the timeline.

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). Requires ffmpeg on PATH; returns an explicit error if it is not found rather than failing silently. This is DETECTION ONLY -- it does not cut or modify anything. Use the returned intervals with split_clip/ripple_delete/razor_timeline_at_time if you want to remove the silence.

Adds keyframes to audio levels for dynamic volume changes.

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. Times are clip-source-time absolute (same convention as add_audio_keyframes).

Mutes or unmutes an entire audio 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).

Applies basic color correction adjustments to a video clip.

Applies a Look-Up Table (LUT) to a clip for color grading.

Renders and exports a sequence to a video file. This is for creating the final video.

Exports a single frame from a sequence as an image file.

Adds a marker to the specified sequence for navigation or notes. The sequence does not have to be the active one.

Deletes a marker from the specified sequence. The sequence does not have to be the active one.

Updates an existing marker's properties in the specified sequence. The sequence does not have to be the active one.

Lists all markers in the specified sequence. The sequence does not have to be the active one.

Adds a new video or audio track to the sequence.

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 address is reported by name rather than deleted from the wrong timeline. Caption track deletion is accepted by the schema but returns an explicit unsupported result because Premiere Pro exposes no caption-track delete/read API to scripting.

Locks or unlocks a track to prevent/allow editing. The sequence does not have to be the active one.

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.

Links or unlinks audio and video components of a clip.

Applies an audio effect to a clip.

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.

Duplicates a clip on the timeline.

Reverses the playback of a clip.

Enables or disables a clip on the timeline.

Replaces a clip on the timeline with another media item.

Gets the settings for a sequence (resolution, framerate, etc.).

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.

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 clip ID came from list_sequence_tracks for a non-active sequence.

Sets Motion properties of a clip (opacity, scale, rotation, position).

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 ({opacity,scale,rotation,position}) and success is true only when EVERY requested property was actually found and set (a missing Motion property is reported, not silently ignored).

Adds a sequence to the Adobe Media Encoder render queue.

Reports whether render queue monitoring is available. This currently returns guidance for Adobe Media Encoder rather than live queue telemetry.

Applies video stabilization to reduce camera shake.

Changes the playback speed of a clip.

Gets the current playhead (CTI) position in the specified sequence.

Sets the playhead (CTI) position in the specified sequence.

Gets all currently selected clips in the specified sequence.

Lists all available video effects in Premiere Pro.

Lists all available video transitions in Premiere Pro.

Lists all available audio effects in Premiere Pro.

Lists all available audio transitions in Premiere Pro.

Adds a keyframe to a clip component parameter at a specific time.

Removes a keyframe from a clip component parameter at a specific time.

Gets all keyframes for a clip component parameter.

Sets the work area in/out points for a sequence.

Gets the work area in/out points for a sequence.

Adds a transition to all clip boundaries on a track. Useful for quickly adding cross dissolves or other transitions between every clip.

Searches for project items by name. Useful for finding media files, sequences, or bins.

Moves a project item into a different bin (folder).

Sets the active sequence in the project.

Gets information about the currently active sequence.

Gets the clip at a specific time position on a track.

Automatically reframes a sequence to a new aspect ratio using AI-powered motion tracking.

Detects scene changes in selected clips and optionally adds cuts or markers.

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.

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 field captionReadSupported:false (plus note) signals this — a 0 result does NOT mean the sequence has no captions. To read cue text/timing, parse the source .srt file directly instead.

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.

Creates a subclip from a project item with specified in/out points.

Relinks an offline or moved media file to a new file path.

Sets the color label on a project item.

Gets the color label index of a project item.

Gets project metadata and XMP metadata for a project item.

Sets a project metadata value on a project item.

Gets the footage interpretation settings (frame rate, pixel aspect ratio, field type, etc.) for a project item.

Sets footage interpretation settings (frame rate, pixel aspect ratio) for a project item.

Checks all project items and returns a list of any that are offline (missing media).

Exports a sequence as Final Cut Pro XML.

Performs an undo operation in Premiere Pro.

Sets the in and/or out points on a sequence timeline.

Gets the in and out points of a sequence timeline.

Exports a sequence as an AAF file for interchange with other editing/audio applications.

Consolidates duplicate media items in the project.

Refreshes the media for a project item, reloading it from disk.

Imports sequences from another Premiere Pro project file.

Creates a subsequence from the in/out points of a sequence.

Imports a Motion Graphics Template (.mogrt) file into a sequence.

Imports a Motion Graphics Template from a Creative Cloud Library.

Checks proxy status, attaches a proxy file, or gets the proxy path for a project item.

Premiere Pro expanded operation: find items by media path.

Premiere Pro expanded operation: get insertion bin.

Premiere Pro expanded operation: get project panel metadata.

Premiere Pro expanded operation: get graphics white luminance.

Premiere Pro expanded operation: get item info.

Premiere Pro expanded operation: is work area enabled.

Premiere Pro expanded operation: get xmp metadata.

Premiere Pro expanded operation: get color space.

Premiere Pro expanded operation: rename clip.

Premiere Pro expanded operation: get clip speed.

Premiere Pro expanded operation: set clip selection.

Premiere Pro expanded operation: link selection.

Premiere Pro expanded operation: unlink selection.

Premiere Pro expanded operation: execute extendscript.

Premiere Pro expanded operation: evaluate expression.

Premiere Pro expanded operation: inspect dom object.

Premiere Pro expanded operation: list clip effects.

Premiere Pro expanded operation: get sequence structure.

Premiere Pro expanded operation: get premiere state.

Premiere Pro expanded operation: get full project overview.

Premiere Pro expanded operation: get bin contents.

Premiere Pro expanded operation: get full sequence info.

Premiere Pro expanded operation: get full clip info.

Premiere Pro expanded operation: get project item info.

Premiere Pro expanded operation: search project items.

Premiere Pro expanded operation: get timeline gaps.

Premiere Pro expanded operation: get timeline summary.

Premiere Pro expanded operation: get offline media.

Premiere Pro expanded operation: get used media report.

Premiere Pro expanded operation: select clips by name.

Premiere Pro expanded operation: select all clips.

Premiere Pro expanded operation: deselect all clips.

Premiere Pro expanded operation: select clips in range.

Premiere Pro expanded operation: select disabled clips.

Premiere Pro expanded operation: open in source.

Premiere Pro expanded operation: close source monitor.

Premiere Pro expanded operation: close all source clips.

Premiere Pro expanded operation: set source in out.

Premiere Pro expanded operation: insert from source.

Premiere Pro expanded operation: overwrite from source.

Premiere Pro expanded operation: get source monitor info.

Premiere Pro expanded operation: set target track.

Premiere Pro expanded operation: get target tracks.

Premiere Pro expanded operation: rename track.

Premiere Pro expanded operation: get track info.

Premiere Pro expanded operation: clear item in out.

Premiere Pro expanded operation: set item in out.

Premiere Pro expanded operation: remove selected clips.

Premiere Pro expanded operation: redo.

Premiere Pro expanded operation: multiple undo.

Premiere Pro expanded operation: get version info.

Premiere Pro expanded operation: get all project paths.

Premiere Pro expanded operation: lift selection.

Premiere Pro expanded operation: extract selection.

Premiere Pro expanded operation: get project scratch disks.

Premiere Pro expanded operation: get sequence count.

Premiere Pro expanded operation: get total clip count.

Premiere Pro expanded operation: match frame.

Premiere Pro expanded operation: ping.

Premiere Pro expanded operation: get workspaces.

Premiere Pro expanded operation: set workspace.

Premiere Pro expanded operation: play timeline.

Premiere Pro expanded operation: stop playback.

Premiere Pro expanded operation: play source monitor.

Premiere Pro expanded operation: get source monitor position.

Premiere Pro expanded operation: close project.

Premiere Pro expanded operation: delete bin.

Premiere Pro expanded operation: rename bin.

Premiere Pro expanded operation: create smart bin.

Premiere Pro expanded operation: start batch encode.

Premiere Pro expanded operation: add custom metadata field.

Premiere Pro expanded operation: import sequences.

Premiere Pro expanded operation: create bars and tone.

Premiere Pro expanded operation: set transcode on ingest.

Premiere Pro expanded operation: set project panel metadata.

Premiere Pro expanded operation: set graphics white luminance.

Premiere Pro expanded operation: set scratch disk path.

Premiere Pro expanded operation: set offline.

Premiere Pro expanded operation: has proxy.

Premiere Pro expanded operation: detach proxy.

Premiere Pro expanded operation: set override frame rate.

Premiere Pro expanded operation: set override pixel aspect ratio.

Premiere Pro expanded operation: set scale to frame size.

Premiere Pro expanded operation: select item.

Premiere Pro expanded operation: set start time.

Premiere Pro expanded operation: unnest sequence.

Premiere Pro expanded operation: create sequence from preset.

Premiere Pro expanded operation: attach custom property.

Premiere Pro expanded operation: get export file extension.

Premiere Pro expanded operation: remove effect.

Premiere Pro expanded operation: set xmp metadata.

Premiere Pro expanded operation: capture frame.

Premiere Pro expanded operation: export omf.

Premiere Pro expanded operation: encode project item.

Premiere Pro expanded operation: encode file.

Premiere Pro expanded operation: ripple delete.

Premiere Pro expanded operation: roll edit.

Premiere Pro expanded operation: slide edit.

Premiere Pro expanded operation: slip edit.

Premiere Pro expanded operation: move clip to track.

Premiere Pro expanded operation: remove all effects.

Premiere Pro expanded operation: set clip speed qe.

Premiere Pro expanded operation: set frame blend.

Premiere Pro expanded operation: set time interpolation.

Premiere Pro expanded operation: overwrite clip.

Premiere Pro expanded operation: create sequence from clips.

Premiere Pro expanded operation: close sequence.

Premiere Pro expanded operation: export as project.

Premiere Pro expanded operation: set zero point.

Premiere Pro expanded operation: scene edit detection.

Premiere Pro expanded operation: delete preview files.

Premiere Pro expanded operation: add tracks.

Premiere Pro expanded operation: set color value.

Premiere Pro expanded operation: get clip adjustment layer.

Premiere Pro expanded operation: get linked items.

Premiere Pro expanded operation: get mogrt component.

Premiere Pro expanded operation: get effect properties.

Premiere Pro expanded operation: set effect property.

Premiere Pro expanded operation: remove keyframe range.

Premiere Pro expanded operation: set keyframe interpolation.

Premiere Pro expanded operation: get value at time.

Premiere Pro expanded operation: select clips by color.

Premiere Pro expanded operation: invert selection.

Premiere Pro expanded operation: copy effects between clips.

Premiere Pro expanded operation: copy effect values.

Premiere Pro expanded operation: replace clip media.

Premiere Pro expanded operation: batch apply effect.

Premiere Pro expanded operation: remove effect by name.

Premiere Pro expanded operation: set blend mode.

Premiere Pro expanded operation: set all tracks targeted.

Premiere Pro expanded operation: razor all tracks.

Premiere Pro expanded operation: set clip start time.

Premiere Pro expanded operation: import image sequence.

Premiere Pro expanded operation: set clip position.

Premiere Pro expanded operation: set clip scale.

Premiere Pro expanded operation: set clip rotation.

Premiere Pro expanded operation: set clip anchor point.

Premiere Pro expanded operation: set clip opacity.

Premiere Pro expanded operation: set clip volume.

Premiere Pro expanded operation: set clip pan.

Premiere Pro expanded operation: batch rename clips.

Premiere Pro expanded operation: batch enable disable.

Premiere Pro expanded operation: clear sequence in out.

Premiere Pro expanded operation: get qe clip info.

Premiere Pro expanded operation: set poster frame.

Premiere Pro expanded operation: move items to bin.

Premiere Pro expanded operation: set anti alias quality.

Premiere Pro expanded operation: set uniform scale.

Premiere Pro expanded operation: set scale width height.

Premiere Pro expanded operation: delete project item.

Premiere Pro expanded operation: delete multiple project items.

Premiere Pro expanded operation: add adjustment layer.

Premiere Pro expanded operation: freeze frame.

Premiere Pro expanded operation: set sequence frame rate.

Premiere Pro expanded operation: set sequence resolution.

Premiere Pro expanded operation: set sequence audio settings.

Premiere Pro expanded operation: set sequence pixel aspect ratio.

Premiere Pro expanded operation: set sequence field type.

Premiere Pro expanded operation: get unused media.

Premiere Pro expanded operation: get duplicate media.

Premiere Pro expanded operation: get clip links.

Premiere Pro expanded operation: get sequence markers by type.

Premiere Pro expanded operation: get clip markers.

Premiere Pro expanded operation: add marker to project item.

Premiere Pro expanded operation: set sequence display format.

Premiere Pro expanded operation: get clip at playhead.

Premiere Pro expanded operation: get next edit point.

Premiere Pro expanded operation: move playhead to edit.

Premiere Pro expanded operation: set project scratch disk.

Premiere Pro expanded operation: nest clips.

Premiere Pro expanded operation: consolidate and transfer.

Scriptable Comparison View: exports a reference frame and a target frame (same or different sequences) and writes them side by side into one image, with skin/midtone color measurements for both. Use before and after match_color.

Exports a sequence frame and returns luma (Y) and R/G, B/G ratios of skin tones (or a given region / midtones).

Scriptable Apply Match. Matches a target clip to a reference clip by iteratively adjusting Lumetri exposure, temperature and tint (on the clip itself or on the adjustment layer above it) until skin/midtone luma and warmth match. Returns the measurement log.

Creates one adjustment layer per scene above the source track: consecutive clips from the same source share one layer, a different source/camera gets its own. Each layer gets a Lumetri with (optionally) the clip grade transferred + a base look, and is named after its source so it can be fine-tuned per scene.

Reads Lumetri Basic Correction values of a clip.

Sets (or offsets) Lumetri Basic Correction values of a clip; adds Lumetri if missing.

Rough-cut a folder of raw footage by the slate cues called on set ("3, 2, 1", "action", "diễn", "đi" to start; "cắt", "cut", "ok", "được rồi" to end), heard by Whisper in each file's own audio through the MCP Adobe media engine. One source can give many takes. Builds a NEW sequence with every take back to back, a→z by file then time, so the editor can reorder them; each take gets a sequence marker (take id, cue heard, dialogue, confidence) and low-confidence takes a red marker. Files with no cue are kept whole (unless dropNoCue). Analysis is cached next to the footage (.media/); a long first run returns status "running" — call again with the same arguments to pick up the result.

Describe every shot (file) in a footage folder through the media engine: one-line description (in Vietnamese), shot size, setting, content labels, sharpness, exposure, shake, faces, a beauty score. mode "fast" needs no download; "deep" adds a local vision model (Qwen3.5 2B MLX) for natural sentences. With writeToProject, the description goes into each imported clip's Comment column and the quality numbers into Log Note, so they can be searched and sorted in the Project panel.

Find shots by what is in the picture, in English or Vietnamese ("close-up of a face", "wide shot of the restaurant", "waiter in a red shirt", or "cô gái cầm menu"), through the media engine (SigLIP 2, local): every second of each clip's proxy is compared with the words, the best stretches come back ranked with in/out and a score. Each hit becomes a marker on the source clip in the Project panel (open the clip in the Source Monitor to see it; searching the same words again replaces those markers). With placeOnTimeline, also builds a sequence "Tìm: " with the hits in rank order. Uses the clips kept in the project with their proxies, like describe_sources. The first search on a folder reads the images (about 30 s for 5 minutes of footage); later searches take a few seconds.

Send one timeline clip to After Effects for effects work: records the clip (media file, source in/out, handles, timeline position, sequence size and fps, Motion position/scale/rotation) in a handoff JSON and returns its id. Then call the After Effects MCP: ae_do bridge.from_premiere { handoff: } builds a matching comp (same size, fps, framing, handles marked); after the effect work, ae_do bridge.to_premiere { handoff } renders it; finally return_from_after_effects { handoff } puts the render back on the timeline.

Bring an After Effects render back to the timeline: imports the file rendered by bridge.to_premiere (or refreshes it when it was already brought back once — re-render in AE and call again), lays it on the track above the original at the same time and length (handles hidden but kept for trimming), names it "AE · ", and disables the original underneath (re-enable it to compare). Nothing is deleted.

Make square and vertical versions of a finished horizontal edit, the way an editor does it by hand: duplicates the sequence as " 1x1" / " 9x16" (cuts, order, tracks, audio, titles unchanged), changes the frame, and re-frames every video clip from the horizontal version as already adjusted (media bo-cuc: a window cut out of the horizontal frame, centred on faces when there are any, never showing black edges or anything cropped away). Only Motion Scale and Position change; Anchor Point, Rotation and Crop stay. Adjustment layers keep all their effects and are scaled to cover the new frame. Titles/graphics are left as they are and listed for a manual check.

One colour layer over the whole sequence or a time range (a global look). For per-scene grading use add_scene_color_layers. Lays a colour-grading adjustment layer over the whole sequence (or a time range) on its own top track, with Lumetri Color ready to grade — the colour layer an editor puts above the cut. Uses the project's Adjustment Layer item, importing one from Mako's template when the project has none (Premiere has no scripting call that creates one). Optional Lumetri Basic values (temperature, tint, exposure, contrast, highlights, shadows, whites, blacks, saturation, vibrance) and a Lumetri preset/LUT look.

Run a Mako (Basics Studio panel, installed) shortcut on the open sequence, on clips you select first: adjustment_layer (mode "" over the selection/sequence, "clips" one per clip, "cuts" short ones on every cut), staircase / unstaircase (spread clips onto stacked tracks and back), freeze_frame (mode "" whole selected clips, "hold" holdSeconds from the playhead), fit_frame (mode "" fit, "fill" fill the frame), nest / unnest (rebuilds Nest with effects, transitions and markers kept), clear_effects (resetMotion), quality_check (marks gaps red, offline media orange, disabled clips yellow, 1–2 frame leftovers purple; fix closes gaps; mode "clear" removes the markers), delete_empty_tracks, new_sequence, transparency_grid. select: "all" (every clip), "none" (leave the selection as it is) or { track, clips: [indexes] } / { from, to } in seconds on video tracks. Requires the Mako panel to have loaded once in this Premiere session.

Put a solid colour background on the timeline without Premiere's colour picker (which blocks scripting): white or black by default — the plate a logo sits on — or any #RRGGBB. Made at the sequence frame size, saved next to the project in "MCP mattes" (reused, never in a temp folder that could go offline), imported into a "Nền màu" bin and placed on the given track for the given span (default: the whole sequence on track, which is V1 when that span is free there, else a new track at the top so you can drag it under).

Premiere knowledge base (folder Premiere/Kiến thức — drop .md files there, no build): which transitions exist and when to use them (Film Impact is built into Premiere 2026), which plugins/panels MCP can drive (Mako) and which are manual (Animation/Premiere Composer), export rules. Call with no topic to list topics, then with a topic name to read it. Read it before choosing transitions or plugins.

Export a sequence for delivery: one ProRes 422 HQ master straight from Premiere (exportAsMediaDirect with the built-in "Match Source - Apple ProRes 422 HQ" preset), then every requested deliverable from it — youtube_4k, youtube_1080, reels (1080x1920), feed_4x5, square, led (screen width/height), review (720p, watermark + timecode), master, png_alpha — with sizes, bitrates and -14 LUFS loudness from pr_guide "Xuất file". Files are named " V" (next free version) and logged with the measured LUFS in "Kết quả xuất.md" (export log). Export the 9x16 / 1x1 sequences for vertical and square (create_aspect_versions) — another aspect is letterboxed.

Progress of an export_deliverables job: waiting for the Media Encoder master, encoding (which deliverable), done or failed, with the finished files and their measured LUFS.

Grade per scene: one adjustment layer with Lumetri Color per SOURCE on a new top track, named "Màu ". Neighbouring clips from the same source share one layer; the same source used again elsewhere on the timeline gets a layer with the same name and the same Lumetri values (keep them identical with sync_color_layers after grading one); a different source always gets its own layer. Titles/adjustment layers/graphics are skipped. Optional Lumetri Basic values for all (basic) or per source file name (perSource).

Make every colour layer of the same scene identical again after grading one of them: for each "Màu " name, copies ALL Lumetri Color parameters (basic, creative, curves, wheels, HSL, vignette) from the master instance to the other instances of that name. master: a clip name + index or the instance under the playhead; default the first instance of each name. Different sources are never touched by each other.

FIRST STEP of a job: make edit proxies for every video in a footage folder so Premiere (and the media engine) work on light files instead of 4K. ProRes Proxy with the Mac hardware encoder (VideoToolbox, cool and fast), half resolution by default (4K → 1080p), same fps, duration and audio channels so Premiere accepts them; saved as "/Proxies/_Proxy.mov", one file at a time at low priority so the machine stays cool. Existing proxies are reused. When done, attaches each proxy to its clip in the open project (Toggle Proxies in Premiere switches). Runs in the background: check with proxy_status.

Progress of a create_proxies job: files done, current file, attached proxies, failures.

Save the project, then copy the .prproj into " checkpoints/ .prproj" next to it. Premiere has no undo group for scripts, so take one before any large automated change (rough cut, aspect versions, colour layers); restore by opening the copy. Lists existing checkpoints with list: true.

Tidy the Project panel the way an editor keeps it: bins "01 Footage" (video), "02 Audio" (music, VO, SFX), "03 Graphics" (images, PSD, AI, MOGRT), "04 Sequences", "05 Adjustment" (adjustment layers, mattes), "06 Proxies & renders" (AE renders, exports). Only moves items that sit loose in the root (dryRun to preview); never deletes or renames media.

Check a sequence before delivery and report problems with their timecode: offline media, disabled clips, gaps (black frames), 1–2 frame leftover clips, clips still pointing at proxies? (reminder to toggle proxies off), red "low confidence" markers left from the rough cut, empty tracks, audio clips muted, sequence frame vs the intended delivery. Read-only; fix with mako (quality_check fix closes gaps), or by hand.

Make captions for a cut from what the media engine already heard (word timings in /.media, written by rough_cut_by_cues or describe_sources): for every clip on the source track, the words inside its in/out are placed at its timeline position, split into lines of at most maxChars, written to "/Phụ đề/.srt" and added as a caption track. Spoken language is whatever was heard (Vietnamese, English…); slate calls outside the takes are not included. Edit the text in Premiere's Text panel afterwards.

Find the beat of the music: tempo (BPM), every beat and the first beat of each bar. Give a file, or let it read the music already on the timeline (audio-only clips that are not named like a voiceover) and drop cyan markers "Nhịp 1" (bar 1) on each bar (markers: "beats" for every beat, "none" for no markers). Results are cached in /.media. Check by ear: tempo can come out at half or double on sparse music.

Re-time a cut to the music: a copy of the sequence (" (theo nhịp)", i.e. "on the beat") where every clip on the video track keeps its in point and its end moves to the nearest beat (every: 1 = each beat, 2 = every other, 4 = each bar), so all cuts land on the beat. Motion (scale/position/rotation) is carried over; music and other tracks stay. The original sequence is not changed. dryRun shows the plan first.

Rank the takes of a footage folder from what the media engine heard: ended on a cut call, cue confidence, how clearly the lines were spoken, retake calls ("otra vez", "again", "lại đi"…) in or right after the take, very short takes, later takes slightly preferred. Returns the ranking with reasons per file (groupBy "file") or overall ("none"); with sequenceName it also builds a selects sequence of the best take(s) with the score on each marker. Uses the same cache as rough_cut_by_cues. Always check the picks by eye.

Put a voiceover file on the timeline (at the playhead or at seconds) on the first free audio track and duck the music under it: Volume keyframes only where the voice actually speaks (silences longer than 0.35 s let the music back up), with short fades. Music = audio-only clips on other tracks, or the tracks in duckTracks. Keyframes stay editable in Effect Controls. To record a voice first, use a text-to-speech tool or skill.

Even out clip loudness on the timeline: each audio clip is measured (LUFS, only the part used) and its Volume level set so dialogue and voiceover sit at target (default -16) and music sits under the voice (musicTarget, default -26; music alone goes to target). Clips with ducking keyframes keep their shape, the whole curve is shifted. Gains are capped at +15 dB. dryRun shows the measurements first. The final mix is still normalised per platform by export_deliverables.

Look over a cut like an editor before showing it: shot count and pacing (average, shortest, longest, first shot for the hook), flash frames, shots held too long (maxShot, default 5 s), gaps, jump cuts inside the same shot, footage used twice, cuts off the music beat (when music is on the timeline), length against targetSeconds. Drops orange "Review:" markers (old ones replaced) and makes a contact sheet of one frame per shot (from proxies when present) in "/Review//contact sheet.jpg".

After delivery: find everything the job no longer uses, without changing anything. Usage is read from the timelines (nested sequences and multicam included): project items on no timeline (video, audio, stills, mattes, captions…), and on disk the unused imported files, their proxies, and media files sitting in the source folders that were never used. Delivery/render folders (Edited, Export, Xuất file, Render, Final, Bàn giao…) and the files in use with their proxies are always kept. keepSequences: only these sequences count as the job (the others are listed for removal too). Writes a report in ~/Library/Application Support/MCP Adobe/Don dep and returns a summary for the user to check. Then clean_unused_media.

Act on a review_unused_media report after the user has read it: saves a checkpoint of the project, checks usage again right now (anything used since the report is skipped), removes the unused items from the Premiere project (plus bins left empty by it) and saves, then moves the unused files to the macOS Trash with Finder (Put Back works; nothing is deleted for good — the user empties the Trash). confirm must be true. Needs Finder automation permission the first time.