Skip to main content
Glama
Osiris Premiere MCP

Osiris Premiere MCP

by OsirisMedici

Osiris Premiere MCP

An independent open-source continuation maintained by Osiris Medici, built on leancoderkavy/premiere-pro-mcp. It connects an MCP client to supported workflows in the native Adobe Premiere Pro application.

The starting point is upstream v1.19.1, commit b698a2145342c42041c12a4422189e8f11dd81b4. Original Git history, MIT license, credits, and upstream README are preserved. This project is independent of the upstream maintainer and Adobe.

What you can do today

Build the existing local server and CEP connector, inspect a Premiere project, and use supported editing tools with an appropriate capability profile. The native application remains the editing interface; the MCP server provides structured operations rather than repeated UI navigation.

A Mac test on Premiere 26.5.2 verified project creation/opening, linked audio/video insertion and trimming, cutting, SRT caption rendering, and a short native MP4 export. Undo after ripple-delete failed structural verification. Work on disposable copies and saved checkpoints until that issue is resolved. See the action audit for the exact evidence and limits. A listed tool does not prove host support.

Related MCP server: MCP Bridge for Adobe Premiere Pro

Build from this repository

Use Node.js 24 (the tested runtime) and an installed, licensed Premiere Pro:

git clone https://github.com/OsirisMedici/Osiris-Premiere-MCP.git
cd Osiris-Premiere-MCP
npm ci --ignore-scripts
npm run check
node dist/index.js --help

Review the inherited connector installation instructions and quick starts. For this continuation, install from this checkout using node dist/index.js --install-cep, then configure your MCP client to launch this checkout's dist/index.js with an absolute Node path. Instructions using the upstream npm package install the upstream release, not this continuation. CEP debug-mode changes are local host configuration and should be reviewed before applying them.

Begin with PREMIERE_MCP_CAPABILITIES=inspect. Enable editing, export, or filesystem authority only for the intended task. Set POSTHOG_API_KEY to an empty string to disable the inherited optional telemetry. The tested setup uses CEP; UXP requires a separate capability-aware connection. FFmpeg is a prerequisite for tools such as detect_silence.

Development direction

The goal is reliable Premiere control that saves UI interaction and lets an editor inspect, edit, recover, and finish work through predictable operations. The next priorities are structural Undo verification, project discovery and lifecycle helpers, caption readback, and transcript-driven editing. Functional development is deferred; continuation notes define the starting point and acceptance criteria.

This initial continuation changes repository identity, documentation, and publication safeguards. It preserves the existing editing implementation. package.json is private to prevent accidental npm publication. Existing package names, bridge identifiers, version metadata, registry manifests, plugin presets, and release scripts still describe the upstream base. There is no independent npm, marketplace, or installer release. Inherited GitHub Actions are disabled on this repository pending a review of their destinations and credentials.

Credit and license

Thanks to leancoderkavy and the original contributors for the foundation. Our changes are documented in Git history; the original copyright and MIT permission notice remain in LICENSE. Dependencies and bundled components retain their respective licenses. See CREDITS.md.

Available Tools

389 tools
add_adjustment_layerAdd Adjustment LayerA

EXPERIMENTAL (QE DOM): add an adjustment layer at the playhead on the specified track. Refuses when the host lacks the QE APIs; verifies a new public TrackItem using isAdjustmentLayer and placement readback.

Inputs: track_index. Returns: ok, data, tool, error

add_audio_keyframesAdd Audio KeyframesA

Add audio level keyframes to create fades or level changes

Inputs: node_id (required), keyframes (required). Returns: ok, data, tool, error

add_custom_metadata_fieldAdd Custom Metadata FieldA

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

Inputs: field_name (required), field_type (required), field_label (required). Returns: ok, data, tool, error

add_keyframeAdd KeyframeA

Add and read back a keyframe on an effect property. The receipt warns when its time is outside the clip's visible range. This verifies stored parameter data only; render/playback verification remains host-dependent.

Inputs: value (required), node_id (required), effect_name (required), time_seconds (required), +1 more. Returns: ok, data, tool, error

add_markerAdd MarkerA

Add a marker to the active sequence or a clip and read its name, comments, color and duration back. EXPERIMENTAL (QE DOM): the receipt reports undoStackIndex movement, which does not prove QE can reverse the marker. Every marker attempt protects an engine undo boundary; undoTracked:false means the marker did not observably advance the QE index.

Inputs: time_seconds (required), name, color, node_id, +2 more. Returns: ok, data, tool, error

add_markers_batchAdd Markers BatchA

Add up to 200 sequence or clip markers in one verified CEP request (beat grids, chapters, silence reviews, client notes). Every marker is validated and range-checked before the first write; the tool reads back the marker count and each created marker's time and fails closed on any mismatch. EXPERIMENTAL QE: records an observed marker boundary for guarded Undo/Redo; crossing it is refused by default, and unreadable history records unknown protection. This boundary does not verify native marker reversal.

Inputs: markers (required), node_id, sequence_id, allow_beyond_end, +1 more. Returns: ok, data, tool, error

add_marker_to_project_itemAdd Marker To Project ItemA

Add a marker to a project item (source clip marker). EXPERIMENTAL QE: records an observed marker boundary for guarded Undo/Redo; crossing it is refused by default, and unreadable history records unknown protection. This boundary does not verify native marker reversal.

Inputs: item_id (required), time_seconds (required), name, type, +3 more. Returns: ok, data, tool, error

add_text_overlayAdd Text OverlayA

Unavailable: Premiere does not expose a supported scripting API to create caption clips directly from raw text. For on-screen titles from plain text use add_title; for captions import an .srt/.vtt and use create_caption_track.

Inputs: text (required), start_seconds, caption_format, duration_seconds. Returns: ok, data, tool, error

add_titleAdd TitleA

Add an on-screen title from plain text using a stock Essential Graphics template that ships with Premiere (default: Basic Title). Pass text for one line, or lines to fill the template's text fields in order (for example a lower third's name and role). Premiere-built templates (kind 'premiere') get the text baked into a verified copy of the template before import, because Premiere exposes no writable text for them (textVerification 'template_verified'; confirm the render with export_frame). After Effects-built templates (kind 'after_effects') are imported and their text fields written by position and read back from Premiere (textVerification 'verified', 'mismatch', 'missing_property', or 'committed_unverified'). The graphic is trimmed to duration_seconds and its length read back. Use list_stock_titles to see templates, their kind, and how many lines each takes.

Inputs: text, lines, template, track_index, +2 more. Returns: ok, data, tool, error

add_to_render_queueAdd To Render QueueA

Request an Adobe Media Encoder render-queue handoff for the active sequence. Requires a saved project and an .epr preset_path. Same as Project presets are refused before Premiere is contacted because AME encodes from a scratch project copy. Optional start_batch requests processing of every ready AME queue job, including unrelated jobs.

Inputs: output_path (required), preset_path (required), start_batch. Returns: ok, data, tool, error

add_to_timelineAdd To TimelineA

Insert a project item at a timeline position. Experimental: if a target clip spans that point, QE razors it before insertion to attempt to preserve its tail; both target and sync-locked track changes are read back. A host may still displace a tail, in which case the edit is reported as committed_unverified. Pass scope 'target_tracks' to ripple only the named pair (this will desync other tracks).

Inputs: item_id (required), scope, track_index, start_seconds, +1 more. Returns: ok, data, tool, error

add_to_timeline_batchAdd To Timeline BatchA

Insert up to 32 project items with insert-edit semantics in one validated CEP request. Experimental QE sync-lock handling may ripple or split earlier placements. The tool preflights items and tracks, then verifies every placement again in the final sequence; changed placements return committed_unverified with their observed final positions.

Inputs: clips (required). Returns: ok, data, tool, error

add_trackAdd TrackB

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

Inputs: track_type (required), count. Returns: ok, data, tool, error

add_tracksAdd TracksA

Add video and/or audio tracks through QE, verify the active sequence gained the exact requested counts, and report explicitly when QE inserted the new tracks at index 0 and shifted every existing track up.

Inputs: audio_tracks, video_tracks, audio_51_tracks, audio_mono_tracks. Returns: ok, data, tool, error

add_transitionAdd TransitionA

EXPERIMENTAL (undocumented QE DOM): Add a video transition between two clips at a cut point. Reads the transition back from the sequence track.

Inputs: track_index (required), transition_name (required), cut_point_seconds (required), duration_seconds. Returns: ok, data, tool, error

add_transition_to_clipAdd Transition To ClipA

EXPERIMENTAL (undocumented QE DOM): Add a transition to a specific video clip's start, end, or both edges, then read back the requested placement.

Inputs: node_id (required), transition_name (required), position, duration_seconds. Returns: ok, data, tool, error

adjust_audio_levelsAdjust Audio LevelsB

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

Inputs: node_id (required), level_db (required). Returns: ok, data, tool, error

analyze_dialogue_edit_candidatesAnalyze Dialogue Edit CandidatesA
Read-onlyIdempotent

Analyze caller-supplied, revision-bound transcript segments and optional local silence ranges for deterministic dialogue-edit candidates. It never calls a model, persists transcript text, or changes Premiere.

Inputs: segments (required), filler_words, silence_ranges, minimum_silence_seconds. Returns: ok, data, tool, error

analyze_loudnessAnalyze LoudnessA

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

Inputs: media_path, target_lufs, tolerance_lu, project_item_id, +1 more. Returns: ok, data, tool, error

analyze_video_interlacingAnalyze Video InterlacingA

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

Inputs: media_path (required), sample_seconds. Returns: ok, data, tool, error

analyze_video_qcAnalyze Video QcB

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

Inputs: media_path (required), minimum_black_seconds, minimum_freeze_seconds. Returns: ok, data, tool, error

apply_after_effects_render_handoffApply After Effects Render HandoffA

Import exactly one previewed completed AE render into its approved Premiere bin after rechecking both hosts and file metadata. Requires confirmation and consumes the token before dispatch. Does not save, render, or change a timeline.

Inputs: preview_token (required), confirm_import (required). Returns: ok, data, tool, error

apply_audio_effectApply Audio EffectB

Apply an audio effect to a clip. Experimental QE catalog lookup includes an exact-name probe when enumeration is empty. A component-list readback does not verify rendered audio.

Inputs: node_id (required), effect_name (required). Returns: ok, data, tool, error

apply_edit_planApply Edit PlanA

Apply a previously previewed compound edit after revalidating stable project, sequence and target identities before activation or mutation. Requires the edit capability and exact preview confirmation token; changed targets require a fresh preview. Ripple plans require the reviewed sequence to be active for the read-only QE sync-lock preflight.

Inputs: plan (required), confirmation_token (required). Returns: ok, data, tool, error

apply_effectApply EffectB

Apply a video effect to a clip. Experimental QE DOM catalog lookup includes an exact-name probe when enumeration is empty. A component-list readback does not verify rendered pixels.

Inputs: node_id (required), effect_name (required). Returns: ok, data, tool, error

apply_lutApply LutA

Unavailable on the CEP backend: Premiere's scripting API cannot load a LUT file into Lumetri Color. Its Input LUT and Look parameters are menu indexes over a curated set of bundled looks, and writing a file path to the LUT asset parameters is accepted but not rendered (seen on Premiere Pro 25.2.3, macOS, by comparing exported frames with the same LUT applied by ffmpeg; other builds were not tested). Fails before changing the clip. Apply the LUT in Lumetri Color > Creative > Look (Browse...) instead.

Inputs: node_id (required), lut_path (required). Returns: ok, data, tool, error

apply_mogrt_premiere_handoffApply Mogrt Premiere HandoffA

Import exactly one previewed MOGRT into the empty track of the explicit disposable Premiere verification sequence, then read back insertion and control descriptors. Requires explicit confirmation; no rendered-frame claim is made.

Inputs: preview_token (required), confirm_import (required). Returns: ok, data, tool, error

apply_spot_workflow_planApply Spot Workflow PlanA

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

Inputs: plan (required), confirmation_token (required). Returns: ok, data, tool, error

attach_custom_propertyAttach Custom PropertyA

Attach a custom property (key/value pair) to the active sequence and confirm it against the sequence project item's XMP packet. Reports failure when the property never lands in XMP.

Inputs: property_id (required), property_value (required). Returns: ok, data, tool, error

audit_timeline_healthAudit Timeline HealthA
Read-onlyIdempotent

Audit one sequence snapshot for flash frames, gaps, overlaps, disabled clips, repeated shots, video without audio, extreme speed, invalid times, empty tracks, leading black, and trailing gaps; returns a 0..100 score, findings with timecodes, and fix routes. Local-only; never changes Premiere.

Inputs: snapshot (required), frame_rate, gap_min_frames, max_speed_percent, +3 more. Returns: ok, data, tool, error

auto_reframe_sequenceAuto Reframe SequenceA

Auto-reframe a sequence into a new sequence of target_width x target_height. Premiere derives the new sequence from the source height (a 1080p source at 9:16 comes out 607x1080), so the tool then sets the requested frame size and verifies it; the Auto Reframe effect refits to the new size.

Inputs: target_width (required), target_height (required), new_name, sequence_id, +2 more. Returns: ok, data, tool, error

batch_add_transitionsBatch Add TransitionsA

EXPERIMENTAL (undocumented QE DOM): Add the same video transition at each eligible cut point on a track and report per-cut readback.

Inputs: transition_name (required), track_index, duration_seconds. Returns: ok, data, tool, error

batch_apply_effectBatch Apply EffectA

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

Inputs: target (required), effect_name (required), track_type, track_index. Returns: ok, data, tool, error

