Place an audio file (music, SFX, voiceover) on an audio track at a given time. Imports if needed. Optionally trim with inSeconds/outSeconds.

Detect beats in an audio file and drop a timeline marker on each beat of the active (or given) sequence - so you can cut/edit precisely on the music. Returns how many markers were placed.

Apply a video effect by name (e.g. 'Directional Blur', 'Warp Stabilizer', 'Gaussian Blur') to a clip, via the QE DOM. Experimental. clipIndex is 0-based on the track.

Add a timeline marker to a sequence at a given time (seconds). Optional name, comment and type (comment|chapter|weblink|segmentation).

Place a media clip as an OVERLAY on a higher video track (default V2) with a blend mode (screen|add|overlay|multiply|soft light|...) and opacity - the cinematic way to add light leaks, dust, grain or letterbox elements. Combine with premiere_keyframe to fade the overlay in/out.

Add an animated title to the timeline by importing a Motion Graphics Template (.mogrt) and setting its text. Defaults to Premiere's built-in 'Basic Title'. Place on a video track above your footage. Optional durationSeconds.

Add a video transition (e.g. 'Cross Dissolve', 'Dip to Black', 'Film Dissolve') to a clip's cut, via the QE DOM. Experimental/unsupported but works on PPro 25. clipIndex is 0-based on the track.

Add a Lumetri Color effect to a clip (via QE) and report its parameters. NOTE: setting LUT/.cube and color params via script is version-fragile in Premiere; for a reliable cinematic grade (teal & orange etc.) bake it into the Remotion render instead. Use this to attach Lumetri so you can grade by hand, or pair with premiere_run_extendscript to set specific params.

Make a timestamped backup copy of a .prproj file (copied next to the original as .bak-). Safe, non-destructive.

Automatically cut a set of footage clips to the beat of a music track. Detects beats, builds shots that switch exactly on the beat (every beatsPerCut beats), places trimmed segments on V1, lays the music on A1, and optionally renders it out. Provide a footage folder or explicit clip paths + a music file. Footage is conformed to a 1080p sequence (or 9:16 vertical).

Check whether the in-Premiere bridge panel is installed and whether unsigned CEP extensions are enabled. Read-only.

Run a sequence of safe, read-only checks against the live bridge and report pass/fail per step. Use to verify the whole chain (MCP -> panel -> ExtendScript) is healthy.

Assemble a whole timeline in one shot from a JSON edit-spec: create a sequence, place video clips, add titles (MOGRT), add audio, apply transitions/effects - then optionally render it out. This is the main fully-automatic assembly tool. All asset paths must exist. Returns a per-step report with warnings for any step that failed (the rest still apply).

Close the current project. By default it saves first (save:true). Set save:false to discard - that DISCARDS unsaved changes and therefore requires confirm:true.

Create a new bin (folder) in the project, optionally inside an existing parent bin.

THE flagship: produce a cinematic, broadcast-style brand intro fully automatically. Renders a neon Remotion visual (your M.P brand language) with your title/subtitle, synthesizes a timed sound-design bed (whoosh/impact/riser/sub/ambience), composites it in Premiere, and exports 16:9 and/or 9:16. Requires the Remotion project (a path WITHOUT '!') and the bridge panel. Overwriting outputs needs confirm:true.

