{"report":{"v":1,"package":"premiere-pro-mcp","version":"1.30.0","ranAt":"2026-11-16T11:26:15.455Z","install":{"ok":true,"integrity":"sha512-vw/5NdkKdETRAcft8xt4YD1tB0Ua/Fq4HkfKg+E7AF1jEhhLCHeN6L+DahxeK77H68XqTX2qnONeCucCIr4jQw==","deps":11,"scripts":[],"bins":["premiere-pro-mcp"],"license":"MIT","engines":"node >=20.19.0","repository":"git+https://github.com/leancoderkavy/premiere-pro-mcp.git","bin":"premiere-pro-mcp"},"start":{"ok":true,"ms":1655,"serverName":"premiere-pro-mcp","serverVersion":"1.30.0","protocol":"2025-06-18"},"tools":[{"name":"get_project_info","description":"Get information about the currently open Premiere Pro project","params":["expected_project_path","expected_cep_target"]},{"name":"list_project_items","description":"List all items in the project panel (clips, bins, sequences)","params":["bin_path","expected_project_path","expected_cep_target"]},{"name":"list_sequences","description":"List all sequences in the project","params":["expected_project_path","expected_cep_target"]},{"name":"get_active_sequence","description":"Get bounded, paged information about the currently active sequence (50 clips by default). Audio and video clips include source In/Out seconds. Follow pagination.nextOffset for more. Bounded source-alignment diagnostics include separate picture/sound offsets and media-pair group inconsistencies, with limited group context outside this page; they do not verify playback sync.","params":["track_type","track_index","start_seconds","end_seconds","clip_offset","clip_limit","expected_project_path","expected_cep_target"]},{"name":"list_sequence_tracks","description":"List all tracks (video and audio) in a sequence","params":["sequence_id","expected_project_path","expected_cep_target"]},{"name":"get_clip_properties","description":"Get detailed properties of a specific clip by its node ID","params":["node_id","expected_project_path","expected_cep_target"]},{"name":"find_project_item_by_name","description":"Find a project item by name (searches recursively through bins)","params":["name","expected_project_path","expected_cep_target"]},{"name":"get_sequence_settings","description":"Get the settings (resolution, frame rate, etc.) of a sequence","params":["sequence_id","expected_project_path","expected_cep_target"]},{"name":"get_selected_clips","description":"Get the currently selected clips in the active sequence","params":["expected_project_path","expected_cep_target"]},{"name":"get_clip_at_position","description":"Get the clip at a specific time position on a track","params":["time_seconds","track_index","track_type","expected_project_path","expected_cep_target"]},{"name":"save_project","description":"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.","params":["idempotency_key","expected_project_path","expected_cep_target"]},{"name":"save_project_as","description":"Save the current project to a new .prproj path. Existing outputs require overwrite true. 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.","params":["overwrite","path","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"open_project","description":"Open a Premiere Pro project file and make it the active project, verifying it is open. Other open projects stay open.","params":["path","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"set_active_sequence","description":"Set the active sequence by name or ID","params":["sequence_id","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"undo","description":"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.","params":["count","acknowledge_untracked_markers","expected_undo_stack_index","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"consolidate_duplicates","description":"Consolidate duplicate project items and report success only when duplicate media groups decrease.","params":["idempotency_key","expected_project_path","expected_cep_target"]},{"name":"create_project","description":"Create a new Premiere Pro project at the specified path","params":["path","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"close_project","description":"Close an open Premiere Pro project: the active one, or the open project at project_path. Captures the close reply without reading torn-down project objects, then verifies closure and the active project in a separate read-only call. An unreadable verification remains committed_unverified; a native close that never returns remains unknown.","params":["save_first","project_path","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"import_ae_comps","description":"Import After Effects compositions from an .aep file as Dynamic Link clips, failing closed when the file does not exist or when the target bin gains no items. Returns each new item's nodeId and name for placement (add_to_timeline, replace_clip). With comp_names the result is verified only when every requested composition is read back by name and source .aep. Importing all comps verifies the target-bin item-count increase only, because the expected set is unknown; its items list is informational and is omitted when the bin's items cannot be read.","params":["ae_project_path","comp_names","target_bin","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"delete_bin","description":"Delete a bin (folder) and everything inside it from the project panel, and read back that it is gone. Deleting a bin also removes its media's clips from every sequence and deletes sequences stored in the bin, so a bin whose contents are used on a timeline — including a Sequences bin whose media lives elsewhere — is refused unless confirm_remove_from_sequences is true; the refusal lists the sequences and tracks (see find_item_usages). Bins holding offline media are refused unless allow_offline is true.","params":["bin_id","confirm_remove_from_sequences","allow_offline","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"rename_bin","description":"Rename a bin (folder) in the project panel","params":["bin_id","new_name","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"create_smart_bin","description":"Create a smart bin (search bin) and inspect its new identity and name. The stored search query has no getter, so creation reports committed_unverified with identity verification separately.","params":["name","query","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"find_items_by_media_path","description":"Find project items whose media path contains the given search string","params":["path_search","expected_project_path","expected_cep_target"]},{"name":"start_batch_encode","description":"Request Adobe Media Encoder to start the render queue; reports only accepted handoff, not queue progress or output-file creation.","params":["idempotency_key","expected_project_path","expected_cep_target"]},{"name":"add_custom_metadata_field","description":"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.","params":["field_name","field_label","field_type","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"import_sequences","description":"Import sequences from another Premiere Pro project file","params":["project_path","sequence_ids","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"create_bars_and_tone","description":"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.","params":["width","height","timebase","pixel_aspect_numerator","pixel_aspect_denominator","audio_sample_rate","name","bin_id","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"import_fcp_xml","description":"Import a Final Cut Pro XML file. Default mode new_project opens it as a new Premiere project: app.openFCPXML(path, projPath) requires a destination project path, and verified is true only when that destination exists as a file and Premiere has that exact path open. Mode into_open_project instead imports the XML into the currently open project with project.importFiles and succeeds only when the sequence count grew; the XML also brings its own clips, which can duplicate existing items, or Premiere can link them to existing items that point at the same media. That mode reports reusedItems (pre-existing project items and their bins that the new sequences use), so a later bin cleanup does not silently empty the new timelines.","params":["path","project_path","mode","target_bin","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"set_transcode_on_ingest","description":"Request enabling or disabling project transcoding on ingest. Premiere exposes no getter for independent verification, so dispatch is reported as requested_unverified.","params":["enabled","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"get_insertion_bin","description":"Get the current target bin for new imports (the bin that is currently focused in the Project panel)","params":["expected_project_path","expected_cep_target"]},{"name":"get_project_panel_metadata","description":"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.","params":["max_chars","expected_project_path","expected_cep_target"]},{"name":"set_project_panel_metadata","description":"Set the project panel metadata/column configuration from XML and verify that Premiere reads back the exact XML","params":["metadata_xml","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"get_graphics_white_luminance","description":"Get the graphics white luminance value (HDR setting) for the project","params":["expected_project_path","expected_cep_target"]},{"name":"set_graphics_white_luminance","description":"Set the graphics white luminance value (HDR setting) for the project","params":["luminance","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"set_scratch_disk_path","description":"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.","params":["scratch_disk_type","path","save_and_verify","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"import_media","description":"Import media files into the project and confirm a new project item for each file","params":["file_paths","target_bin","suppress_ui","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"import_folder","description":"Import the media files directly inside a folder and read the destination tree back. Refuses an unreadable baseline before importing. Reports observed new media items; unreadable or unmatched imports are committed_unverified. Host errors retain partial-change diagnostics; inspect the destination before retrying.","params":["folder_path","target_bin","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"create_bin","description":"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.","params":["name","parent_bin_id","parent_bin","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"move_item_to_bin","description":"Move a project item to a different bin and confirm where it landed","params":["item_id","target_bin","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"relink_media","description":"Legacy CEP relink can block Premiere indefinitely, even for an existing file on Premiere 26.5.2. Prefer relink_offline_media_uxp, which checks capability and reads the result back. This CEP route refuses by default; allow_unsafe_cep_relink must be explicitly true to attempt it, and its result is never reported as verified.","params":["item_id","new_path","allow_unsafe_cep_relink","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"refresh_media","description":"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.","params":["item_id","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"check_offline_media","description":"Check for offline (missing) media in the project","params":["expected_project_path","expected_cep_target"]},{"name":"set_offline","description":"Set a project item offline, or ask Premiere to refresh it back online when offline is false.","params":["item_id","offline","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"has_proxy","description":"Check if a project item has a proxy attached","params":["item_id","expected_project_path","expected_cep_target"]},{"name":"detach_proxy","description":"Detach/remove the proxy from a project item and read hasProxy back; unavailable readback reports committed_unverified.","params":["item_id","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"set_override_frame_rate","description":"Override the frame rate of a project item (useful for image sequences or misinterpreted media) and read it back","params":["item_id","frame_rate","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"set_override_pixel_aspect_ratio","description":"Override the pixel aspect ratio of a project item and read it back","params":["item_id","numerator","denominator","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"set_scale_to_frame_size","description":"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.","params":["item_id","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"get_item_info","description":"Get detailed type info about a project item (is it a sequence, multicam, merged clip, etc.)","params":["item_id","expected_project_path","expected_cep_target"]},{"name":"select_item","description":"Select a project item and verify its node ID in the current Project-panel selection. Missing or unreadable selection readback remains committed_unverified.","params":["item_id","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"set_start_time","description":"Set the start time (timecode offset) for a project item","params":["item_id","start_seconds","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"create_sequence","description":"Create a new sequence in the project","params":["name","preset_path","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"duplicate_sequence","description":"Duplicate an existing sequence and report the new copy's sequence ID (id) and, when Premiere exposes it, its project item node ID (projectItemNodeId). Project-item tools accept either. Readback verifies identity only; audio track-to-master routing is not verified. When sound is expected, check an export with export_sequence audio_check=expect_signal.","params":["sequence_id","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"delete_sequence","description":"Delete a sequence from the project and read back that it is gone. A sequence nested on another timeline is refused unless confirm_remove_from_sequences is true, matching delete_project_item; deleting it would remove or orphan those nested clips.","params":["sequence_id","confirm_remove_from_sequences","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"set_sequence_settings","description":"Modify and read back sequence frame-size settings.","params":["sequence_id","width","height","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"create_subsequence","description":"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.","params":["ignore_track_targeting","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"auto_reframe_sequence","description":"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.","params":["sequence_id","target_width","target_height","motion_preset","new_name","use_nested_sequences","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"unnest_sequence","description":"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, contains items that also carry the other media type (Premiere's Track.overwriteClip would place that media on the matching track and overwrite the clips there), 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.","params":["node_id","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"create_sequence_from_preset","description":"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.","params":["name","preset_path","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"attach_custom_property","description":"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.","params":["property_id","property_value","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"is_work_area_enabled","description":"Check whether the work area bar is enabled on the active sequence","params":["expected_project_path","expected_cep_target"]},{"name":"get_export_file_extension","description":"Get the export file extension from Premiere. If Premiere returns none, infer it only for an existing .epr whose real filesystem parent is a recognized Adobe Media Encoder format folder; report that resolved preset path. This fallback is unconfirmed and should be checked before delivery.","params":["preset_path","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"add_to_timeline","description":"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).","params":["item_id","track_index","start_seconds","audio_track_index","scope","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"remove_from_timeline","description":"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.","params":["node_id","ripple","include_linked","allow_large_ripple","large_ripple_threshold","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"move_clip","description":"Refuses attached transitions or unreadable transition collections before structural edits; inspect transitionsAffected and use remove_transition first. 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.","params":["node_id","new_start_seconds","new_track_index","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"trim_clip","description":"Refuses attached transitions or unreadable transition collections before structural edits; inspect transitionsAffected and use remove_transition first. 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. Existing host Out padding below one sequence frame may be preserved or reduced, but never used to create additional padding.","params":["node_id","new_in_seconds","new_out_seconds","keyframe_policy","include_linked","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"set_clip_duration","description":"Refuses attached transitions or unreadable transition collections before structural edits; inspect transitionsAffected and use remove_transition first. 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. Existing host Out padding below one sequence frame may be preserved or reduced, but never used to create additional padding. Non-still sources require readable ffprobe duration evidence and a readable sequence frame grid.","params":["node_id","duration_seconds","end_seconds","keyframe_policy","include_linked","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"split_clip","description":"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.","params":["time_seconds","track_index","track_type","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"duplicate_clip","description":"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. High-rate audio above 48 kHz refuses before writing temporary source marks unless its existing marks already match the copy range; native restore diagnostics are pending. Fails without changes when no free track is available; add one with add_tracks.","params":["node_id","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"enable_disable_clip","description":"Enable or disable a clip on the timeline","params":["node_id","enabled","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"set_clip_properties","description":"Set supported clip properties (opacity, scale, position, rotation) and read each requested value back. Position uses pixels by default or explicit normalized 0–1 fractions; an omitted-unit 0–1 pair retains pixels with a warning. Clip speed is unsupported and fails before mutation; use set_clip_duration to change a clip's timeline length.","params":["node_id","opacity","speed","scale","units","position_x","position_y","rotation","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"replace_clip","description":"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. The replacement must carry only the track's media type (for example a still or video-only item on a video track): Premiere's overwrite would also place an item's other media on another track. Checks the replacement accepts the source range before removing anything. 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.","params":["node_id","new_item_id","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"speed_change","description":"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.","params":["node_id","speed_percent","reverse","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"ripple_remove_timeline_ranges","description":"Refuses attached transitions or unreadable transition collections before structural edits; inspect transitionsAffected and use remove_transition first. Preview or apply a single-pass ripple removal for up to 50 sorted, non-overlapping timeline ranges on all unlocked, sync-locked tracks. Requires a preview confirmation token to apply. Integer frame rates only. The preview returns per-track counts and at most 50 planned-clip samples; clips fully inside ranges are removed. Kept pieces cut from one linked audio/video clip are relinked and read back after the move. Large edits need allow_large_ripple: true.","params":["sequence_id","ranges","scope","range_content","dry_run","allow_large_ripple","batch_size","confirmation_token","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"apply_effect","description":"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.","params":["node_id","effect_name","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"apply_audio_effect","description":"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.","params":["node_id","effect_name","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"remove_effect","description":"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.","params":["node_id","effect_index","effect_name","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"list_available_effects","description":"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.","params":["expected_project_path","expected_cep_target"]},{"name":"list_available_audio_effects","description":"List all available audio effects in Premiere Pro. Uses QE DOM.","params":["expected_project_path","expected_cep_target"]},{"name":"color_correct","description":"Apply basic color correction through experimental QE Lumetri insertion. Requires Lumetri component and requested property readback; rendered output is not verified.","params":["node_id","exposure","contrast","highlights","shadows","whites","blacks","temperature","tint","saturation","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"apply_lut","description":"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.","params":["node_id","lut_path","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"inspect_stabilizer_status","description":"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.","params":["node_id","expected_project_path","expected_cep_target"]},{"name":"stabilize_clip","description":"Apply Warp Stabilizer using the experimental QE DOM. Verifies component addition and readable parameter values, never analysis completion. Numeric or unreadable Method popup values remain unverified because no documented label mapping is available.","params":["node_id","smoothness","method","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"remove_transition","description":"Remove one CEP track transition by exact index or a cut contained in its stored span. Uses TrackTransition.remove(false, false), verifies the complete remaining span list, and refuses ambiguous cuts. No QE fallback. Stored geometry only; rendered appearance remains a separate check.","params":["track_type","track_index","transition_index","cut_point_seconds","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"add_transition","description":"EXPERIMENTAL (undocumented QE DOM): Add a video transition between two clips at a cut point. Reads the transition back from the sequence track.","params":["transition_name","track_index","cut_point_seconds","duration_seconds","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"add_transition_to_clip","description":"EXPERIMENTAL (undocumented QE DOM): Add a transition to a specific video clip's start, end, or both edges, then read back the requested placement.","params":["node_id","transition_name","position","duration_seconds","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"batch_add_transitions","description":"EXPERIMENTAL (undocumented QE DOM): Add the same video transition at each eligible cut point on a track and report per-cut readback.","params":["transition_name","track_index","duration_seconds","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"list_available_transitions","description":"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.","params":["expected_project_path","expected_cep_target"]},{"name":"list_available_audio_transitions","description":"EXPERIMENTAL (undocumented QE DOM): List audio transitions. Reports an unavailable or empty legacy catalog as an error rather than an assumed usable list.","params":["expected_project_path","expected_cep_target"]},{"name":"adjust_audio_levels","description":"Adjust a clip's Volume > Level in dB. Does not read or change Essential Sound Amplify automation.","params":["node_id","level_db","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"add_audio_keyframes","description":"Add audio level keyframes to create fades or level changes","params":["node_id","keyframes","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"mute_track","description":"Mute or unmute an audio track","params":["track_index","muted","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"detect_silence","description":"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.","params":["media_path","project_item_id","noise_threshold_db","min_duration_seconds","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"plan_silence_review_markers","description":"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.","params":["media_path","timeline_start_seconds","source_in_seconds","source_out_seconds","noise_threshold_db","min_duration_seconds","max_candidates","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"detect_beats","description":"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.","params":["media_path","max_beats","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"analyze_loudness","description":"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.","params":["media_path","project_item_id","target_lufs","tolerance_lu","max_true_peak_dbfs","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"normalize_loudness_file","description":"Create a new loudness-normalized media derivative with FFmpeg, then remeasure that exact output using EBU R128. When the remeasured file misses the target or true-peak ceiling (AAC encoding can raise the true peak), it renders again with a lowered ceiling or offset target, up to max_attempts, keeps the best attempt and reports every attempt's measured I and TP. Never overwrites the input or an existing output file.","params":["input_path","output_path","target_lufs","max_true_peak_dbfs","tolerance_lu","max_attempts","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"map_source_ranges_to_timeline","description":"Read-only mapping from source-media time ranges to placements on one sequence track. Reads the selected track once, maps only normal-speed forward clips, reports source portions not present on the track as unplaced, and returns bounded pages. This inspects timeline placement; it does not prove rendered or audible content.","params":["sequence_id","track_type","track_index","source_project_item_id","media_path","ranges","range_offset","range_limit","expected_project_path","expected_cep_target"]},{"name":"add_text_overlay","description":"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.","params":["text","start_seconds","duration_seconds","caption_format","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"import_mogrt","description":"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. Placement fields contain observed start/end/track values; requested values are separate, and unreadable geometry remains committed_unverified.","params":["mogrt_path","track_index","start_seconds","duration_seconds","text_values","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"import_mogrt_from_library","description":"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.","params":["library_name","mogrt_name","track_index","start_seconds","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"list_stock_titles","description":"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.","params":["category","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"add_title","description":"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 before import, because Premiere exposes no writable text for them (textVerification 'template_verified'; confirm the render with export_frame). The baked copy path is returned as templateFile and saved under the application support premiere-pro-mcp/titles folder (macOS: ~/Library/Application Support/premiere-pro-mcp/titles). The cache keeps the newest 50 baked copies by modification time; export or copy templates elsewhere if a project needs older copies retained. 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. Optional styling: font_family (PostScript name) and font_size write every text run of each AE text control when the template allows font editing (Premiere 26 fontEditValue/fontSizeEditValue runs, or legacy fontName/fontSize keys); fill_color requires one exposed Fill Color control; position moves the whole graphic through intrinsic normalized Motion Position. Each requested field has styleChecks readback. Premiere-authored font/fill styling and align are refused before import: no reliable writable/readable CEP 26.5.2 contract is established. Tracking is unsupported. Font readback confirms the stored name, not installation or rendered glyphs. Use list_stock_titles to see templates, their kind, and how many lines each takes.","params":["text","lines","font_family","font_size","fill_color","align","position","template","track_index","start_seconds","duration_seconds","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"verify_after_effects_connection","description":"Read-only check that the dedicated After Effects CEP connector is running. It never reads project names, media, or paths.","params":["expected_project_path","expected_cep_target"]},{"name":"preview_mogrt_recipe","description":"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.","params":["recipe","template_name","headline","subtitle","accent_color","text_color","duration_seconds","width","height","frame_rate","approved_workspace_path","output_directory","text_controls","placeholder_media_path","brand_kit","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"create_mogrt_recipe","description":"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.","params":["preview_token","confirm_export","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"verify_mogrt_artifact","description":"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.","params":["approved_workspace_path","mogrt_path","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"validate_mogrt_brand_kit","description":"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.","params":["approved_workspace_path","brand_kit","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"preview_mogrt_batch","description":"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.","params":["approved_workspace_path","output_directory","data_file_path","brand_kit","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"create_mogrt_batch","description":"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.","params":["preview_token","confirm_export","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"inspect_after_effects_template_source","description":"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.","params":["composition_name","expected_project_path","expected_cep_target"]},{"name":"preview_mogrt_library_publish","description":"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.","params":["approved_workspace_path","mogrt_path","library_directory","template_name","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"publish_mogrt_to_library","description":"Publish the exact previewed MOGRT as an immutable local-library version. Requires explicit confirmation and will fail instead of replacing an existing version.","params":["preview_token","confirm_publish","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"inspect_mogrt_library","description":"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.","params":["approved_workspace_path","library_directory","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"inspect_after_effects_render_templates","description":"Read available render and output-module template names from the first existing After Effects render-queue item. After Effects only exposes templates through a queue item, so on an empty queue pass allow_temporary_queue_item: true to add one composition to the queue, read the names and remove it again (requires edit; the queue length is read back unchanged). It never renders.","params":["allow_temporary_queue_item","composition_name","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"preview_after_effects_render","description":"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.","params":["approved_workspace_path","composition_name","output_path","render_settings_template","output_module_template","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"enqueue_after_effects_render","description":"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.","params":["preview_token","confirm_enqueue","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"preview_mogrt_premiere_handoff","description":"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.","params":["approved_workspace_path","mogrt_path","sequence_id","disposable_sequence_name","video_track_index","audio_track_index","start_seconds","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"apply_mogrt_premiere_handoff","description":"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.","params":["preview_token","confirm_import","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"preview_after_effects_render_handoff","description":"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.","params":["approved_workspace_path","output_path","ae_project_path","premiere_project_path","queue_item_index","target_bin_id","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"apply_after_effects_render_handoff","description":"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; the receipt returns the new projectItemId, and replace_clip swaps it in for an existing timeline clip at the same span.","params":["preview_token","confirm_import","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"preview_send_clip_to_after_effects","description":"Preview sending one video timeline clip to After Effects, like Premiere's Replace with After Effects Composition. Reads the clip, its source media and the sequence, and the open saved AE project. Refuses speed-changed, reversed, offline or non-file clips. Lists effects and Motion/Opacity changes on the clip that the swap would not carry over. Changes nothing; returns a ten-minute token for apply_send_clip_to_after_effects.","params":["node_id","ae_project_path","approved_workspace_path","target_bin_id","comp_name","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"apply_send_clip_to_after_effects","description":"Send the previewed clip to After Effects: recheck the clip, add a comp with its exact source range (footage layer audio off) to the open AE project and save it, import the comp into Premiere over Dynamic Link, then replace the clip with it at the same timeline span. The original's linked audio stays. Requires confirmation; the token is single-use. A failure after the AE save leaves the comp in AE and reports where it stopped.","params":["preview_token","confirm_send","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"add_marker","description":"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. Marker start and end storage are compared at exact integer ticks; unsupported time writes remain unverified with the created marker identity when available.","params":["time_seconds","name","comments","color","duration_seconds","node_id","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"delete_marker","description":"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.","params":["time_seconds","node_id","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"update_marker","description":"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.","params":["time_seconds","name","comments","color","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"list_markers","description":"List markers on the active sequence, or on a source project item that exposes a marker collection, including marker GUID and color when readable. A timeline-clip node_id returns a clean error instead of a raw TypeError.","params":["node_id","expected_project_path","expected_cep_target"]},{"name":"add_track","description":"Add verified video or audio tracks to the active sequence. Returns an error if Premiere cannot add the exact requested count.","params":["track_type","count","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"delete_track","description":"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. Caption tracks cannot be deleted (no host API); a caption track_type is refused with the manual route.","params":["track_type","track_index","force","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"lock_track","description":"Set a video track's lock state and read it back to verify the change.","params":["track_index","locked","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"toggle_track_visibility","description":"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.","params":["track_index","visible","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"set_track_states","description":"Set mute, solo and lock on several video or audio tracks of the active sequence in one host command, with per-track readback. Every requested track is read first; if any target is out of range, unreadable or asks for a state this host cannot read and write (solo has no public ExtendScript API and is probed on the QE track), nothing is changed. snapshot: true returns the pre-write state of the same tracks as a restore payload this tool accepts unchanged; with no state fields at all it is a read-only capture.","params":["tracks","snapshot","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"get_playhead_position","description":"Get the current playhead (CTI) position in the active sequence","params":["expected_project_path","expected_cep_target"]},{"name":"set_playhead_position","description":"Set the playhead (CTI) position, clamp it to the active sequence's end, and read the stored position back.","params":["time_seconds","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"set_work_area","description":"Set and verify the work-area points, turning the bar on first through the public Sequence API when it is off. Fails when Premiere leaves the points unchanged (26.5.2 ignores these CEP writes; use the UXP set_work_area there) and turns the bar back off if this call turned it on. Unreadable or partial writes report committed_unverified.","params":["in_seconds","out_seconds","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"get_work_area","description":"Get the current work area in and out points","params":["expected_project_path","expected_cep_target"]},{"name":"set_sequence_in_out_points","description":"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.","params":["in_seconds","out_seconds","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"get_sequence_in_out_points","description":"Get the current sequence in and out points","params":["expected_project_path","expected_cep_target"]},{"name":"get_metadata","description":"Get metadata for a project item. Returns bounded parsed fields by default; GPS, serials, and personal contact/author fields are omitted. Raw packets require explicit include_project_metadata/include_xmp_metadata and include_sensitive true. Media paths require include_media_path true. 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.","params":["item_id","parse_fields","include_sensitive","include_media_path","include_project_metadata","include_xmp_metadata","expected_project_path","expected_cep_target"]},{"name":"set_metadata","description":"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.","params":["item_id","field_name","value","packet","field_namespace","expected_value","metadata_xml","updated_fields","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"set_color_label","description":"Set the color label on a project item or clip and read it back","params":["item_id","color_index","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"get_color_label","description":"Get the color label of a project item","params":["item_id","expected_project_path","expected_cep_target"]},{"name":"get_footage_interpretation","description":"Get footage interpretation settings for a project item","params":["item_id","expected_project_path","expected_cep_target"]},{"name":"set_footage_interpretation","description":"Set footage interpretation settings for a project item and read them back, including fields that were not meant to change","params":["item_id","frame_rate","pixel_aspect_ratio","field_type","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"get_xmp_metadata","description":"Inspect bounded file/clip XMP fields with GPS, serials, author and contact data omitted by default. Raw XMP requires include_raw and include_sensitive true; it can disclose personal data to the connected client. Distinct from Premiere-private project metadata.","params":["item_id","include_raw","include_sensitive","expected_project_path","expected_cep_target"]},{"name":"set_xmp_metadata","description":"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). Each supplied leaf field is compared with host readback (maximum 256); unreadable readback remains committed_unverified. Requires the filesystem capability.","params":["item_id","xmp_xml","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"get_color_space","description":"Get the color space information for a project item","params":["item_id","expected_project_path","expected_cep_target"]},{"name":"validate_export_preset","description":"Validate that an Adobe Media Encoder .epr preset exists and ask the active Premiere sequence which output extension it produces","params":["preset_path","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"verify_delivery_file","description":"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","params":["output_path","checksum_algorithm","expected_checksum","expected_size_bytes","minimum_size_bytes","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"verify_delivery_conformance","description":"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.","params":["output_path","allowed_container_names","video_codec","audio_codec","width","height","frame_rate","frame_rate_tolerance","duration_seconds","duration_tolerance_seconds","minimum_video_bitrate_kbps","maximum_video_bitrate_kbps","audio_sample_rate_hz","audio_channels","target_lufs","loudness_tolerance_lu","maximum_true_peak_dbfs","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"analyze_video_qc","description":"Analyze a local video delivery for sustained black and frozen sections with FFmpeg. Read-only: it does not contact Premiere or modify the file.","params":["media_path","minimum_black_seconds","minimum_freeze_seconds","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"detect_source_scene_changes","description":"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.","params":["media_path","threshold","minimum_interval_seconds","maximum_events","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"export_sequence","description":"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, verifies a non-empty file was written (for an overwrite, that the file changed), and checks its duration with ffprobe within one sequence frame. An unavailable or mismatched duration leaves a written artifact unverified. Optional audio_check reports decoded signal, silence, absent audio or an unavailable check; expect_signal makes a silent or absent stream fail verification. Signal does not establish audibility, sync or sound quality. 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.","params":["output_path","preset_path","range","work_area_only","overwrite","timeout_minutes","audio_check","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"export_frame","description":"Export a file-verified still image. PNG stills keep the sequence's transparency (straight alpha, reported as hasAlpha); composite them over black before measuring brightness or comparing with a video render. A single still does not verify motion over time, playback or audio. After a linked After Effects composition changes, Premiere can return its cached frame for a time it already rendered; to check the change, export a time not exported since the change.","params":["output_path","time_seconds","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"export_sequence_review_frames","description":"Export 2-24 evenly spaced, file-verified frames from an active-sequence range in one bridge round trip for visual review. If Media Encoder still capture cannot restore sequence In/Out, remaining frames are not attempted and the call fails. Still capture does not verify temporal animation, playback, audio, or editorial quality; PNG frames keep the sequence's transparency (straight alpha), so composite them over black before comparing with a video export.","params":["output_dir","frame_count","start_seconds","end_seconds","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"export_sequence_marker_review_frames","description":"Export up to 24 file-verified still frames at active-sequence marker positions in one bridge request for marker-driven review. If Media Encoder still capture cannot restore sequence In/Out, remaining frames are not attempted and the call fails. It reads markers and writes image files only; it does not add, update, or remove Premiere markers.","params":["output_dir","marker_type","start_seconds","end_seconds","limit","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"export_sequence_clip_review_frames","description":"Export one file-verified still frame at the midpoint of each clip on a chosen video track in one bridge request. If Media Encoder still capture cannot restore sequence In/Out, remaining frames are not attempted and the call fails. Read-only in Premiere; it does not mute tracks or claim visual quality.","params":["output_dir","track_index","limit","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"export_as_fcp_xml","description":"Export the active sequence as a Final Cut Pro XML file. Sequences with effects FCP XML cannot represent can make Premiere show a Translation Report modal after writing the XML; dismiss it in Premiere before any queued command can run. Detects the written XML and fresh report if the modal blocks the host. Default wait is 60 minutes for long sequences.","params":["output_path","timeout_minutes","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"export_aaf","description":"Unavailable on the CEP backend. Use export_aaf_uxp with an authenticated Premiere 26.3+ UXP bridge.","params":["output_path","mix_down_video","explode_to_mono","sample_rate","bits_per_sample","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"add_to_render_queue","description":"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.","params":["output_path","preset_path","start_batch","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"export_sequence_job_start","description":"Start an asynchronous Adobe Media Encoder export of the active sequence and return a job id at once, so long renders (such as full episodes) do not hold the MCP call open. Poll get_export_job_status until it reports completed or failed. Requires a saved project, an .epr preset_path (Same as Project presets are refused), an existing output folder, and an output_path with no file yet (existing files are always refused; AME may otherwise rename or overwrite). The output extension must match the preset; a missing extension is added. range follows export_sequence: in_to_out and work_area fail closed instead of encoding the whole timeline. start_batch (default true) asks AME to start every ready queue job, including unrelated ones. Success means AME accepted the job (committed_unverified); render completion and the file are verified later by get_export_job_status. Jobs are tracked only by this server process.","params":["output_path","preset_path","range","start_batch","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"get_export_job_status","description":"Read the status of an export job started by export_sequence_job_start: queued, encoding (with AME-reported progress when events arrive), finalizing, completed, failed, cancelled, or unknown. Evidence is reported separately: Adobe Media Encoder job events recorded inside Premiere's ExtendScript engine, and Node-side observation of the output file (exists, non-empty, size and modification time unchanged across stability_window_ms and since the previous poll). completed is verified only when AME reported completion, the file is stable and non-empty, and ffprobe confirms its duration within one frame; without an AME completion event a stable file is reported as completed but unverified. Jobs started by an earlier server process report unknown (server_restarted). Read-only: it never starts, cancels, or retries a render.","params":["job_id","stability_window_ms","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"get_render_queue_status","description":"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.","params":["expected_project_path","expected_cep_target"]},{"name":"create_subclip","description":"Create a subclip from a project item with in/out points (seconds from the start of the file, even when the media carries a start timecode). Returns the new item's nodeId and reads its stored range back from Premiere project metadata: outcome verified when each observed in/out point is within half a media frame (or audio sample) of the request, so a whole-frame miss is committed_unverified. Points are snapped to the nearest media frame and sent a quarter frame past it so Premiere stores that frame. A media start timecode is reported as mediaStartSeconds.","params":["item_id","name","in_seconds","out_seconds","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"capture_frame","description":"Capture the current frame and return it as inline image data for the LLM to see. This supports still-image review only. The PNG keeps the sequence's transparency (hasAlpha); transparent areas may display as white or a checkerboard rather than the black a video render shows.","params":["time_seconds","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"export_omf","description":"Export the active sequence as an OMF file (Open Media Framework, for audio post-production). Long sequences can use a longer wait (default 60 minutes); if Premiere writes the file but times out, the receipt includes its size as committed_unverified.","params":["output_path","sample_rate","bits_per_sample","audio_encapsulated","audio_file_format","trim_audio_files","handle_frames","include_pan","timeout_minutes","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"encode_project_item","description":"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.","params":["item_id","output_path","preset_path","remove_on_completion","start_batch","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"encode_file","description":"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.","params":["input_path","output_path","preset_path","in_seconds","out_seconds","remove_on_completion","start_batch","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"manage_proxies","description":"Create or attach proxies for a project item, or set Premiere's proxy display. 'toggle' is application-wide, not per item: it changes app.getEnableProxies()/setEnableProxies() for every sequence and monitor, and item_id is only checked to exist. Pass enabled: true or false to set a known state; omitting enabled flips the current state, so two calls undo each other. The result reports previousEnabled and proxiesEnabled read back from Premiere. 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.","params":["item_id","action","proxy_path","output_path","preset_path","start_batch","enabled","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"inspect_media_streams","description":"Inspect a local media file with ffprobe and return container, stream, codec, time-base, channel, and chapter metadata. Read-only and independent of Premiere.","params":["media_path","use_cache","analysis_revision","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"generate_media_contact_sheet","description":"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.","params":["media_path","output_path","columns","rows","thumbnail_width","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"detect_audio_transients","description":"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.","params":["media_path","threshold_dbfs","minimum_interval_seconds","maximum_events","use_cache","analysis_revision","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"detect_motion_peaks","description":"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.","params":["media_path","sample_seconds","samples_per_second","threshold","minimum_interval_seconds","maximum_events","use_cache","analysis_revision","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"read_video_scopes","description":"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.","params":["media_path","time_seconds","use_cache","analysis_revision","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"plan_shot_match","description":"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.","params":["reference_media_path","target_media_path","reference_time_seconds","target_time_seconds","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"analyze_video_interlacing","description":"Classify decoded video frames as progressive, top-field-first, bottom-field-first, mixed, or undetermined using FFmpeg idet. Read-only delivery preflight.","params":["media_path","sample_seconds","use_cache","analysis_revision","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"detect_active_picture_bounds","description":"Detect the most frequent active-picture crop rectangle in decoded video, exposing probable letterbox or pillarbox bars without modifying the source.","params":["media_path","sample_seconds","limit","use_cache","analysis_revision","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"inspect_cmx3600_edl","description":"Parse a local CMX 3600 EDL into bounded event, reel, track, transition, and timecode facts without importing it into Premiere.","params":["path","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"validate_cmx3600_edl","description":"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.","params":["path","frame_rate","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"compare_cmx3600_edls","description":"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.","params":["before_path","after_path","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"inspect_fcpxml_interchange","description":"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.","params":["path","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"verify_fcpxml_media_references","description":"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.","params":["path","allowed_roots","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"ripple_delete","description":"Refuses attached transitions or unreadable transition collections before structural edits; inspect transitionsAffected and use remove_transition first. 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.","params":["node_id","scope","range_content","dry_run","allow_large_ripple","large_ripple_threshold","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"roll_edit","description":"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. Existing host Out padding below one sequence frame may be preserved or reduced, but never used to create additional padding.","params":["node_id","offset_seconds","include_linked","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"slide_edit","description":"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. Existing host Out padding below one sequence frame may be preserved or reduced, but never used to create additional padding.","params":["node_id","offset_seconds","include_linked","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"slip_edit","description":"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. Existing host Out padding below one sequence frame may be preserved or reduced, but never used to create additional padding.","params":["node_id","offset_seconds","include_linked","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"move_clip_to_track","description":"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.","params":["node_id","target_track_index","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"remove_all_effects","description":"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.","params":["node_id","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"set_clip_speed_qe","description":"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.","params":["node_id","speed_percent","reverse","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"reverse_clip","description":"Unavailable: Premiere does not expose a supported scripting API for reversing a timeline clip's playback direction.","params":["node_id","reverse","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"set_frame_blend","description":"Request frame blending on a clip through QE DOM. Premiere exposes no frame-blend readback, so the result is committed_unverified and must be checked in Effect Controls.","params":["node_id","enabled","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"set_time_interpolation","description":"Request time interpolation for a clip (Frame Sampling, Frame Blending, Optical Flow) through QE DOM. Premiere exposes no interpolation readback, so the result is committed_unverified and must be checked in Effect Controls.","params":["node_id","interpolation_type","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"rename_clip","description":"Rename a clip on the timeline and verify the new name.","params":["node_id","new_name","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"get_clip_speed","description":"Get the playback speed and reverse state of a clip","params":["node_id","expected_project_path","expected_cep_target"]},{"name":"set_clip_selection","description":"Select or deselect a clip in the active sequence and read its selection state back.","params":["node_id","selected","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"link_selection","description":"Link the currently selected video and audio clips in the active sequence, then read the links back. Needs at least two selected clips; verified only when every selected clip is linked to every other.","params":["idempotency_key","expected_project_path","expected_cep_target"]},{"name":"unlink_selection","description":"Unlink the currently selected video and audio clips in the active sequence, then read the links back. Premiere only unlinks when every clip of a linked group is selected, so a selection missing a linked partner is refused before anything changes.","params":["idempotency_key","expected_project_path","expected_cep_target"]},{"name":"overwrite_clip","description":"Overwrite a project item onto validated timeline tracks and verify a new source placement at the requested time. Every video/audio stream the item actually has must land on the requested tracks; a picture-only or sound-only placement (for example 5.1 audio that does not fit a stereo track) is committed_unverified, not verified. Video-only and audio-only items overwrite only the receiving track, so Sequence.overwriteClip cannot smash V0 or A0 for the unused kind. When Premiere moves the source In to a sequence frame (an audio subclip cut between frames), the receipt reports sourceInShift and a note. slip_edit snaps to whole sequence frames, so it cannot correct a shift smaller than one frame.","params":["item_id","start_seconds","track_index","audio_track_index","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"create_sequence_from_clips","description":"Create a new sequence from project items, then verify its registered identity, name and source-item placements. clipCount reports observed track items; requestedClipCount reports requested source items.","params":["name","item_ids","idempotency_key","expected_project_path","expected_cep_target"]},{"name":"close_sequence","description":"Request closing a sequence timeline tab. Premiere exposes no open-tab enumeration, so dispatch is requested_unverified; the sequence stays in the project.","params":["sequence_id","idempotency_key","expected_project_path","expected_cep_target"]}],"toolsHash":"fe5517438e8861d6c5d59e41ad911b46334ad21bd910e019d564df9bc78d9c35","wrote":["/tmp/premiere-mcp-bridge/helpers_27479c7b4c70.jsx","/tmp/premiere-mcp-bridge/cmd_83c96599-0b25-48a4-8321-5c52479ebc18.jsx","/tmp/premiere-mcp-bridge/.host-owner-lease/owner.json"],"callsAt":"2026-11-16T11:26:22.333Z","calls":[{"tool":"get_project_info","ok":false,"ms":15002,"bytes":0,"error":"tools/call timed out after 15000 ms"},{"tool":"list_project_items","ok":false,"ms":15002,"bytes":0,"error":"tools/call timed out after 15000 ms"}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":[],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[],"tools":200,"wrote":3,"callsTried":2,"callsAnswered":0,"callContacts":[]},"history":[{"package":"premiere-pro-mcp","version":"1.30.0","ranAt":"2026-11-16T11:26:15.455Z","outcome":"started","tools":200,"contacts":0,"flags":0,"serious":0,"toolsHash":"fe5517438e8861d6c5d59e41ad911b46334ad21bd910e019d564df9bc78d9c35"}],"page":"https://bragproof.smaverk.com/r/premiere-pro-mcp"}