batch_enable_disableBatch Enable DisableB

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

Inputs: target (required), enabled (required), track_type, track_index. Returns: ok, data, tool, error

batch_rename_clipsBatch Rename ClipsB

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

Inputs: pattern (required), track_type (required), track_index (required), start_number, +1 more. Returns: ok, data, tool, error

build_caption_artifactBuild Caption ArtifactA

Build a CapCut/Submagic-style SRT or VTT caption artifact from a caller-supplied word timeline: balanced word groups, sentence-aware breaks, min/max cue durations, optional karaoke word timestamps (VTT), emphasis and speaker markup. Local-only; returns the artifact inline or writes it inside an approved workspace and never changes Premiere.

Inputs: format (required), word_timeline (required), karaoke, max_lines, +12 more. Returns: ok, data, tool, error

capture_frameCapture FrameA

Capture the current frame and return it as inline image data for the LLM to see. This supports still-image review only; QE capture may differ from actual video exports and cannot verify temporal animation.

Inputs: time_seconds. Returns: ok, data, tool, error

check_caption_safe_zoneCheck Caption Safe ZoneA
Read-onlyIdempotent

Check caption, title, logo, and graphic rectangles against approximate platform UI overlay zones (TikTok, Reels, Shorts, feed, YouTube, LinkedIn, X) and suggest the nearest clear position. Local-only geometry on caller-supplied normalized rects; it never reads or changes Premiere.

Inputs: frame (required), elements (required), platform (required). Returns: ok, data, tool, error

check_offline_mediaCheck Offline MediaB
Read-onlyIdempotent

Check for offline (missing) media in the project

Returns: ok, data, tool, error

clear_item_in_outClear Item In OutA

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

Inputs: item_id (required), clear_in, clear_out. Returns: ok, data, tool, error

clear_sequence_in_outClear Sequence In OutC

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

Inputs: clear_in, clear_out. Returns: ok, data, tool, error

close_all_source_clipsClose All Source ClipsA
Destructive

Close all clips in the Source Monitor.

Returns: ok, data, tool, error

close_projectClose ProjectA
Destructive

Close an open Premiere Pro project: the active one, or the open project at project_path. Verifies it is no longer open and reports which project is active afterwards.

Inputs: save_first, project_path. Returns: ok, data, tool, error

close_sequenceClose SequenceA
Destructive

Request closing a sequence timeline tab. Premiere exposes no open-tab enumeration, so dispatch is requested_unverified; the sequence stays in the project.

Inputs: sequence_id. Returns: ok, data, tool, error

close_source_monitorClose Source MonitorA
Destructive

Close the clip currently showing in the Source Monitor. Premiere then shows the previously opened clip, if any; the result names it.

Returns: ok, data, tool, error

color_correctColor CorrectA

Apply basic color correction through experimental QE Lumetri insertion. Requires Lumetri component and requested property readback; rendered output is not verified.

Inputs: node_id (required), tint, blacks, whites, +6 more. Returns: ok, data, tool, error

compare_cmx3600_edlsCompare Cmx3600 EdlsB

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

Inputs: after_path (required), before_path (required). Returns: ok, data, tool, error

compute_mask_fit_motionCompute Mask Fit MotionA
Read-onlyIdempotent

Inspect only. Compute the Motion Scale (%) and Position that place a still image's subject inside an existing Rounded Crop, Crop, or similar mask effect. Reads the sequence frame size, the source frame size, current Motion values, and the mask effect's parameters, then solves the geometry deterministically from a caller-supplied subject box (fractions of the source image, for example head-top to chin). No image analysis and no changes to Premiere. Apply the result with set_clip_scale and set_clip_position (or set_effect_property), then verify with capture_frame. Assumes Rotation 0 and uniform scale; mask geometry is treated as fixed in the sequence frame (mask_space 'sequence').

Inputs: node_id (required), subject (required), fit_axis, placement, +7 more. Returns: ok, data, tool, error

consolidate_and_transferConsolidate And TransferA

Collect (copy) or transcode project media into a new project with Premiere's Project Manager. Premiere writes a Copied_ folder inside destination_path (created if missing); success is reported only after that folder holds the copied .prproj, with the copied files listed.

Inputs: destination_path (required), transcode, rename_media, exclude_unused, +6 more. Returns: ok, data, tool, error

consolidate_duplicatesConsolidate DuplicatesB

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

Returns: ok, data, tool, error

copy_effects_between_clipsCopy Effects Between ClipsA

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

Inputs: source_node_id (required), target_node_id (required), effect_name. Returns: ok, data, tool, error

copy_effect_valuesCopy Effect ValuesA

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

Inputs: effect_name (required), source_node_id (required), target_node_id (required). Returns: ok, data, tool, error

create_bars_and_toneCreate Bars And ToneA

Create a Bars and Tone synthetic media item in the project (useful for leader/calibration). Returns the created item's name, nodeId, and treePath, found by reading the project back.

Inputs: name, width, bin_id, height, +4 more. Returns: ok, data, tool, error

create_binCreate BinA

Create a new bin (folder) in the project panel, optionally nested inside an existing bin. Reads the project back: verified is true only when the new bin is a direct child of the requested parent; otherwise the result reports outcome committed_unverified.

Inputs: name (required), parent_bin, parent_bin_id. Returns: ok, data, tool, error

create_caption_trackCreate Caption TrackA

Import an already reviewed caption artifact into the active sequence, or create a local lecture-caption timing and review workflow plan. Import reports structural success only when the host exposes a caption-track readback; the planning action never contacts Premiere or changes an artifact.

Inputs: action, item_id, start_seconds, caption_format, +6 more. Returns: ok, data, tool, error

create_context_edit_planCreate Context Edit PlanA
Read-onlyIdempotent

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

Inputs: intent (required), project_id (required), strategy, sequence_id, +1 more. Returns: ok, data, tool, error

create_editorial_context_packCreate Editorial Context PackA
Read-onlyIdempotent

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

Inputs: intent (required), project_id (required), kinds, max_entries, +2 more. Returns: ok, data, tool, error

create_editorial_planCreate Editorial PlanA
Read-onlyIdempotent

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

Inputs: intent (required), workflow (required), project_id (required), sequence_id, +3 more. Returns: ok, data, tool, error

create_mogrt_batchCreate Mogrt BatchA

Create the exact MOGRT recipes from a one-time batch preview. Requires explicit export confirmation and stops on the first After Effects failure without claiming rollback.

Inputs: preview_token (required), confirm_export (required). Returns: ok, data, tool, error

create_mogrt_recipeCreate Mogrt RecipeA

Create exactly one previewed MOGRT recipe in a saved After Effects project inside the approved workspace. Requires explicit export confirmation; it never creates projects or output folders.

Inputs: preview_token (required), confirm_export (required). Returns: ok, data, tool, error

create_projectCreate ProjectC

Create a new Premiere Pro project at the specified path

Inputs: path (required). Returns: ok, data, tool, error

create_project_backupCreate Project BackupA

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

Inputs: project_path (required). Returns: ok, data, tool, error

create_sequenceCreate SequenceC

Create a new sequence in the project

Inputs: name (required), preset_path. Returns: ok, data, tool, error

create_sequence_checkpointCreate Sequence CheckpointA

Clone a sequence into a named '[checkpoint]' copy before a risky edit and return a diff_sequence_snapshots-compatible snapshot of the original. Verifies the clone exists with matching track and clip counts, re-activates the original, and never deletes or overwrites anything.

Inputs: label, sequence_id, include_snapshot. Returns: ok, data, tool, error

create_sequence_from_clipsCreate Sequence From ClipsB

Create a new sequence by automatically placing project items in order

Inputs: name (required), item_ids (required). Returns: ok, data, tool, error

create_sequence_from_presetCreate Sequence From PresetA

EXPERIMENTAL (undocumented QE DOM): create a new sequence from a specific preset file (.sqpreset) using qe.project.newSequence. Reports success only after a new sequence ID appears in the project collection; a same-name sequence that was already active is not treated as created.

Inputs: name (required), preset_path (required). Returns: ok, data, tool, error

create_smart_binCreate Smart BinA

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

Inputs: name (required), query (required). Returns: ok, data, tool, error

create_subclipCreate SubclipB

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

Inputs: name (required), item_id (required), in_seconds (required), out_seconds (required). Returns: ok, data, tool, error

create_subsequenceCreate SubsequenceA

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

Inputs: ignore_track_targeting. Returns: ok, data, tool, error

crop_clipCrop ClipA

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

Inputs: node_id (required), top, left, zoom, +3 more. Returns: ok, data, tool, error

delete_binDelete BinB
Destructive

Delete a bin (folder) from the project panel

Inputs: bin_id (required). Returns: ok, data, tool, error

delete_markerDelete MarkerB
Destructive

Delete a marker at a specific time position. EXPERIMENTAL (QE DOM): the receipt reports undoStackIndex movement, which does not prove QE can reverse the marker. Every marker attempt protects an engine undo boundary; undoTracked:false means the marker did not observably advance the QE index.

Inputs: time_seconds (required), node_id. Returns: ok, data, tool, error

delete_multiple_project_itemsDelete Multiple Project ItemsA
Destructive

Delete several project items (bins, sequences, clips or files) and read back that each is gone. Every item is checked before any is deleted. organize_project_items_uxp with action 'remove' (authenticated UXP bridge) is the preferred, documented route; this CEP fallback deletes clips and files through a temporary bin, which cannot be undone here. Items (or bins whose contents are) used on a timeline are refused unless confirm_remove_from_sequences is true.

Inputs: item_ids (required), confirm_remove_from_sequences. Returns: ok, data, tool, error

delete_preview_filesDelete Preview FilesB
Destructive

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

Inputs: media_type. Returns: ok, data, tool, error

delete_project_itemDelete Project ItemA
Destructive

Delete a project item (bin, sequence, clip or file) from the project panel and read back that it is gone. organize_project_items_uxp with action 'remove' (authenticated UXP bridge) is the preferred, documented route. This CEP fallback deletes a clip or file by moving it into a temporary bin and deleting that bin, which cannot be undone here. Deleting media also removes its clips from every sequence, so an item (or a bin whose contents are) used on a timeline is refused unless confirm_remove_from_sequences is true.

Inputs: item_id (required), confirm_remove_from_sequences. Returns: ok, data, tool, error

delete_sequenceDelete SequenceB
Destructive

Delete a sequence from the project

Inputs: sequence_id (required). Returns: ok, data, tool, error

delete_trackDelete TrackA
Destructive

EXPERIMENTAL (undocumented QE DOM: removeVideoTrack/removeAudioTrack). Delete a video or audio track from the active sequence through QE and verify that exactly that track was removed (the remaining tracks keep their clips, custom names and lock/mute state in order). Refuses a track that still holds clips unless force is true.

Inputs: track_type (required), track_index (required), force. Returns: ok, data, tool, error

deselect_all_clipsDeselect All ClipsA

Deselect all clips in the active sequence.

Returns: ok, data, tool, error

detach_proxyDetach ProxyB

Detach/remove the proxy from a project item

Inputs: item_id (required). Returns: ok, data, tool, error

detect_active_picture_boundsDetect Active Picture BoundsA

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

Inputs: media_path (required), limit, sample_seconds. Returns: ok, data, tool, error

detect_audio_transientsDetect Audio TransientsA

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

Inputs: media_path (required), maximum_events, threshold_dbfs, minimum_interval_seconds. Returns: ok, data, tool, error

detect_beatsDetect BeatsA

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

Inputs: media_path (required), max_beats. Returns: ok, data, tool, error

detect_motion_peaksDetect Motion PeaksC

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

Inputs: media_path (required), threshold, maximum_events, sample_seconds, +2 more. Returns: ok, data, tool, error

detect_repeated_takesDetect Repeated TakesA
Read-onlyIdempotent

Detect repeated sentence takes (retakes) in a word timeline using token similarity within a time window, and plan removal of all but the kept take. Returns take groups, removal and keep ranges, and apply routes. Local-only; never changes Premiere.

Inputs: word_timeline (required), keep, min_words, frame_rate, +4 more. Returns: ok, data, tool, error

detect_scene_editsDetect Scene EditsB

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

Inputs: mode (required), confirm_non_undoable (required), operation_id. Returns: ok, data, tool, error

detect_silenceDetect SilenceA

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

Inputs: media_path, project_item_id, noise_threshold_db, min_duration_seconds. Returns: ok, data, tool, error

detect_source_scene_changesDetect Source Scene ChangesB

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

Inputs: media_path (required), threshold, maximum_events, minimum_interval_seconds. Returns: ok, data, tool, error

diff_sequence_snapshotsDiff Sequence SnapshotsA
Read-onlyIdempotent

Diff two sequence snapshots (from get_sequence_structure or inspect_sequence_structure_uxp) into added, removed, moved, trimmed, retimed, enabled, and renamed clip changes with frame deltas, per-track counts, and EDL-like timecode lines. Local-only; never reads or changes Premiere.

Inputs: after (required), before (required), frame_rate, tolerance_frames. Returns: ok, data, tool, error

duplicate_clipDuplicate ClipA

EXPERIMENTAL: Duplicate a timeline clip, with its linked audio/video partner, onto the first tracks above it that are empty for the clip's time range. The copy keeps the clip's source in point and visible duration, is placed with an overwrite edit (nothing ripples), and is read back. A post-write mismatch is committed_unverified; inspect the timeline or use Undo. Fails without changes when no free track is available; add one with add_tracks.

Inputs: node_id (required). Returns: ok, data, tool, error