Fully automatic cinematic logo/title intro. Creates a sequence, places an animated logo (defaults to the user's M.P logo), overlays a title (and optional subtitle) via MOGRT, adds music, and optionally renders it to a file. Best results come from a PRE-RENDERED animated logo with alpha/own background (Remotion/After Effects output) - Premiere composites + exports. Returns the build report.

Create a new sequence. NOTE: In Premiere Pro 2025, scripting a sequence creation opens Premiere's modal 'New Sequence' dialog (a Premiere limitation) - if a presetPath is given it is offered there; a human confirms it on screen. If nobody confirms, this returns a 'modal dialog' message. Defaults to an HD 1080p 25fps preset. Use premiere_list_sequence_presets to pick another.

Analyze an audio file (any format, via ffmpeg) and return the beat/onset times in seconds, their strength, and an estimated BPM. Use the returned times to cut clips, place keyframes or markers on the beat / bass drops. Read-only (no Premiere needed).

Render/export a sequence to a media file using Premiere's built-in direct exporter (no Adobe Media Encoder needed). This BLOCKS until the render finishes. Provide an output path (in an allowed root) and a preset path from premiere_list_export_presets. Overwriting an existing output requires confirm:true.

Find project items whose name contains the query (case-insensitive). Returns matches with their nodeId, type and tree path. Read-only.

Bring Premiere's main window to the foreground.

Produce a single consolidated, read-only report of the current state: app info, project metadata, all sequences, the active sequence's tracks, and a sample of project items. Great as a first overview.

Return details of the currently active sequence, or null if none is active. Read-only.

Return Premiere's version/build, how many projects are open, whether a project and an active sequence exist, and the preference paths. Read-only.

Ask the in-app host which functions it exposes and report app version, project/sequence state. Good for verifying the bridge end-to-end. Read-only.

Read Premiere's log/diagnostic files (Plugin Loading.log, Debug/Trace databases, logs folder). Returns the tail of each, or the full content of one file if 'file' is given. Read-only.

List Premiere's on-disk preference/profile folders (APPDATA + Documents) and their files. Read-only.

Return Premiere's live preference/scratch paths from the running app via the bridge. For raw on-disk preference files use premiere_get_preference_files.

Return metadata about the currently open project: name, file path, document ID, sequence count, root bin item count and the active sequence. Read-only.

Return the video and audio tracks of a sequence (active one if no id given), with per-clip names and in/out/start/end times. Read-only. Set includeClips:false for a lighter summary.

Import one or more media files (video/audio/image) into the open project, optionally into a named bin. All paths must exist. Warning dialogs are suppressed by default.

Inspect a .prproj WITHOUT opening Premiere: decompress the gzipped XML and report file size, decompressed size, project metadata and approximate counts of sequences/media/clips. Read-only.

Install the CEP bridge panel into Premiere for the current user (no admin): enables unsigned CEP extensions (PlayerDebugMode) and copies the bundled panel to the Adobe CEP extensions folder. After this, RESTART Premiere and open Window > Extensions > Premiere MCP Bridge.

Animate a clip with keyframes for organic, cinematic motion: property scale|opacity|rotation|position. Each key has at (seconds from the clip start), value (number; for position an [x,y] array), and interp (linear|hold|bezier|ease - bezier/ease give smooth ease-in/out). e.g. a push-in: scale 100->112 over 0..duration with ease. VERIFIED scriptable. (Speed ramps / time-remap are NOT reliably scriptable - bake those into the Remotion render.)

Start Adobe Premiere Pro. Optionally open a project by absolute .prproj path. Optionally wait until the bridge panel becomes reachable (the panel must be set to auto-open, or opened once manually).

List Premiere's automatic backup projects (the 'Adobe Premiere Pro Auto-Save' folders). Useful for recovery. Read-only.

List available .epr export presets found on disk (H.264/HEVC/ProRes/AAC etc.), optionally filtered by a name query. Pass one of these 'path' values to premiere_export_sequence. Read-only.

List all markers of a sequence (active one if no id given). Read-only.

List the project's bins and clips (the Project panel tree), flattened with paths. Supports limit/offset paging and optional media paths. Read-only.

List recently used / nearby Premiere projects from the registry (RecoveryOpenProjectInfos) and by scanning the default project folders. Works without Premiere running. Read-only.

List available .sqpreset sequence presets on disk (HD 1080p, UHD, Broadcast, etc.), optionally filtered. Pass a 'path' to premiere_create_sequence for an exact, non-interactive setup. Read-only.

List all sequences in the open project with their IDs, track counts and frame size, and which one is active. Read-only.

Create a new empty .prproj project at the given absolute path. If the file already exists it is gated behind confirm:true and backed up first. The path must be inside an allowed working root.

Create a new sequence WITHOUT any dialog, using a .sqpreset (app.project.newSequence). This is the reliable, fully-automatic way to make a sequence. Defaults to HD 1080p 25fps; pass presetPath (from premiere_list_sequence_presets) for other formats (e.g. 9:16 vertical, 4K).

Open an existing .prproj project in Premiere. Dialogs are suppressed. The file must exist.

Place a media clip on a video track at a given time (seconds). Imports the file if needed. Optionally trim with inSeconds/outSeconds. mode 'overwrite' (default) stamps over; 'insert' ripples later clips right. The clip's own audio is routed automatically.

Gracefully close Premiere by sending its window the close signal. Premiere will show its OWN save prompt if there are unsaved changes (this is intentional and safe). Requires confirm:true. Use force:true only to hard-kill (data loss).

Delete a BIN from the project by nodeId. Irreversible -> requires confirm:true. (Individual clips cannot be deleted via the stable DOM; do that in the Premiere UI.) Get nodeIds from premiere_list_project_items.

Gracefully close Premiere, wait, then start it again (optionally reopening a project). Requires confirm:true. Premiere may show a save prompt during close.

ESCAPE HATCH: run an arbitrary ExtendScript (ES3) snippet inside Premiere and return its value as JSON. EXTREMELY powerful and can do destructive things, so it requires confirm:true to execute. Use dryRun:true (default) to preview the code first. Prefer the dedicated tools when one exists.

EXPERIMENTAL: execute a Premiere menu command by numeric ID via the unsupported QE DOM. Can be unstable/crash-prone -> requires confirm:true. Many actions have dedicated tools; prefer those.

Save the currently open project to its existing file (in place).

Save the open project to a new path. If the target exists it is gated behind confirm:true and backed up first. Path must be inside an allowed working root.

Capture a PNG screenshot of Premiere's main window (or the full screen) so you can SEE the current UI state - useful when a tool reports an unexpected result or a dialog may be open. Returns the image inline plus the saved file path.

ADVANCED FALLBACK: focus Premiere and send keystrokes (Windows SendKeys syntax, e.g. '^s' for Ctrl+S, '%{F4}' for Alt+F4). Use only when no dedicated tool exists. Premiere must be running.

Open/activate a sequence by its sequenceID (from premiere_list_sequences).

Report whether Adobe Premiere Pro is running, whether the in-app MCP bridge panel is reachable, and the app/host version. Always safe to call first.

List Premiere's top-level window titles and whether Premiere is the foreground app. A lightweight way to detect dialogs. Read-only.