duplicate_sequenceDuplicate SequenceC

Duplicate an existing sequence

Inputs: sequence_id (required). Returns: ok, data, tool, error

enable_disable_clipEnable Disable ClipB

Enable or disable a clip on the timeline

Inputs: enabled (required), node_id (required). Returns: ok, data, tool, error

encode_fileEncode FileA

Request an Adobe Media Encoder encode for an external file. Requires a saved project. The returned job ID is an unverified handoff; verify queue presence or the output file independently. Optional start_batch requests processing of every ready AME queue job, including unrelated jobs.

Inputs: input_path (required), output_path (required), preset_path (required), in_seconds, +3 more. Returns: ok, data, tool, error

encode_project_itemEncode Project ItemA

Request an Adobe Media Encoder encode for a project item. Requires a saved project. The returned job ID is an unverified handoff; verify queue presence or the output file independently. Optional start_batch requests processing of every ready AME queue job, including unrelated jobs.

Inputs: item_id (required), output_path (required), preset_path (required), start_batch, +1 more. Returns: ok, data, tool, error

enqueue_after_effects_renderEnqueue After Effects RenderA

Queue exactly one previewed After Effects render with named host templates. Requires explicit confirmation; it saves the open project but never starts rendering or overwrites output.

Inputs: preview_token (required), confirm_enqueue (required). Returns: ok, data, tool, error

export_aafExport AafA

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

Inputs: output_path (required), sample_rate, mix_down_video, bits_per_sample, +1 more. Returns: ok, data, tool, error

export_as_fcp_xmlExport As Fcp XmlA

Export the active sequence as a Final Cut Pro XML file. Fails when Premiere writes no file or leaves a pre-existing output unchanged.

Inputs: output_path (required). Returns: ok, data, tool, error

export_as_projectExport As ProjectA

Export a sequence as a standalone Premiere Pro project file. Fails when Premiere writes no file or leaves a pre-existing output unchanged.

Inputs: output_path (required), sequence_id. Returns: ok, data, tool, error

export_frameExport FrameA

Export a file-verified still image. QE frame capture may not evaluate keyframed animation like an actual video export; it does not verify temporal curves or playback.

Inputs: output_path (required), time_seconds. Returns: ok, data, tool, error

export_omfExport OmfA

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

Inputs: output_path (required), include_pan, sample_rate, handle_frames, +4 more. Returns: ok, data, tool, error

export_sequenceExport SequenceA

Export the active sequence directly (Premiere renders it; blocks until done) with an Adobe Media Encoder preset. The output extension must match what the preset writes (an H.264 preset in AME's QuickTime folder writes .mov); a missing extension is added. Refuses an output_path that already exists unless overwrite is true. Fails if Premiere rejects the render, and verifies a non-empty file was written (for an overwrite, that the file changed). range 'work_area' fails closed unless the work area is enabled and covers only part of the sequence — otherwise Premiere would encode the entire timeline.

Inputs: output_path (required), range, overwrite, preset_path, +2 more. Returns: ok, data, tool, error

export_sequence_clip_review_framesExport Sequence Clip Review FramesA

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

Inputs: output_dir (required), limit, track_index. Returns: ok, data, tool, error

export_sequence_edlExport Sequence EdlA

Generate a CMX 3600 EDL for one video or audio track of a sequence from Premiere timeline readback (cuts, reels, source/record timecode, M2 lines for retimed clips), self-validate it, and return it inline or write it inside an approved workspace. Premiere is only read; this is not a Premiere-native export.

Inputs: title, reel_mode, drop_frame, frame_rate, +8 more. Returns: ok, data, tool, error

export_sequence_marker_review_framesExport Sequence Marker Review FramesA

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

Inputs: output_dir (required), limit, end_seconds, marker_type, +1 more. Returns: ok, data, tool, error

export_sequence_review_framesExport Sequence Review FramesA

Export 2-24 evenly spaced, file-verified frames from an active-sequence range in one bridge round trip for visual review. Still capture does not verify temporal animation, playback, audio, or editorial quality; QE frames can differ from actual video exports.

Inputs: output_dir (required), end_seconds, frame_count, start_seconds. Returns: ok, data, tool, error

extract_selectionExtract SelectionA

EXPERIMENTAL (undocumented QE DOM: extract()). Extract (remove and close the gap) the content between the sequence in/out points on every targeted, unlocked track, then verify each targeted track lost exactly the range and its later clips moved up by the range. Requires sequence in/out marks that do not span the whole sequence. Premiere can also change untargeted tracks (for example the linked audio of targeted video, or sync-locked tracks); those are not verified but are listed in otherTracksChanged.

Returns: ok, data, tool, error

find_items_by_media_pathFind Items By Media PathB
Read-onlyIdempotent

Find project items whose media path contains the given search string

Inputs: path_search (required). Returns: ok, data, tool, error

find_project_item_by_nameFind Project Item By NameB
Read-onlyIdempotent

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

Inputs: name (required). Returns: ok, data, tool, error

freeze_frameFreeze FrameB

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

Inputs: output_path (required), time_seconds, duration_seconds. Returns: ok, data, tool, error

generate_media_contact_sheetGenerate Media Contact SheetA

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

Inputs: media_path (required), output_path (required), rows, columns, +1 more. Returns: ok, data, tool, error

get_active_sequenceGet Active SequenceA
Read-onlyIdempotent

Get bounded, paged information about the currently active sequence (50 clips by default). Follow pagination.nextOffset for more

Inputs: clip_limit, track_type, clip_offset, end_seconds, +2 more. Returns: ok, data, tool, error

get_advanced_feature_supportGet Advanced Feature SupportB
Read-onlyIdempotent

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

Inputs: backend, frameio_entitled, premiere_version, network_available, +1 more. Returns: ok, data, tool, error

get_all_project_pathsGet All Project PathsA
Read-onlyIdempotent

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

Returns: ok, data, tool, error

get_av_feature_supportGet Av Feature SupportB
Read-onlyIdempotent

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

Returns: ok, data, tool, error

get_bin_contentsGet Bin ContentsA
Read-onlyIdempotent

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

Inputs: bin_id (required), limit, offset, max_depth, +1 more. Returns: ok, data, tool, error

get_bridge_telemetryGet Bridge TelemetryA
Read-onlyIdempotent

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

Returns: ok, data, tool, error

get_capabilitiesGet CapabilitiesA
Read-onlyIdempotent

Discover Premiere operations and report backend coverage, authority, and verification requirements. Use tool_query with task keywords (for example transcript, captions, or review frames) for ranked, bounded matches available in this session. Use tool_names for exact lookups or tool_offset/tool_limit for paging. Discovery never grants authority or proves a live host is ready.

Inputs: tool_limit, tool_names, tool_query, tool_offset, +1 more. Returns: ok, data, tool, error

get_caption_style_guidanceGet Caption Style GuidanceA
Read-onlyIdempotent

Returns caption style presets (clean, bold_pop, karaoke, podcast, lecture) with font, position, and styling recommendations, plus Premiere UI steps for applying styles. Read-only guidance; NEVER modifies caption tracks. Use build_caption_artifact for SRT/VTT timing, then import via create_caption_track and apply styles manually in Premiere's UI.

Inputs: preset. Returns: ok, data, tool, error

get_clip_adjustment_layerGet Clip Adjustment LayerB
Read-onlyIdempotent

Check if a clip is an adjustment layer

Inputs: node_id (required). Returns: ok, data, tool, error

get_clip_at_playheadGet Clip At PlayheadB
Read-onlyIdempotent

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

Inputs: track_type. Returns: ok, data, tool, error

get_clip_at_positionGet Clip At PositionB
Read-onlyIdempotent

Get the clip at a specific time position on a track

Inputs: track_type (required), track_index (required), time_seconds (required). Returns: ok, data, tool, error

get_clip_markersGet Clip MarkersA
Read-onlyIdempotent

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

Inputs: item_id (required). Returns: ok, data, tool, error

get_clip_propertiesGet Clip PropertiesC
Read-onlyIdempotent

Get detailed properties of a specific clip by its node ID

Inputs: node_id (required). Returns: ok, data, tool, error

get_clip_speedGet Clip SpeedA
Read-onlyIdempotent

Get the playback speed and reverse state of a clip

Inputs: node_id (required). Returns: ok, data, tool, error

get_clip_volumeGet Clip VolumeA
Read-onlyIdempotent

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

Inputs: node_id (required). Returns: ok, data, tool, error

get_color_labelGet Color LabelC
Read-onlyIdempotent

Get the color label of a project item

Inputs: item_id (required). Returns: ok, data, tool, error

get_color_spaceGet Color SpaceB
Read-onlyIdempotent

Get the color space information for a project item

Inputs: item_id (required). Returns: ok, data, tool, error

get_duplicate_mediaGet Duplicate MediaA
Read-onlyIdempotent

Find project items that reference the same source media file. Useful for consolidation. After Effects compositions imported from the same .aep/.aepx are only grouped when their comp names also match. Groups are paged (default 100) and can be filtered by a case-insensitive item-name substring; follow nextOffset while truncated is true.

Inputs: limit, offset, contains. Returns: ok, data, tool, error

get_effect_propertiesGet Effect PropertiesB
Read-onlyIdempotent

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

Inputs: node_id (required), effect_name (required). Returns: ok, data, tool, error

get_encoder_presetsGet Encoder PresetsA
Read-onlyIdempotent

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

Inputs: format. Returns: ok, data, tool, error

get_export_file_extensionGet Export File ExtensionA
Read-onlyIdempotent

Get the export file extension from Premiere. If Premiere returns none, infer it only for an existing .epr in a recognized Adobe Media Encoder format folder; that fallback is marked unconfirmed and should be checked before delivery.

Inputs: preset_path (required). Returns: ok, data, tool, error

get_footage_interpretationGet Footage InterpretationB
Read-onlyIdempotent

Get footage interpretation settings for a project item

Inputs: item_id (required). Returns: ok, data, tool, error

get_full_clip_infoGet Full Clip InfoA
Read-onlyIdempotent

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

Inputs: node_id (required). Returns: ok, data, tool, error

get_full_project_overviewGet Full Project OverviewA
Read-onlyIdempotent

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

Inputs: max_bin_depth, sequence_limit, sequence_offset, include_bin_tree. Returns: ok, data, tool, error

get_full_sequence_infoGet Full Sequence InfoA
Read-onlyIdempotent

Get bounded information about a sequence (50 clips by default; follow pagination.nextOffset; markers and transitions capped at 50 per collection): settings, all tracks with lock/mute/target state, paged clips with positions/effects/speed/enabled state, bounded markers, transitions, in/out points, and work area.

Inputs: clip_limit, track_type, clip_offset, end_seconds, +3 more. Returns: ok, data, tool, error

get_graphics_white_luminanceGet Graphics White LuminanceA
Read-onlyIdempotent

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

Returns: ok, data, tool, error

get_insertion_binGet Insertion BinA
Read-onlyIdempotent

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

Returns: ok, data, tool, error

get_item_infoGet Item InfoB
Read-onlyIdempotent

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

Inputs: item_id (required). Returns: ok, data, tool, error

get_keyframesGet KeyframesA
Read-onlyIdempotent

Get all keyframes for a specific effect property on a clip. Each key's time is in seconds from the clip's start; mediaSeconds is Premiere's stored media time.

Inputs: node_id (required), effect_name (required), property_name (required). Returns: ok, data, tool, error

get_linked_itemsGet Linked ItemsB
Read-onlyIdempotent

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

Inputs: node_id (required). Returns: ok, data, tool, error

get_metadataGet MetadataA
Read-onlyIdempotent

Get metadata for a project item. Use parse_fields to return named XMP/project fields instead of raw XML. Project metadata XML and file/clip XMP are separate packets; disable either when identity/path is enough. Prefer inspect_project_panel_metadata_uxp item_columns or manage_metadata_uxp inspect_fields for visible columns. This is not the premiere://project/metadata resource. GPS and serials are omitted from parse_fields unless include_sensitive is true.

Inputs: item_id (required), parse_fields, include_sensitive, include_xmp_metadata, +1 more. Returns: ok, data, tool, error

get_mogrt_componentGet Mogrt ComponentA
Read-onlyIdempotent

Get MOGRT (Motion Graphics Template) component parameters from a clip. Each parameter includes textValue (visible text extracted from textEditValue when present). Pass expected_values to audit text controls such as Headline; the result flags verified, mismatch, or missing_property per field. Reads the stored property, not the Essential Graphics panel display, which Premiere can show stale (host UI behavior this tool cannot refresh).

Inputs: node_id (required), expected_values. Returns: ok, data, tool, error

get_next_edit_pointGet Next Edit PointA
Read-onlyIdempotent

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

Inputs: direction, track_type. Returns: ok, data, tool, error

get_offline_mediaGet Offline MediaA
Read-onlyIdempotent

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

Returns: ok, data, tool, error

get_playhead_positionGet Playhead PositionA
Read-onlyIdempotent

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

Returns: ok, data, tool, error

get_premiere_stateGet Premiere StateA
Read-onlyIdempotent

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

Returns: ok, data, tool, error

get_project_infoGet Project InfoA
Read-onlyIdempotent

Get information about the currently open Premiere Pro project

Returns: ok, data, tool, error

get_project_item_infoGet Project Item InfoB
Read-onlyIdempotent

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

Inputs: item_id (required). Returns: ok, data, tool, error

get_project_panel_metadataGet Project Panel MetadataA
Read-onlyIdempotent

Get the current Project-panel column layout as XML. This is schema/layout configuration, not per-item Scene/Shot/Take values; use inspect_project_panel_metadata_uxp item_columns or get_metadata for those. Output is capped by max_chars (default 20000); when truncated is true the XML is incomplete and must not be passed to set_project_panel_metadata.

Inputs: max_chars. Returns: ok, data, tool, error

get_project_scratch_disksGet Project Scratch DisksA
Read-onlyIdempotent

Get the project's scratch disk locations (captured media, previews, auto-save, Motion Graphics template media, and more). Premiere's scripting API has no scratch-disk getter, so the settings are read from the saved .prproj file; unsaved changes are not reflected. 'SameAsProject' resolves to the project's folder.

Returns: ok, data, tool, error

get_qe_clip_infoGet Qe Clip InfoA
Read-onlyIdempotent

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

Inputs: clip_index (required), track_type (required), track_index (required). Returns: ok, data, tool, error

get_render_queue_statusGet Render Queue StatusA
Read-onlyIdempotent

Report the Adobe Media Encoder queue running state, or fail closed with a named capability error when this Premiere build exposes no queue-status method on app.encoder.

Returns: ok, data, tool, error

get_selected_clipsGet Selected ClipsA
Read-onlyIdempotent

Get the currently selected clips in the active sequence

Returns: ok, data, tool, error

get_sequence_countGet Sequence CountA
Read-onlyIdempotent

Get the total number of sequences in the project.

Returns: ok, data, tool, error

get_sequence_in_out_pointsGet Sequence In Out PointsB
Read-onlyIdempotent

Get the current sequence in and out points

Returns: ok, data, tool, error

get_sequence_markers_by_typeGet Sequence Markers By TypeB
Read-onlyIdempotent

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

Inputs: marker_type (required), sequence_id. Returns: ok, data, tool, error

get_sequence_settingsGet Sequence SettingsB
Read-onlyIdempotent

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

Inputs: sequence_id. Returns: ok, data, tool, error

get_sequence_structureGet Sequence StructureA
Read-onlyIdempotent

Get a bounded structural page of the active sequence (50 clips by default; follow pagination.nextOffset): all track counts, paged clips with positions, gaps, and clip metadata. Essential for understanding timeline state before making edits.

Inputs: clip_limit, track_type, clip_offset, end_seconds, +3 more. Returns: ok, data, tool, error

get_source_monitor_infoGet Source Monitor InfoB
Read-onlyIdempotent

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

Returns: ok, data, tool, error

get_source_monitor_positionGet Source Monitor PositionA
Read-onlyIdempotent

Get the current time indicator position in the Source Monitor

Returns: ok, data, tool, error

get_target_tracksGet Target TracksA
Read-onlyIdempotent

Get which tracks are currently targeted for editing. Premiere allows several video or audio tracks to be targeted at the same time; every targeted track is listed. Tracks whose state cannot be read are listed under unreadable.

Returns: ok, data, tool, error

get_timeline_gapsGet Timeline GapsA
Read-onlyIdempotent

Find a bounded page of gaps (50 by default; follow pagination.nextOffset) on the timeline between clips. Useful for identifying where content is missing or where clips can be tightened.

Inputs: clip_limit, track_type, clip_offset, end_seconds, +4 more. Returns: ok, data, tool, error

get_timeline_summaryGet Timeline SummaryA
Read-onlyIdempotent

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

Inputs: sequence_id. Returns: ok, data, tool, error

get_total_clip_countGet Total Clip CountA
Read-onlyIdempotent

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

Returns: ok, data, tool, error

get_track_infoGet Track InfoB
Read-onlyIdempotent

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

Inputs: track_type (required), track_index (required). Returns: ok, data, tool, error

get_unused_mediaGet Unused MediaA
Read-onlyIdempotent

Find project items that are NOT used in any sequence. Useful for cleaning up projects. Results are paged (default 100 items) and can be filtered by a case-insensitive name substring; follow nextOffset while truncated is true.

Inputs: limit, offset, contains. Returns: ok, data, tool, error

get_used_media_reportGet Used Media ReportA
Read-onlyIdempotent

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

Inputs: sequence_id. Returns: ok, data, tool, error

get_value_at_timeGet Value At TimeB
Read-onlyIdempotent

Get the interpolated value of an effect property at a time, in seconds from the clip's start

Inputs: node_id (required), effect_name (required), time_seconds (required), property_name (required). Returns: ok, data, tool, error

get_version_infoGet Version InfoA
Read-onlyIdempotent

Get Premiere Pro version and build information.

Returns: ok, data, tool, error

get_work_areaGet Work AreaA
Read-onlyIdempotent

Get the current work area in and out points

Returns: ok, data, tool, error

get_workspacesGet WorkspacesA
Read-onlyIdempotent

List all available workspace layouts in Premiere Pro

Returns: ok, data, tool, error

get_xmp_metadataGet Xmp MetadataA
Read-onlyIdempotent

Get the raw file/clip XMP packet for a project item (Dublin Core, EXIF, IPTC, xmpDM, and other namespaces). Distinct from Premiere-private project metadata. Omit GPS and camera serials from user-facing reports unless requested.

Inputs: item_id (required). Returns: ok, data, tool, error

has_proxyHas ProxyC

Check if a project item has a proxy attached

Inputs: item_id (required). Returns: ok, data, tool, error

import_ae_compsImport Ae CompsA

Import After Effects compositions from an .aep file, failing closed when the file does not exist or when the target bin gains no items.

Inputs: ae_project_path (required), comp_names, target_bin. Returns: ok, data, tool, error

import_edlImport EdlA

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

Inputs: file_path (required). Returns: ok, data, tool, error

import_fcp_xmlImport Fcp XmlA

Open a Final Cut Pro XML file as a new Premiere project. app.openFCPXML(path, projPath) requires a destination project path; it does not merge the XML into the currently open project. verified is true only when that destination exists as a file and Premiere has that exact path open.

Inputs: path (required), project_path (required). Returns: ok, data, tool, error

import_folderImport FolderC

Import an entire folder of media into the project

Inputs: folder_path (required). Returns: ok, data, tool, error

import_image_sequenceImport Image SequenceB

Import a numbered image sequence as a single video clip.

Inputs: first_file_path (required), target_bin. Returns: ok, data, tool, error

import_mediaImport MediaB

Import media files into the project and confirm a new project item for each file

Inputs: file_paths (required), target_bin, suppress_ui. Returns: ok, data, tool, error

import_mogrtImport MogrtA

Import a Motion Graphics Template (.mogrt) file and add it to the timeline. Pass text_values (for example { "Headline": "..." }) to write each text control explicitly after insertion and verify it by readback, so a template default or stale value is never left in place silently.

Inputs: mogrt_path (required), text_values, track_index, start_seconds, +1 more. Returns: ok, data, tool, error

import_mogrt_from_libraryImport Mogrt From LibraryA

Request importing a MOGRT from a named Adobe Creative Cloud Library. Library contents cannot be enumerated through CEP; host acceptance is committed_unverified, and rendered appearance must be checked in Premiere.

Inputs: mogrt_name (required), library_name (required), track_index, start_seconds. Returns: ok, data, tool, error

import_sequencesImport SequencesC

Import sequences from another Premiere Pro project file

Inputs: project_path (required), sequence_ids (required). Returns: ok, data, tool, error

insert_from_sourceInsert From SourceA

Insert the clip from the Source Monitor at the playhead (insert edit). Experimental: a target clip spanning the playhead is QE-razored before insertion to attempt to preserve its split tail. By default the tool also razors and shifts every QE sync-locked track, then reads the placement and target tails back; a displaced tail is reported as committed_unverified. Pass scope 'target_tracks' to ripple only the named pair (this will desync other tracks).

Inputs: scope, audio_track_index, video_track_index. Returns: ok, data, tool, error

inspect_after_effects_render_templatesInspect After Effects Render TemplatesA
Read-onlyIdempotent

Read available render and output-module template names from the first existing After Effects render-queue item. It never queues or renders a composition.

Inputs: no named parameters. Returns: ok, data, tool, error

inspect_after_effects_template_sourceInspect After Effects Template SourceA
Read-onlyIdempotent

Inspect a saved After Effects source composition for MOGRT-relevant dimensions, duration, text fonts, layer-source kinds, and Essential Graphics controller names when the host exposes the AE 16.1+ readback API. It never creates a composition or returns asset paths.

Inputs: composition_name. Returns: ok, data, tool, error

inspect_cmx3600_edlInspect Cmx3600 EdlA
Read-onlyIdempotent

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

Inputs: path (required). Returns: ok, data, tool, error

inspect_dom_objectInspect Dom ObjectA
Read-onlyIdempotent

Inspect a Premiere Pro DOM object and list its properties, methods, and values. Useful for exploring the API and debugging. object_path must be a property path starting with app or qe (identifiers and numeric indexes only). Function calls, operators, and statements are rejected; use evaluate_expression with unsafe-script for those.

Examples:

  • "app.project" → project properties

  • "app.project.activeSequence" → sequence properties

  • "app.project.activeSequence.videoTracks[0].clips[0]" → first clip on V1

  • "app.project.activeSequence.videoTracks[0].clips[0].components[0]" → first component of a clip

Inputs: object_path (required), max_depth. Returns: ok, data, tool, error

inspect_edit_readinessInspect Edit ReadinessA
Read-onlyIdempotent

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

Inputs: primary_video_track, gap_tolerance_seconds, maximum_scale_percent. Returns: ok, data, tool, error

inspect_fcpxml_interchangeInspect Fcpxml InterchangeA
Read-onlyIdempotent

Inspect a local FCPXML or FCP7 XML (xmeml, what Premiere's export_as_fcp_xml writes) document: format, version, sequence/clip counts, bounded media declarations, and text-only parser warnings, before deliberate Premiere import.

Inputs: path (required). Returns: ok, data, tool, error

inspect_film_editorial_workflowInspect Film Editorial WorkflowA
Read-onlyIdempotent

Validate a revision-bound film editorial manifest against captured source and timeline identities. Build complete declared coverage review groups, independent picture/audio preferences, screening-note exceptions, story dependencies, VFX state, change impact and a department turnover manifest. Local inspection only: no host edits, exports, automatic creative decisions or verified host claims.

Inputs: vfx (required), notes (required), scenes (required), profile (required), +12 more. Returns: ok, data, tool, error

inspect_media_streamsInspect Media StreamsA
Read-onlyIdempotent

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

Inputs: media_path (required). Returns: ok, data, tool, error

inspect_mogrt_libraryInspect Mogrt LibraryA
Read-onlyIdempotent

List bounded top-level template names and version directories in an existing workspace-contained local MOGRT library. It never reads MOGRT contents or changes the library.

Inputs: library_directory (required), approved_workspace_path (required). Returns: ok, data, tool, error

inspect_project_item_av_metadataInspect Project Item Av MetadataB
Read-onlyIdempotent

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

Inputs: item_id (required). Returns: ok, data, tool, error

inspect_project_recoveryInspect Project RecoveryA
Read-onlyIdempotent

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

Returns: ok, data, tool, error

inspect_sequence_av_settingsInspect Sequence Av SettingsA
Read-onlyIdempotent

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

Returns: ok, data, tool, error

inspect_sequence_review_reportInspect Sequence Review ReportA
Read-onlyIdempotent

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

Inputs: max_markers, sequence_id, primary_video_track, include_marker_comments. Returns: ok, data, tool, error

inspect_stabilizer_statusInspect Stabilizer StatusA
Read-onlyIdempotent

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

Inputs: node_id. Returns: ok, data, tool, error

invert_selectionInvert SelectionA

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

Returns: ok, data, tool, error

is_work_area_enabledIs Work Area EnabledA

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

Inputs: no named parameters. Returns: ok, data, tool, error

lift_selectionLift SelectionA

EXPERIMENTAL (undocumented QE DOM: the sequence lift command, exposed as left() on 25.2). Lift (remove without closing the gap) the content between the sequence in/out points on every targeted, unlocked track, then verify the range is empty on those tracks and nothing else on them moved. Requires sequence in/out marks that do not span the whole sequence. Untargeted tracks are not verified; any that changed are listed in otherTracksChanged.

Returns: ok, data, tool, error

list_available_audio_effectsList Available Audio EffectsA
Read-onlyIdempotent

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

Returns: ok, data, tool, error

list_available_audio_transitionsList Available Audio TransitionsA
Read-onlyIdempotent

EXPERIMENTAL (undocumented QE DOM): List audio transitions. Reports an unavailable or empty legacy catalog as an error rather than an assumed usable list.

Returns: ok, data, tool, error

list_available_effectsList Available EffectsA
Read-onlyIdempotent

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

Returns: ok, data, tool, error

list_available_transitionsList Available TransitionsA
Read-onlyIdempotent

EXPERIMENTAL (undocumented QE DOM): List video transitions. Returns a built-in hint set on PPro 2026 where the registry list is empty even though by-name lookup works; the hint set is not exhaustive.

Returns: ok, data, tool, error

list_clip_effectsList Clip EffectsA
Read-onlyIdempotent

List effects/components exposed by the clip's standard DOM collection, with properties and current values. Some hosts omit QE-applied effects from this collection; absence here does not prove an effect is absent. get_effect_properties uses the same collection. Inspect Premiere's Effect Controls UI when complete QE effect presence must be confirmed.

Inputs: node_id (required). Returns: ok, data, tool, error

list_markersList MarkersA
Read-onlyIdempotent

List markers on the active sequence, or on a source project item that exposes a marker collection. A timeline-clip node_id returns a clean error instead of a raw TypeError.

Inputs: node_id. Returns: ok, data, tool, error

list_project_itemsList Project ItemsB
Read-onlyIdempotent

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

Inputs: bin_path. Returns: ok, data, tool, error

list_sequence_checkpointsList Sequence CheckpointsA
Read-onlyIdempotent

List '[checkpoint]' sequences created by create_sequence_checkpoint, optionally only those cloned from one sequence, with their labels, timestamps, track and clip counts. Read-only.

Inputs: sequence_id. Returns: ok, data, tool, error

list_sequencesList SequencesA
Read-onlyIdempotent

List all sequences in the project

Returns: ok, data, tool, error

list_sequence_tracksList Sequence TracksB
Read-onlyIdempotent

List all tracks (video and audio) in a sequence

Inputs: sequence_id. Returns: ok, data, tool, error

list_stock_titlesList Stock TitlesA
Read-onlyIdempotent

List the Essential Graphics title templates that ship with the installed Premiere Pro (Basic Title, Lower Thirds, Credits, Social Media, and more), with each template's text fields in order and their default text. Reads the local .mogrt files only; does not contact Premiere. Use the names with add_title.

Inputs: category. Returns: ok, data, tool, error

lock_trackLock TrackB

Set a video track's lock state and read it back to verify the change.

Inputs: locked (required), track_index (required). Returns: ok, data, tool, error

manage_media_watchManage Media WatchA

Start, inspect, rescan, or stop one session-scoped local media-folder monitor. It records bounded file-change signals and never imports media automatically.

Inputs: action (required), recursive, watch_path, target_bin_id, +2 more. Returns: ok, data, tool, error

manage_project_contextManage Project ContextA
Destructive

Capture, enrich, import revision-bound editorial evidence, inspect, or clear a durable local Premiere project-context index. Capture stores bounded active-sequence/source metadata; local enrichment and evidence import add caller-approved transcripts, speaker labels, shots, audio observations, notes, or opaque frame references without re-analyzing media. Never include secrets or unrelated customer data.

Inputs: action (required), records, replace, evidence, +1 more. Returns: ok, data, tool, error

manage_proxiesManage ProxiesA

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

Inputs: action (required), item_id (required), proxy_path, output_path, +2 more. Returns: ok, data, tool, error

match_frameMatch FrameC

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

Inputs: track_type, track_index. Returns: ok, data, tool, error

move_clipMove ClipA

EXPERIMENTAL (undocumented QE DOM for track changes): Move a clip to a new position on the timeline; optional track moves use Premiere's QE API and may not work on every version.

Inputs: node_id (required), new_start_seconds (required), new_track_index. Returns: ok, data, tool, error

move_clip_to_trackMove Clip To TrackA

Move a clip to a different track of the same type, keeping its start, duration, and source in/out. EXPERIMENTAL: uses the undocumented QE DOM moveToTrack. Refuses without changing anything when the origin or destination track is locked or the destination range is occupied. Reads the timeline back: verified only when the clip is on the destination track with the same span and source range and is gone from the origin track; committed_unverified when the source range cannot be read; otherwise failure with Undo guidance.

Inputs: node_id (required), target_track_index (required). Returns: ok, data, tool, error

move_items_to_binMove Items To BinC

Move multiple project items to a target bin at once.

Inputs: item_ids (required), target_bin (required). Returns: ok, data, tool, error

move_item_to_binMove Item To BinB

Move a project item to a different bin and confirm where it landed

Inputs: item_id (required), target_bin (required). Returns: ok, data, tool, error

move_playhead_to_editMove Playhead To EditC

Move the playhead to the next or previous edit point.

Inputs: direction. Returns: ok, data, tool, error

multiple_undoMultiple UndoA

EXPERIMENTAL (undocumented QE DOM: qe.project.undo / undoStackIndex). Undo several Premiere project actions through QE, checking each step against Premiere's undo-stack position (stackVerified; the timeline itself is not read back) and reporting how many were undone. Only actions Premiere records are undoable: QE edits such as razor, insert, lift and extract report undoSteps (and undoStackIndex) in their results; pass that undoSteps as count to reverse exactly that call. A marker receipt with undoTracked:false recorded no undo step: calling Undo for it would reverse an earlier action. Only CEP tool results carry undoSteps; UXP tools and workflows that send several commands are not counted. Always pass expected_undo_stack_index to check the stack position, but matching position alone does not prove which action is on top. Observed marker boundaries refuse the entire request before any step unless acknowledge_untracked_markers:true explicitly permits prior non-marker actions. The barrier persists through server/helper reloads while the CEP engine remains alive; it cannot account for marker writes before observation, after an engine reset, or through UXP, the manual UI, or other clients. Matching the QE index verifies stack position only.

Inputs: expected_undo_stack_index (required), count, acknowledge_untracked_markers. Returns: ok, data, tool, error

mute_trackMute TrackB

Mute or unmute an audio track

Inputs: muted (required), track_index (required). Returns: ok, data, tool, error

nest_clipsNest ClipsC

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

Inputs: name (required). Returns: ok, data, tool, error

normalize_loudness_fileNormalize Loudness FileA

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

Inputs: input_path (required), output_path (required), target_lufs, tolerance_lu, +1 more. Returns: ok, data, tool, error

open_in_sourceOpen In SourceA

Open a project item in the Source Monitor for preview and trimming, and confirm it is the clip now showing.

Inputs: item_id (required). Returns: ok, data, tool, error

open_projectOpen ProjectA

Open a Premiere Pro project file and make it the active project, verifying it is open. Other open projects stay open.

Inputs: path (required). Returns: ok, data, tool, error

overwrite_clipOverwrite ClipB

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

Inputs: item_id (required), track_index, start_seconds, audio_track_index. Returns: ok, data, tool, error

overwrite_from_sourceOverwrite From SourceB

Overwrite the clip from the Source Monitor at the playhead position (overwrite edit — replaces existing clips) and verify a new placement on the requested tracks.

Inputs: audio_track_index, video_track_index. Returns: ok, data, tool, error

paste_clip_attributesPaste Clip AttributesA

Paste Attributes for one timeline clip: copy the source clip's effect stack (Motion, Opacity, other intrinsic components, and every applied effect) onto a target clip of the same track type, including keyframes. Components are matched by match name and occurrence; a missing non-intrinsic effect is applied through the experimental legacy QE DOM (disable with apply_missing_effects=false). Every written parameter and keyframe value is read back and reported per property as verified, committed_unverified, or failed, with an overall status. Not copied, and listed in notCopied with a reason: parameters whose values ExtendScript cannot read as numbers, booleans, strings, or numeric arrays; Opacity > Blend Mode when it differs (legacy cross-clip enum writes can corrupt it; use set_blend_mode and verify); and keyframe interpolation (no getter exists, so pasted keys use Premiere's default interpolation). MASKS ARE NOT COPIED: neither ExtendScript, QE, nor documented Premiere UXP exposes mask shapes, paths, feather, expansion, or mask keyframes, and masks are invisible to this bridge, so recreate or paste masks manually in Effect Controls. Time Remapping is excluded unless named in components.

Inputs: source_node_id (required), target_node_id (required), components, copy_keyframes, +1 more. Returns: ok, data, tool, error

pingPingA

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

Returns: ok, data, tool, error

plan_active_speaker_reframePlan Active Speaker ReframeA
Read-onlyIdempotent

Plan an active-speaker vertical reframe (Motion Scale/Position keyframes that follow whoever is talking) or a static stacked/split layout from a word timeline and static speaker regions. Returns framings, switches, keyframes, and apply routes. Local-only; never changes Premiere.

Inputs: source_frame (required), word_timeline (required), speaker_regions (required), layout, +7 more. Returns: ok, data, tool, error

plan_beat_montagePlan Beat MontageA
Read-onlyIdempotent

Plan a beat-synced montage: carve a detect_beats grid into shots every N beats (merging short and splitting long spans), assign clips in order, and emit add_to_timeline_batch chunks, trim ranges, and cut markers. Local-only and deterministic; never changes Premiere.

Inputs: clips (required), beat_seconds (required), order, frame_rate, +8 more. Returns: ok, data, tool, error

plan_chapter_markersPlan Chapter MarkersA
Read-onlyIdempotent

Plan YouTube-style chapters from a word-timed transcript using local TextTiling-lite topic-shift detection, titling each chapter from its distinctive tokens. Returns chapters, a youtube_timestamps block and add_marker-ready Chapter markers. Local-only plan; never changes Premiere.

Inputs: word_timeline (required), frame_rate, stop_words, block_words, +3 more. Returns: ok, data, tool, error

plan_client_notes_checklistPlan Client Notes ChecklistA
Read-onlyIdempotent

Turn pasted client or reviewer feedback into a prioritized checklist: finds timecodes and ranges, classifies each note (audio, color, graphics, text, timing, cut, legal, delivery), infers must/should/nice priority, separates approvals and questions, and emits an add_markers_batch payload. Local-only and deterministic; never changes Premiere.

Inputs: notes (required), max_items, frame_rate, timecode_style, +5 more. Returns: ok, data, tool, error

plan_cross_app_workflowPlan Cross App WorkflowA
Read-onlyIdempotent

Plan an After Effects MOGRT or rendered-file handoff to Premiere using existing tools. Returns ordered dependencies, separate approvals, required evidence, and manual render stops. Local-only planning; never executes steps, issues approval tokens, or claims host readiness.

Inputs: workflow (required). Returns: ok, data, tool, error

plan_emphasis_zoom_keyframesPlan Emphasis Zoom KeyframesA
Read-onlyIdempotent

Plan CapCut-style punch-in zoom keyframes (Motion Scale + subject-anchored Position) from a word timeline or supplied trigger times, with cooldown, easing, and hold controls. Local-only and deterministic; returns a keyframe plan for automate_effect_parameters_uxp or add_keyframe and never changes Premiere.

Inputs: frame, trigger, alternate, max_zooms, +13 more. Returns: ok, data, tool, error

plan_filler_word_removalPlan Filler Word RemovalA
Read-onlyIdempotent

Plan word-level filler removal (um, uh, you know...) from a revision-bound word timeline. Returns frame-snapped removal and keep ranges plus apply routes. Local-only; never changes Premiere.

Inputs: word_timeline (required), frame_rate, filler_words, max_removals, +3 more. Returns: ok, data, tool, error

plan_multicam_angle_switchesPlan Multicam Angle SwitchesA
Read-onlyIdempotent

Plan active-speaker camera switching for stacked, synced camera tracks: from speaker segments and a camera-to-speaker map it produces an angle cut list with minimum holds, crosstalk cover shots, optional lead-in cuts and periodic cutaways, plus razor times, per-camera enable/disable ranges, and markers. Local-only and deterministic; never changes Premiere.

Inputs: cameras (required), speaker_segments (required), frame_rate, marker_color, +8 more. Returns: ok, data, tool, error

plan_pause_tighteningPlan Pause TighteningA
Read-onlyIdempotent

Plan shortening (not deleting) of inter-word pauses longer than max_pause_seconds down to a target, respecting sentence boundaries. Returns centered removal ranges, keep ranges, savings and apply routes. Local-only; never changes Premiere.

Inputs: word_timeline (required), max_edits, frame_rate, max_pause_seconds, +2 more. Returns: ok, data, tool, error

plan_platform_delivery_matrixPlan Platform Delivery MatrixA
Read-onlyIdempotent

Plan multi-ratio delivery of one source sequence to TikTok, Reels, Shorts, YouTube, LinkedIn, X, and Facebook from a local spec table: sequence settings, reframe scale math, duration and file-size fit, caption safe zones, and ordered apply routes. Local-only; never changes Premiere.

Inputs: source (required), targets (required), strategy, export_preset_hint. Returns: ok, data, tool, error

plan_reaction_captionsPlan Reaction CaptionsA
Read-onlyIdempotent

Plan stacked, speaker-colored reaction captions from a word timeline and an explicit speaker palette. Flash-length words merge, overlaps stack, and unknown speakers stay uncolored. Local-only; never changes Premiere.

Inputs: word_timeline (required), speaker_palette (required), frame_rate, shot_changes, +6 more. Returns: ok, data, tool, error

plan_short_export_folderPlan Short Export FolderA
Read-onlyIdempotent

Plan a series-named export folder inside an approved Shorts root and remind the caller to create it when missing. Local-only; never writes files or changes Premiere.

Inputs: title (required), export_root (required), series_name (required), brand, +1 more. Returns: ok, data, tool, error

plan_short_subscribe_ctaPlan Short Subscribe CtaA
Read-onlyIdempotent

Plan a brief subscribe overlay about two-thirds through a Short, after an optional hook, in a platform-safe lower-third. Local-only; never changes Premiere.

Inputs: duration_seconds (required), copy, brand, at_ratio, +4 more. Returns: ok, data, tool, error

plan_shot_matchPlan Shot MatchA

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

Inputs: target_media_path (required), reference_media_path (required), target_time_seconds, reference_time_seconds. Returns: ok, data, tool, error

plan_silence_review_markersPlan Silence Review MarkersA
Read-onlyIdempotent

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

Inputs: media_path (required), timeline_start_seconds (required), max_candidates, source_in_seconds, +3 more. Returns: ok, data, tool, error

plan_speaker_checkerboardPlan Speaker CheckerboardA
Read-onlyIdempotent

Plan a speaker checkerboard (each speaker's turns on their own video/audio track) from a caller-supplied word timeline. Returns frame-snapped segments, split points, track assignments, and the add_track/razor_all_tracks/move_clip_to_track routes. Local-only; never changes Premiere.

Inputs: word_timeline (required), frame_rate, handle_frames, speaker_order, +5 more. Returns: ok, data, tool, error

plan_word_mute_rangesPlan Word Mute RangesA
Read-onlyIdempotent

Plan mute or bleep ranges for listed words/phrases in a word timeline. Returns redacted, frame-snapped mute ranges, ready-to-apply audio keyframes and (for bleep) tone placements. Local-only; never changes Premiere.

Inputs: words (required), word_timeline (required), mode, frame_rate, +2 more. Returns: ok, data, tool, error

play_source_monitorPlay Source MonitorA

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

Inputs: speed. Returns: ok, data, tool, error

play_timelinePlay TimelineA

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

Returns: ok, data, tool, error

preview_after_effects_renderPreview After Effects RenderA
Read-onlyIdempotent

Preview a bounded queue-only After Effects render request for one named composition and existing workspace output directory. It does not contact Adobe, enqueue, or render.

Inputs: output_path (required), composition_name (required), output_module_template (required), approved_workspace_path (required… Returns: ok, data, tool, error

preview_after_effects_render_handoffPreview After Effects Render HandoffA
Read-onlyIdempotent

Preview import of one completed After Effects single-file render into an existing Premiere bin. Reads both connected hosts and binds approval to file metadata and project/bin identity. Does not render, import, or edit a timeline.

Inputs: output_path (required), target_bin_id (required), ae_project_path (required), queue_item_index (required), +2 more. Returns: ok, data, tool, error

preview_brand_spotPreview Brand SpotA
Read-onlyIdempotent

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

Inputs: sequence_id (required), asset_item_ids (required), mogrt_path, motion_style, +8 more. Returns: ok, data, tool, error

preview_editorial_planPreview Editorial PlanA
Read-onlyIdempotent

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

Inputs: plan (required). Returns: ok, data, tool, error

preview_edit_planPreview Edit PlanA

Inspect sequence, project item, clip and requested track targets before previewing a compound timeline edit without changing Premiere. Returns a single-use confirmation token bound to stable project, sequence and target identities; it expires after 30 minutes and is required by apply_edit_plan.

Inputs: plan (required). Returns: ok, data, tool, error

preview_mogrt_batchPreview Mogrt BatchA
Read-onlyIdempotent

Preview up to 20 bounded MOGRT recipe exports from a workspace-contained JSON or CSV data file. It does not contact Adobe or create any compositions or files.

Inputs: data_file_path (required), output_directory (required), approved_workspace_path (required), brand_kit. Returns: ok, data, tool, error

preview_mogrt_library_publishPreview Mogrt Library PublishA
Read-onlyIdempotent

Preview a no-overwrite publish of a validated MOGRT into a workspace-contained, versioned local library. The library root must already exist; no file or directory is created during preview.

Inputs: mogrt_path (required), template_name (required), library_directory (required), approved_workspace_path (required). Returns: ok, data, tool, error

preview_mogrt_premiere_handoffPreview Mogrt Premiere HandoffA
Read-onlyIdempotent

Preview a contained MOGRT import into one explicitly named disposable Premiere verification sequence and empty video track. It does not contact Premiere or alter a sequence.

Inputs: mogrt_path (required), sequence_id (required), approved_workspace_path (required), disposable_sequence_name (required), +… Returns: ok, data, tool, error

preview_mogrt_recipePreview Mogrt RecipeA
Read-onlyIdempotent

Preview a bounded After Effects MOGRT recipe from the supported title, callout, quote, social, and media-placeholder template library. It validates one existing workspace output directory but does not contact Adobe or write any files.

Inputs: headline (required), template_name (required), output_directory (required), approved_workspace_path (required), +11 more. Returns: ok, data, tool, error

preview_motion_graphics_demoPreview Motion Graphics DemoA
Read-onlyIdempotent

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

Inputs: sequence_id (required), asset_item_ids (required), transition_name, audio_track_index, +3 more. Returns: ok, data, tool, error

preview_product_spotPreview Product SpotA
Read-onlyIdempotent

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

Inputs: sequence_id (required), asset_item_ids (required), motion_style, transition_name, +4 more. Returns: ok, data, tool, error

preview_project_intakePreview Project IntakeA
Read-onlyIdempotent

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

Inputs: template (required), max_items, include_paths. Returns: ok, data, tool, error

preview_watched_media_importPreview Watched Media ImportA
Read-onlyIdempotent

Compare the active watch baseline with a fresh contained scan and return a path-redacted import proposal. It never imports or changes Premiere.

Inputs: watch_id (required), include_paths, known_media_path_hashes. Returns: ok, data, tool, error

preview_workflow_recipePreview Workflow RecipeA
Read-onlyIdempotent

Validate and expand one declarative workflow recipe into guarded MCP routes. It does not invoke any route or change Premiere.

Inputs: recipe_id (required), recipe_file, provided_inputs, approved_workspace_path. Returns: ok, data, tool, error

publish_mogrt_to_libraryPublish Mogrt To LibraryA

Publish the exact previewed MOGRT as an immutable local-library version. Requires explicit confirmation and will fail instead of replacing an existing version.

Inputs: preview_token (required), confirm_publish (required). Returns: ok, data, tool, error

rank_short_form_candidatesRank Short Form CandidatesA
Read-onlyIdempotent

Rank long-video transcript windows as short-form clip candidates using explainable local heuristics (hook, completeness, density, supplied evidence peaks, keywords, duration fit, speaker consistency) with overlap suppression. Local-only plan; not a virality prediction and never changes Premiere.

Inputs: word_timeline (required), keywords, frame_rate, hook_words, +7 more. Returns: ok, data, tool, error

razor_all_tracksRazor All TracksA

Razor (split) all clips at the playhead position across all tracks, or at a specific time. A read-only preflight counts eligible track cuts; the host wait scales by that count (400 ms per cut plus 30 seconds headroom, capped at 15 minutes).

Inputs: track_type, time_seconds. Returns: ok, data, tool, error

read_sequence_captionsRead Sequence CaptionsA
Read-onlyIdempotent

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

Inputs: sequence_id. Returns: ok, data, tool, error

read_video_scopesRead Video ScopesB

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

Inputs: media_path (required), time_seconds. Returns: ok, data, tool, error

redoRedoA

EXPERIMENTAL (undocumented QE DOM: qe.project.redo / undoStackIndex). Redo the most recently undone Premiere project action(s) through QE, checked step by step against Premiere's undo-stack position (stackVerified; the timeline itself is not read back). To restore a tool call undone with undo, pass the same count. Observed marker boundaries refuse before any step; acknowledge_untracked_markers:true permits prior non-marker actions, without proving marker reversal.

Inputs: expected_undo_stack_index (required), count, acknowledge_untracked_markers. Returns: ok, data, tool, error

refresh_mediaRefresh MediaA

Refresh a project item to pick up changes to the source file. The interpreted frame rate is read before and after; if the refresh leaves an implausible rate (seen on stills, e.g. 29.97 becoming 2.75e-8), the previous rate is restored and read back. Reports frameRateBefore, frameRateAfter and repaired.

Inputs: item_id (required). Returns: ok, data, tool, error

remove_all_effectsRemove All EffectsA
Destructive

Remove every effect from a clip, keeping its built-in components (Opacity, Motion, Volume, Channel Volume, Panner), and verify the result. EXPERIMENTAL: when Premiere has no Component.remove() (25.2), it removes through the undocumented QE DOM's targeted qeClip.getComponentAt(i).remove(). Every matching component's removal path is checked before any is removed; it returns a capability error, with nothing changed, when neither path is available.

Inputs: node_id (required). Returns: ok, data, tool, error

remove_effectRemove EffectA
Destructive

Remove one effect from a clip by its index or name (the last instance when names repeat) and verify the clip's components afterwards. Built-in components (Opacity, Motion, Volume, Channel Volume, Panner) cannot be removed. EXPERIMENTAL: when Premiere has no Component.remove() (25.2), it removes through the undocumented QE DOM's targeted qeClip.getComponentAt(i).remove(). Every matching component's removal path is checked before any is removed; it returns a capability error, with nothing changed, when neither path is available.

Inputs: node_id (required), effect_name, effect_index. Returns: ok, data, tool, error

remove_effect_by_nameRemove Effect By NameA
Destructive

Remove all instances of a specific effect from a clip by display name and verify the clip's components afterwards. EXPERIMENTAL: when Premiere has no Component.remove() (25.2), it removes through the undocumented QE DOM's targeted qeClip.getComponentAt(i).remove(). Every matching component's removal path is checked before any is removed; it returns a capability error, with nothing changed, when neither path is available.

Inputs: node_id (required), effect_name (required). Returns: ok, data, tool, error

remove_from_timelineRemove From TimelineA
Destructive

Remove a clip from the timeline. By default its linked audio/video partners go with it, as with Premiere's Clear on a linked clip. With ripple: true the gap is closed through the same explicit, verified ripple delete as ripple_delete (Premiere's own ripple flag does nothing on current builds), shifting sync-locked tracks so audio stays in sync.

Inputs: node_id (required), ripple, include_linked, allow_large_ripple, +1 more. Returns: ok, data, tool, error

remove_keyframeRemove KeyframeA
Destructive

Remove the keyframe at a time from an effect property and read the remaining keys back. Refuses, changing nothing, when no key is within 0.01s of that time.

Inputs: node_id (required), effect_name (required), time_seconds (required), property_name (required). Returns: ok, data, tool, error

remove_keyframe_rangeRemove Keyframe RangeA
Destructive

Remove every keyframe in a time range (inclusive) from an effect property and read the remaining keys back. Refuses, changing nothing, when the range holds no key.

Inputs: node_id (required), effect_name (required), end_seconds (required), property_name (required), +1 more. Returns: ok, data, tool, error

remove_selected_clipsRemove Selected ClipsB
Destructive

Remove all currently selected clips from the timeline.

Inputs: ripple. Returns: ok, data, tool, error

rename_binRename BinB

Rename a bin (folder) in the project panel

Inputs: bin_id (required), new_name (required). Returns: ok, data, tool, error

rename_clipRename ClipA

Rename a clip on the timeline and verify the new name.

Inputs: node_id (required), new_name (required). Returns: ok, data, tool, error

rename_project_itemRename Project ItemC

Rename a project item in the project panel.

Inputs: item_id (required), new_name (required). Returns: ok, data, tool, error

rename_trackRename TrackB

Rename a video or audio track.

Inputs: name (required), track_type (required), track_index (required). Returns: ok, data, tool, error

replace_clipReplace ClipA

Replace one timeline clip with a different project item on the same track, keeping the exact timeline start and end. The replacement plays from its own In mark for the original clip's duration; neighbouring clips do not ripple, and a linked partner clip on another track is left in place. Refuses without changing anything when the track is locked. Reads the track back: verified when the new clip covers the same span, committed_unverified when the span holds but the source In point cannot be confirmed, otherwise failure with Undo guidance.

Inputs: node_id (required), new_item_id (required). Returns: ok, data, tool, error

replace_clip_mediaReplace Clip MediaB

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

Inputs: new_item_id (required), clip_node_id (required). Returns: ok, data, tool, error

reverse_clipReverse ClipA

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

Inputs: node_id (required), reverse. Returns: ok, data, tool, error

review_broll_placementsReview Broll PlacementsA
Read-onlyIdempotent

Review caller-proposed owned-footage B-roll picks with matched quote, reason, alternatives, source/sequence revisions and explicit decisions. Reject overlapping approved placements. Does not infer visual content, search stock, inspect track occupancy or insert clips.

Inputs: placements (required), rejected_ids, selected_ids, expected_review_revision. Returns: ok, data, tool, error

review_dialogue_candidatesReview Dialogue CandidatesA
Read-onlyIdempotent

Review revision-bound dialogue candidates with surrounding words, silence padding, explicit keep/reject decisions and unioned source-time removal duration. Recomputed review revisions reject stale selections. Local-only; no timeline mapping, transcription or mutation.

Inputs: segments (required), filler_words, rejected_ids, selected_ids, +4 more. Returns: ok, data, tool, error

review_quote_paper_editReview Quote Paper EditA
Read-onlyIdempotent

Review a transcript quote library, explicitly order approved quotes, and return running timings and a formula-neutralized CSV paper edit inline. Local-only; no files, provider calls or multi-source timeline assembly.

Inputs: segments (required), quote_order, expected_review_revision. Returns: ok, data, tool, error

review_sync_evidenceReview Sync EvidenceA
Read-onlyIdempotent

Review caller-supplied camera/recorder offset estimates for independent-method agreement, confidence and conflicting alternatives. All matches require selection; conflicting matches cannot be approved. Does not analyze audio, calibrate confidence or synchronize Premiere.

Inputs: matches (required), rejected_ids, selected_ids, minimum_confidence, +2 more. Returns: ok, data, tool, error

review_text_changesReview Text ChangesA
Read-onlyIdempotent

Preview literal replacements or supplied copy changes for inspected MOGRT text and supplied caption artifacts. Preserve original text and evidence revisions with explicit approve/reject decisions. Does not translate, access native graphics/caption text or apply changes.

Inputs: entries (required), find_text, rejected_ids, replace_text, +2 more. Returns: ok, data, tool, error

ripple_deleteRipple DeleteA
Destructive

Remove a clip and close the gap it leaves, shifting later clips earlier on the clip's own track and on every sync-locked track so audio stays in sync. With the default scope the clip's linked audio/video partners are removed with it and their tracks close up too, even when not sync-locked; with scope 'own_track' the partners stay in place (reported as linkedPartnersKept). Premiere's QE rippleDelete() and the DOM's rippleEdit flag are both non-functional on 26.x, so this is done explicitly and verified. Refuses without changing anything if a clip on a participating track straddles the ripple point or sits inside the range being closed.

Inputs: node_id (required), scope, dry_run, range_content, +2 more. Returns: ok, data, tool, error

roll_editRoll EditA

Perform a verified roll edit at the outgoing cut of a clip using the public timeline DOM, moving both visible edges and their source in/out points and verifying all four. Linked audio/video partners get the same edit by default (include_linked); every clip is checked before any is changed. Requires readable finite media and ffprobe duration evidence for every edited source; refuses unknown duration, stills, and nonunit/reversed speed before mutation.

Inputs: node_id (required), offset_seconds (required), include_linked. Returns: ok, data, tool, error

save_projectSave ProjectA

Save the current Premiere Pro project to its existing path. Fails when the project has never been saved (use save_project_as) or when Premiere writes no non-empty file. Fresh disk metadata verifies a save; unchanged or unreadable metadata reports committed_unverified.

Returns: ok, data, tool, error

save_project_asSave Project AsA

Save the current project to a new .prproj path. Premiere then has the NEW copy open and closes the original, so later edits go to the copy; the result reports both paths. Fails when Premiere writes no file or leaves a pre-existing path unchanged. Use open_project to return to the original.

Inputs: path (required). Returns: ok, data, tool, error

scene_edit_detectionScene Edit DetectionA

Perform Premiere's scene edit detection on the selected clips in the active sequence (it analyses the footage and can take minutes on long clips). CreateMarkers (default) puts Segmentation markers on the selected clips' source project items (shared by every sequence that uses them), removes duplicates this run created (markers that were already there are never deleted), and reports each detected cut in source and timeline seconds; it is verified only when at least one new marker was added. ApplyCuts razors the selected clips and verifies the clip count grew. EXPERIMENTAL QE: CreateMarkers records an observed marker boundary for guarded Undo/Redo; crossing it is refused by default, and unreadable history records unknown protection. This boundary does not verify native marker reversal.

Inputs: action, sensitivity, apply_cuts_to_linked_audio. Returns: ok, data, tool, error

search_project_contextSearch Project ContextA
Read-onlyIdempotent

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

Inputs: query (required), project_id (required), kinds, max_results, +1 more. Returns: ok, data, tool, error

search_project_itemsSearch Project ItemsB
Read-onlyIdempotent

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

Inputs: query, extension, item_type, color_label, +2 more. Returns: ok, data, tool, error

search_workflow_recipesSearch Workflow RecipesA
Read-onlyIdempotent

Search audited built-in and explicitly supplied workspace-local workflow recipes. Recipes are declarative previews and cannot execute arbitrary tools or scripts.

Inputs: query, recipe_file, approved_workspace_path. Returns: ok, data, tool, error

select_all_clipsSelect All ClipsB

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

Inputs: track_type, track_index. Returns: ok, data, tool, error

select_clips_by_colorSelect Clips By ColorB

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

Inputs: color_index (required). Returns: ok, data, tool, error

select_clips_by_nameSelect Clips By NameA

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

Inputs: name (required), track_type, track_index, add_to_selection. Returns: ok, data, tool, error

select_clips_by_patternSelect Clips By PatternA

Select every Nth clip (with an offset) among clips that match optional name, duration, time-range, track, and enabled filters, then read back the selection count. Covers 'select every other clip on V1' and similar repetitive selections without changing the timeline.

Inputs: offset, every_nth, name_regex, track_type, +9 more. Returns: ok, data, tool, error

select_clips_in_rangeSelect Clips In RangeB

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

Inputs: end_seconds (required), start_seconds (required), track_type, track_index. Returns: ok, data, tool, error

select_disabled_clipsSelect Disabled ClipsB

Select all disabled clips in the active sequence.

Returns: ok, data, tool, error

select_itemSelect ItemB

Select a project item in the Project panel

Inputs: item_id (required). Returns: ok, data, tool, error

set_active_sequenceSet Active SequenceC

Set the active sequence by name or ID

Inputs: sequence_id (required). Returns: ok, data, tool, error

set_all_tracks_targetedSet All Tracks TargetedA

Set all tracks targeted or untargeted. Useful before insert/overwrite edits. Reads back every affected track and reports verified only when all match the requested state.

Inputs: targeted (required), track_type. Returns: ok, data, tool, error

set_anti_alias_qualitySet Anti Alias QualityA

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

Inputs: enabled (required), node_id (required). Returns: ok, data, tool, error

set_blend_modeSet Blend ModeA

Set a video clip's blend mode through its Opacity effect and read the stored mode back. Premiere stores the mode as an index into its modes in alphabetical order, with Subtract and Divide last (mapped on Premiere 25.2.3 by rendering every index over a known background).

Inputs: node_id (required), blend_mode (required). Returns: ok, data, tool, error

set_clip_anchor_pointSet Clip Anchor PointB

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

Inputs: x (required), y (required), node_id (required). Returns: ok, data, tool, error

set_clip_durationSet Clip DurationA

Set one timeline clip's visible duration by moving only its timeline end (TrackItem.end) while keeping its start fixed. Pass exactly one of duration_seconds or end_seconds. Works for extending still images past their import length. Refuses to overlap the next clip on the same track, rejects shortening that would strand effect keyframes unless keyframe_policy is preserve, reads start/end back, and restores the original end if Premiere clamps or ignores the write (for example when video media has no handle left). Linked audio/video partners get the same change by default (include_linked), applied as the same end offset so partners with a J/L cut keep their offset; every clip is checked before any is changed. Use this instead of speed changes, which Premiere does not expose to scripting.

Inputs: node_id (required), end_seconds, include_linked, keyframe_policy, +1 more. Returns: ok, data, tool, error

set_clip_opacitySet Clip OpacityA

Set the opacity of a video clip (0-100) using English or measured Spanish built-in names, then read it back.

Inputs: node_id (required), opacity (required). Returns: ok, data, tool, error

set_clip_panSet Clip PanB

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

Inputs: pan (required), node_id (required). Returns: ok, data, tool, error

set_clip_positionSet Clip PositionB

Set the Position property on a video clip's Motion effect using English or measured Spanish built-in names, then read it back. Values are in pixels.

Inputs: x (required), y (required), node_id (required). Returns: ok, data, tool, error

set_clip_propertiesSet Clip PropertiesA

Set supported clip properties (opacity, scale, position, rotation) and read each requested value back. Clip speed is unsupported and fails before mutation; use set_clip_duration to change a clip's timeline length.

Inputs: node_id (required), scale, speed, opacity, +3 more. Returns: ok, data, tool, error

set_clip_properties_batchSet Clip Properties BatchA

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

Inputs: items (required). Returns: ok, data, tool, error

set_clip_rotationSet Clip RotationB

Set the Rotation property on a video clip's Motion effect using English or measured Spanish built-in names, then read it back.

Inputs: degrees (required), node_id (required). Returns: ok, data, tool, error

set_clip_scaleSet Clip ScaleA

Scale a video clip evenly through its Motion effect using English or measured Spanish built-in names, and read the result back. With Uniform Scale off, both Scale (height) and Scale Width are set, so the picture is not stretched; use set_scale_width_height for different values.

Inputs: scale (required), node_id (required). Returns: ok, data, tool, error

set_clip_selectionSet Clip SelectionB

Select or deselect a clip in the active sequence

Inputs: node_id (required), selected (required). Returns: ok, data, tool, error

set_clip_speed_qeSet Clip Speed QeA

Unavailable: Premiere's documented ExtendScript and UXP APIs have no setter for a timeline clip's speed (only getters), and the undocumented QE setSpeed is deliberately not used. Always fails before mutation. To change how long a clip runs on the timeline, use set_clip_duration.

Inputs: node_id (required), speed_percent (required), reverse. Returns: ok, data, tool, error

set_clip_start_timeSet Clip Start TimeB

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

Inputs: item_id (required), start_seconds (required). Returns: ok, data, tool, error

set_clips_volumeSet Clips VolumeA

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

Inputs: volume_db (required), track_index (required), clip_indices. Returns: ok, data, tool, error

set_clip_volumeSet Clip VolumeA

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

Inputs: node_id (required), volume_db (required). Returns: ok, data, tool, error

set_color_labelSet Color LabelB

Set the color label on a project item or clip and read it back

Inputs: item_id (required), color_index (required). Returns: ok, data, tool, error

set_color_valueSet Color ValueB

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

Inputs: red (required), blue (required), alpha (required), green (required), +3 more. Returns: ok, data, tool, error

set_effect_propertySet Effect PropertyA

Set the value of a specific effect property on a clip. Accepts scalar, boolean, string, array-shaped vector values (for example Motion > Position as [x, y]), and MOGRT JSON objects or strings, and verifies the readback component by component.

Inputs: value (required), node_id (required), effect_name (required), property_name (required). Returns: ok, data, tool, error

set_footage_interpretationSet Footage InterpretationB

Set footage interpretation settings for a project item and read them back, including fields that were not meant to change

Inputs: item_id (required), frame_rate, pixel_aspect_ratio. Returns: ok, data, tool, error

set_frame_blendSet Frame BlendB

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

Inputs: enabled (required), node_id (required). Returns: ok, data, tool, error

set_graphics_white_luminanceSet Graphics White LuminanceA

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

Inputs: luminance (required). Returns: ok, data, tool, error

set_item_in_outSet Item In OutA

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

Inputs: item_id (required), in_seconds, media_type, out_seconds. Returns: ok, data, tool, error

set_keyframe_interpolationSet Keyframe InterpolationC

Set the interpolation type of an existing keyframe (Linear, Hold, or Bezier). Premiere exposes no interpolation readback, so a write is reported as committed_unverified. Stored curves do not establish rendering; A 26.5.2 Windows capture report shows identical modes; 25.2.3 macOS evidence distinguishes a QE still-capture artifact from correctly rendered video curves.

Inputs: node_id (required), effect_name (required), time_seconds (required), interpolation (required), +1 more. Returns: ok, data, tool, error

set_metadataSet MetadataA

Update project metadata on a project item. Supply complete metadata_xml plus updated_fields, or field_name and value to read-modify-write one XMP/project property through AdobeXMPScript with field readback. The project packet (default) stays in the project; packet 'xmp' is written by Premiere into the source media file on disk and requires the filesystem capability.

Inputs: item_id (required), value, packet, field_name, +4 more. Returns: ok, data, tool, error

set_offlineSet OfflineA

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

Inputs: item_id (required), offline. Returns: ok, data, tool, error

set_override_frame_rateSet Override Frame RateA

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

Inputs: item_id (required), frame_rate (required). Returns: ok, data, tool, error

set_override_pixel_aspect_ratioSet Override Pixel Aspect RatioB

Override the pixel aspect ratio of a project item and read it back

Inputs: item_id (required), numerator (required), denominator (required). Returns: ok, data, tool, error

set_playhead_positionSet Playhead PositionB

Set the playhead (CTI) position, clamp it to the active sequence's end, and read the stored position back.

Inputs: time_seconds (required). Returns: ok, data, tool, error

set_poster_frameSet Poster FrameA

Unavailable: Premiere's scripting API cannot set a project item's poster frame. Fails without changing the item; set it in the Project panel (Shift+P).

Inputs: item_id (required), time_seconds (required). Returns: ok, data, tool, error

set_project_item_audio_channel_mappingSet Project Item Audio Channel MappingB

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

Inputs: item_id (required), channel_index (required), source_channel_index (required). Returns: ok, data, tool, error

set_project_panel_metadataSet Project Panel MetadataA

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

Inputs: metadata_xml (required). Returns: ok, data, tool, error

set_project_scratch_diskSet Project Scratch DiskA

Set the project's scratch disks for captured video, captured audio, video previews and audio previews in one call. Each path must be an existing folder or "SameAsProject"; any rejected path fails the call.

Inputs: audio_previews, captured_audio, captured_video, video_previews, +1 more. Returns: ok, data, tool, error

set_scale_to_frame_sizeSet Scale To Frame SizeA

Enable 'Scale to Frame Size' so media fills the sequence frame. Accepts a timeline clip node ID (active sequence, same IDs as get_clip_properties) or a project item node ID or name. A timeline clip is resolved first and its source project item is updated through ProjectItem.setScaleToFrameSize(). ExtendScript exposes no getter for this flag, so the result is committed_unverified unless the timeline clip's Motion > Scale reads back changed (verified). Check with get_clip_properties.

Inputs: item_id (required). Returns: ok, data, tool, error

set_scale_width_heightSet Scale Width HeightA

Set independent width and height scale on a clip. Turns Uniform Scale off, writes Motion > Scale Width (width) and Motion > Scale (which Premiere uses as the height once Uniform Scale is off), then reads all three back. Fails when a value does not read back.

Inputs: node_id (required), scale_width (required), scale_height (required). Returns: ok, data, tool, error

set_scratch_disk_pathSet Scratch Disk PathB

Set one project scratch disk (captured media, previews, auto-save, CC Libraries or Motion Graphics template media) to an existing folder or "SameAsProject", using Premiere's ScratchDiskType constants.

Inputs: path (required), scratch_disk_type (required), save_and_verify. Returns: ok, data, tool, error

set_sequence_audio_settingsSet Sequence Audio SettingsB

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

Inputs: sample_rate, channel_type. Returns: ok, data, tool, error

set_sequence_display_formatSet Sequence Display FormatB

Set the timecode display format for the active sequence.

Inputs: audio_display_format, video_display_format. Returns: ok, data, tool, error

set_sequence_field_typeSet Sequence Field TypeC

Set the field order of the active sequence.

Inputs: field_type (required). Returns: ok, data, tool, error

set_sequence_frame_rateSet Sequence Frame RateC

Change the frame rate of the active sequence.

Inputs: frame_rate (required). Returns: ok, data, tool, error

set_sequence_in_out_pointsSet Sequence In Out PointsA

Set the sequence in and out points (for an export range, etc.) and read them back. out_seconds must be after in_seconds and not past the sequence end.

Inputs: in_seconds (required), out_seconds (required). Returns: ok, data, tool, error

set_sequence_pixel_aspect_ratioSet Sequence Pixel Aspect RatioA

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

Inputs: ratio (required). Returns: ok, data, tool, error

set_sequence_resolutionSet Sequence ResolutionC

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

Inputs: width (required), height (required). Returns: ok, data, tool, error

set_sequence_settingsSet Sequence SettingsC

Modify and read back sequence frame-size settings.

Inputs: width, height, sequence_id. Returns: ok, data, tool, error

set_source_in_outSet Source In OutA

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

Inputs: in_seconds, out_seconds. Returns: ok, data, tool, error

set_start_timeSet Start TimeB

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

Inputs: item_id (required), start_seconds (required). Returns: ok, data, tool, error

set_target_trackSet Target TrackA

Target or untarget one video or audio track for source-patched insert/overwrite edits. Premiere allows several tracks of a type to be targeted at once, so by default (exclusive=true) targeting a track also untargets every other track of the same type. Reads back every track of that type and reports verified only when the readback matches the requested state; otherwise committed_unverified or an error.

Inputs: targeted (required), track_type (required), track_index (required), exclusive. Returns: ok, data, tool, error

set_time_interpolationSet Time InterpolationB

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

Inputs: node_id (required), interpolation_type (required). Returns: ok, data, tool, error

set_transcode_on_ingestSet Transcode On IngestA

Request enabling or disabling project transcoding on ingest. Premiere exposes no getter for independent verification, so dispatch is reported as requested_unverified.

Inputs: enabled (required). Returns: ok, data, tool, error

set_uniform_scaleSet Uniform ScaleA

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

Inputs: node_id (required), uniform (required). Returns: ok, data, tool, error

setup_duckingSetup DuckingA

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

Inputs: node_id (required), ducking_windows (required), base_db, fade_seconds. Returns: ok, data, tool, error

set_work_areaSet Work AreaB

Set the work area (bar) in and out points

Inputs: in_seconds (required), out_seconds (required). Returns: ok, data, tool, error

set_workspaceSet WorkspaceA

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

Inputs: name (required). Returns: ok, data, tool, error

set_xmp_metadataSet Xmp MetadataA

Merge a raw XMP XML patch into a project item's existing XMP metadata without removing unrelated fields. WARNING: Premiere writes XMP into the source media file on disk (the file's metadata block and modification time change; picture and sound are untouched). Requires the filesystem capability.

Inputs: item_id (required), xmp_xml (required). Returns: ok, data, tool, error

set_zero_pointSet Zero PointB

Set the starting timecode (zero point) of a sequence

Inputs: start_seconds (required), sequence_id. Returns: ok, data, tool, error

slide_editSlide EditA

Perform a verified slide edit on a clip using adjacent clips from the public timeline DOM. Linked audio/video partners get the same edit by default (include_linked); every clip is checked before any is changed. Requires readable finite media and ffprobe duration evidence for every edited source; refuses unknown duration, stills, and nonunit/reversed speed before mutation.

Inputs: node_id (required), offset_seconds (required), include_linked. Returns: ok, data, tool, error

slip_editSlip EditA

Perform a verified slip edit on a clip using public source in/out properties. Requires accessible physical media duration from ffprobe; unknown duration or linked partners using different source files refuse before mutation. Linked audio/video partners get the same edit by default (include_linked); every clip is checked before any is changed.

Inputs: node_id (required), offset_seconds (required), include_linked. Returns: ok, data, tool, error

speed_changeSpeed ChangeA

Unavailable: Premiere's documented ExtendScript and UXP APIs have no setter for a timeline clip's speed (only getters), and the undocumented QE setSpeed is deliberately not used. Always fails before mutation. To change how long a clip runs on the timeline, use set_clip_duration.

Inputs: node_id (required), speed_percent (required), reverse. Returns: ok, data, tool, error

split_clipSplit ClipA

EXPERIMENTAL (undocumented QE DOM): Split every clip on one track that spans a timeline time, then verify both resulting boundaries. Effect-keyframe redistribution remains unverified.

Inputs: time_seconds (required), track_type, track_index. Returns: ok, data, tool, error

stabilize_clipStabilize ClipC

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

Inputs: node_id (required), method, smoothness. Returns: ok, data, tool, error

start_batch_encodeStart Batch EncodeA

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

Returns: ok, data, tool, error

stop_playbackStop PlaybackA

Request that active-sequence timeline playback stop through QE. The legacy API does not provide a same-call playhead readback, so stopped state is not reported as verified. Only the timeline can be stopped: Premiere's scripting APIs have no documented call that stops the Source Monitor alone, so target "source" returns an error instead of stopping the timeline.

Inputs: target. Returns: ok, data, tool, error

toggle_track_visibilityToggle Track VisibilityA

Set video track visibility using Premiere's track mute state (eye icon) and read the mute state back. Premiere's scripting API exposes mute, not a separate video visibility setter.

Inputs: visible (required), track_index (required). Returns: ok, data, tool, error

trim_clipTrim ClipA

Trim exactly one source in/out point and verify the corresponding visible timeline edge. Requires accessible physical media duration from ffprobe; unknown duration or linked partners using different source files refuse before mutation. Refuses retimed clips, extensions that would overlap the neighbouring clip on the same track, and, by default, trims that would leave effect keyframes outside the visible clip. Linked audio/video partners get the same trim by default (include_linked), applied as the same offset from each partner's own source point so a J/L cut or slipped audio stays in sync; every clip is checked before any is changed. To set a clip's timeline length or extend a still image, use set_clip_duration.

Inputs: node_id (required), include_linked, new_in_seconds, keyframe_policy, +1 more. Returns: ok, data, tool, error

undoUndoA

EXPERIMENTAL (undocumented QE DOM: qe.project.undo / undoStackIndex). Undo the most recent Premiere project action(s) through QE, checked step by step against Premiere's undo-stack position (stackVerified; the timeline itself is not read back). Undo history is project-wide. Only actions Premiere records are undoable: QE edits such as razor, insert, lift and extract report undoSteps (and undoStackIndex) in their results; pass that undoSteps as count to reverse exactly that call. A marker receipt with undoTracked:false recorded no undo step: calling Undo for it would reverse an earlier action. Only CEP tool results carry undoSteps; UXP tools and workflows that send several commands are not counted. Always pass expected_undo_stack_index to check the stack position, but matching position alone does not prove which action is on top. Observed marker boundaries refuse the entire request before any step unless acknowledge_untracked_markers:true explicitly permits prior non-marker actions. The barrier persists through server/helper reloads while the CEP engine remains alive; it cannot account for marker writes before observation, after an engine reset, or through UXP, the manual UI, or other clients. Matching the QE index verifies stack position only.

Inputs: expected_undo_stack_index (required), count, acknowledge_untracked_markers. Returns: ok, data, tool, error

unnest_sequenceUnnest SequenceA

Unnest a nested sequence clip, replacing it with the nested sequence's clips at their exact source in/out and timeline positions. Refuses without changing anything when the nest is trimmed, retimed, linked to a partner clip, or when the destination range is occupied or locked. Re-reads every placed clip and reports failure with Undo guidance if any start or source range differs. Nested clips are re-placed from their project items, so effects, keyframes, and transitions inside the nest are not carried over.

Inputs: node_id (required). Returns: ok, data, tool, error

update_markerUpdate MarkerB

Update the name, comments or color of the sequence marker at a time and read them back. EXPERIMENTAL (QE DOM): the receipt reports undoStackIndex movement, which does not prove QE can reverse the marker. Every marker attempt protects an engine undo boundary; undoTracked:false means the marker did not observably advance the QE index.

Inputs: time_seconds (required), name, color, comments. Returns: ok, data, tool, error

validate_cmx3600_edlValidate Cmx3600 EdlA

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

Inputs: path (required), frame_rate. Returns: ok, data, tool, error

validate_export_presetValidate Export PresetB

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

Inputs: preset_path (required). Returns: ok, data, tool, error

validate_mogrt_brand_kitValidate Mogrt Brand KitA
Read-onlyIdempotent

Validate an operator-approved local MOGRT brand kit before using it in a template or batch preview. It never reads font inventories, image pixels, or writes files.

Inputs: brand_kit (required), approved_workspace_path (required). Returns: ok, data, tool, error

validate_platform_publish_packageValidate Platform Publish PackageA
Read-onlyIdempotent

Validate a rendered file plus title, description, hashtags, and content flags against one platform's approximate 2026 publish limits. Returns hard violations, soft warnings, normalized hashtags, and character counts. Local-only; never uploads or changes Premiere.

Inputs: width (required), height (required), platform (required), frame_rate (required), +10 more. Returns: ok, data, tool, error

validate_project_for_exportValidate Project For ExportA
Read-onlyIdempotent

Run a non-mutating export preflight for an active or named sequence. It reports blocking offline media, empty timelines, inaccessible preset/output paths, duration, and optional timeline gaps without queuing an export. readyForExport means these preflight checks passed; it does not test exporter initialization, encoder availability, or whether the host can render. Require an actual output file from export_sequence and verify_delivery_file before claiming delivery.

Inputs: check_gaps, output_path, preset_path, sequence_id, +1 more. Returns: ok, data, tool, error

verify_after_effects_connectionVerify After Effects ConnectionC

Read-only check that the dedicated After Effects CEP connector is running. It never reads project names, media, or paths.

Inputs: no named parameters. Returns: ok, data, tool, error

verify_delivery_conformanceVerify Delivery ConformanceA
Read-onlyIdempotent

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

Inputs: output_path (required), width, height, frame_rate, +13 more. Returns: ok, data, tool, error

verify_delivery_fileVerify Delivery FileA

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

Inputs: output_path (required), expected_checksum, checksum_algorithm, minimum_size_bytes, +1 more. Returns: ok, data, tool, error

verify_fcpxml_media_referencesVerify Fcpxml Media ReferencesA

Verify the file:// media references of an FCPXML or FCP7 XML (xmeml) document, only inside caller-approved existing roots. References outside those roots are never statted or exposed as local paths.

Inputs: path (required), allowed_roots (required). Returns: ok, data, tool, error

verify_mogrt_artifactVerify Mogrt ArtifactA
Read-onlyIdempotent

Verify that a workspace-contained .mogrt artifact exists locally and has a ZIP header. This does not prove controls, import compatibility, playback, or visual correctness.

Inputs: mogrt_path (required), approved_workspace_path (required). Returns: ok, data, tool, error

verify_premiere_connectionVerify Premiere ConnectionA
Read-onlyIdempotent

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

Inputs: backend. Returns: ok, data, tool, error

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 389 tools

    Disambiguation2/5

    With 389 tools there is heavy functional overlap: many near-duplicate read/getters (get_sequence_structure vs get_full_sequence_info vs get_active_sequence vs inspect_sequence_structure), several insertion/edit routes (add_to_timeline, insert_from_source, overwrite_clip, overwrite_from_source, add_to_timeline_batch), and dozens of 'plan_/preview_/review_' tools that blur together. Additionally a large set of tools are explicitly 'Unavailable' (add_text_overlay, apply_lut, speed_change, reverse_clip, nest_clips, set_poster_frame, import_edl, relink_media), which adds further ambiguity about what an agent should actually call.

    Naming Consistency4/5

    Names are overwhelmingly consistent snake_case verb_noun patterns (get_, set_, list_, add_, remove_, create_, delete_, preview_, plan_), and the prefix families (plan_/preview_/review_/inspect_) are used coherently. Minor deviations exist (e.g., speed_change, color_correct, undo/redo as bare verbs) but the convention is largely predictable.

    Tool Count1/5

    389 tools is an extreme mismatch for any coherent surface and far exceeds the 25+ threshold; the breadth guarantees the agent cannot reasonably select among them. Even a rich NLE-automation domain does not justify this many entry points.

    Completeness3/5

    Coverage of the Premiere automation domain is very broad (project, timeline, effects, keyframes, export, captions, markers, review/QC), but several core operations are deliberate dead-ends (masks not supported, speed/reverse unavailable, LUT application impossible, nesting unavailable, EDL import refused). These are notable gaps that agents must work around, though much of the surface is genuinely complete.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to drive a desktop video editor through MCP, providing the same editing operations as the user — placing, trimming, rippling, grading, captioning, and exporting — on the actual project with local rendering.
      8
      GPL 3.0
    • A
      license
      A
      quality
      B
      maintenance
      Enables MCP clients to operate local Adobe Premiere Pro projects, covering media ingest, bins, sequence and timeline editing, transitions, effects, keyframes, captions, markers, metadata, proxies, multicam, color, audio, and exports through 283 discoverable tools, 13 context resources, and 10 guided prompts. A bundled CEP panel provides the supported production bridge, with read-only connection verification and higher-level workflows for assembling product spots and motion-graphics demos.
      5
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP-compatible AI assistants to control Adobe Premiere Pro through natural language, automating project and media management, timeline editing, color and audio adjustments, titles and markers, and batch exports via a local bridge.
      1
      MIT