Premiere-MCP-IMT
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PR_MCP_FACADE | No | Set to `0` to list every operation as its own tool (about 150K tokens of definitions) instead of the nine compact tools. | on |
| PR_MCP_READONLY | No | Set to `true` to enable read-only mode: inspection and exports only, the project cannot change. | off |
| PREMIERE_TEMP_DIR | No | The connector's file mailbox directory. | OS temp |
| PREMIERE_UXP_TOKEN | No | Enables the optional UXP bridge (with the UXP plugin in Premiere) and its `*_uxp` operations. | |
| PR_MCP_ENABLE_SCRIPT | No | Set to `true` to expose `pr_execute_script` (arbitrary ExtendScript). Raw scripting is off by default. | off |
| PREMIERE_MCP_CAPABILITIES | No | Explicit capability profile, e.g. `inspect,edit,export,filesystem`; wins over the switches. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
| extensions | {
"io.github.immersive-media-technologies/premiere-mcp-imt": {
"dualEra": true,
"transports": [
"stdio"
],
"bridgeBackends": [
"cep",
"uxp"
],
"protocolRevision": "2026-07-28"
}
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| pr_catalogA | List Premiere Pro operations available through pr_do. Without |
| pr_doA | Run one Premiere Pro operation by name (see pr_catalog), e.g. {"operation":"add_marker","args":{"time_seconds":1.5,"name":"Intro"}}. Returns the operation result JSON. Writes are verified by readback where Premiere allows it. A result with undoSteps / undoStackIndex can be reverted with the undo operation {expected_undo_stack_index}; property and marker writes record no undo step — checkpoint the sequence before them. Prefer this over writing ExtendScript. |
| pr_batchB | Run several operations in order. Each op: {operation, args}. Stops at the first error when stopOnError (default true). Returns one result per op. |
| pr_verifyA | Read-only check: MCP ↔ Premiere connector ↔ open project ↔ active sequence. Call first in a session. Connector does not answer while Premiere is open → pr_install_connector (status, then install with the user's consent). |
| pr_get_sequenceA | Structure of the active sequence: video/audio tracks with clips (node_id, name, start/end/in/out seconds, enabled, speed). node_id is what every clip operation takes. |
| pr_save_projectA | Save the open project (Cmd+S). Do it before exports and before batches of destructive edits. |
| pr_export_frameA | Export one frame of the active sequence as PNG at |
| pr_install_connectorA | The Premiere side of the bridge (CEP extension MCPBridgeCEP). action=status (default, read-only) says whether it is installed and enabled; action=install copies it into the user's CEP extensions folder and enables unsigned CEP extensions (PlayerDebugMode) — ask the user first. After an install the user must quit and reopen Premiere Pro, then call pr_verify. Use when pr_verify reports that the connector does not answer. |
| pr_skillA | The Premiere agent skill. No |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| premiere-exact-timeline-review | Capture a session-bound tick snapshot, review completeness and source handles, predict a supported edit, preview exact target bindings, apply once, then verify continuity against fresh readback. |
| premiere-scene-source-review | Review measured source candidates, approve exact segments, bind the saved project and source identity, then create verified source markers or audio-inclusive subclips in a new bin. Detector candidates never authorize cuts. |
| premiere-interchange-turnover | Inspect bounded OTIO/XML artifacts and per-feature loss reports, prepare marker or ALE tables, and review an audio-post turnover contract before separately using an available native export. Parsing does not prove editor round-trip fidelity. |
| premiere-temporal-delivery-proof | Preflight a saved exact CEP sequence, directly export to a new destination and independently verify hash, format and optional decoded QC. Use a measured multi-frame oracle for temporal checks; generic encoder events never verify an artifact. |
| premiere-operation-recovery | Inspect recovery receipts and current target state, review a revision-bound acknowledgement, and keep consumed mutation IDs consumed. Cancellation of a local worker never cancels accepted native work. |
| premiere-film-editorial | Capture source and timeline context, supply an explicit film manifest, inspect coverage and review layouts, resolve revision-bound notes and turnover exceptions, then use separately guarded host tools for approved edits and exports. |
| premiere-rough-cut | Inspect the project, import media, create or select a sequence, assemble clips, then verify and save. |
| premiere-project-intake | Inspect a bounded project against an explicit facility template and return a path-redacted intake report and non-mutating organization proposal. |
| premiere-dialogue-cleanup | Inspect audio tracks, normalize dialogue, apply conservative cleanup, and verify levels before saving. |
| premiere-caption-and-style | Inspect the active sequence, create captions, apply styling, verify timing, and save. |
| premiere-delivery | Validate the sequence and destination, export with an explicit preset, then report the produced artifact. |
| premiere-contextual-rough-cut | Capture reusable project context, retrieve only evidence relevant to the edit intent, create a revision-guarded plan, then preview before applying. |
| premiere-transcript-first-context | Capture explicit local transcript and media evidence, compact only the passages relevant to the intent, then review stable evidence IDs and revisions before proposing an edit. |
| premiere-transcript-rough-cut | Export Premiere's native transcript, select revision-locked source ranges, map them to verified 1x placements in a duplicate sequence, then execute the descending cut plan with re-query verification. |
| premiere-metadata-review | Inspect visible Project-panel columns first, then named project/XMP fields. Request full XML only when needed. Writes use field_name/value or complete XML, or a locked UXP field/packet transaction with readback; schema creation does not set per-item values. |
| premiere-project-organization | Capture project context, supply explicit editorial categories, create and preview a review-only organization plan, then use its guarded apply route with stable-ID bin operations. Direct organize_project_items_uxp use is advanced/manual only. |
| premiere-ai-assisted-stringout | Retrieve relevant local evidence, produce a review-only stringout plan, resolve selected project items, then create and verify a new sequence. |
| premiere-caption-artifact-review | Use existing transcript evidence to review a supplied caption artifact, import it deliberately, create a caption track, and verify playback before delivery. |
| premiere-reaction-shorts | Plan stacked speaker-colored captions without guessing unknown speakers, place a mid-video subscribe overlay, export into a series-named folder, then verify review frames before delivery. |
| premiere-platform-cutdown | Capture source-sequence context, propose bounded platform dimensions, review derivative sequence routes, then create and verify each cutdown deliberately. |
| premiere-dialogue-first-cut | Analyze supplied transcript evidence locally, review deterministic candidates, lock source revisions, then create and structurally verify a new ordinary sequence. |
| premiere-podcast-first-cut | Review speaker and synchronization assignments, bind every camera segment to a transcript revision and master-audio range, then create a new ordinary sequence without changing sources. |
| premiere-watched-media-intake | Start a session-scoped local watcher, inspect its path-redacted candidate set, then deliberately import only approved files. |
| premiere-recipe-driven-edit | Select a built-in or workspace-local declarative recipe, review its allowlisted tool manifest, then execute each step through the normal guarded tools. |
| premiere-dialogue-candidate-review | Inspect captured dialogue candidates with words in context, explicitly keep or reject cuts, and review unioned source-time removal before a separate guarded derivative preview. |
| premiere-quote-paper-edit | Order explicitly approved source quotes and return running timings plus an inline spreadsheet-safe CSV before any multi-source host assembly. |
| premiere-batch-copy-review | Compare inspected MOGRT text or supplied caption-artifact copy with literal or proposed changes, preserve original text, and approve exact fields before fresh host readback. |
| premiere-sync-evidence-review | Compare supplied independent offset estimates, resolve conflicts, and explicitly approve camera-recorder matches before a separate host sequence preview. |
| premiere-broll-placement-review | Review caller-proposed footage against dialogue, reasons and alternatives, approve non-overlapping video-only placements, then inspect occupancy in a fresh edit-plan preview. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| premiere-instructions | Instructions and best practices for using Premiere Pro via MCP tools |
| premiere-live-project-info | Bounded, read-only current-project summary with no native paths. |
| premiere-live-project-sequences | Bounded, read-only sequence inventory with stable Premiere IDs. |
| premiere-live-project-media | Bounded, path-redacted media inventory for planning and inspection. |
| premiere-live-project-bins | Bounded, path-redacted bin inventory for project organization planning. |
| premiere-live-active-timeline | Bounded, read-only active-timeline tracks, clips, and markers snapshot. |
| premiere-available-effects | Bounded, read-only effect catalog for planning; no file paths or mutations. |
| premiere-applied-effects | Bounded, read-only component inventory for the active timeline; no file paths. |
| premiere-available-transitions | Bounded, read-only transition catalog for planning; no file paths or mutations. |
| premiere-export-presets | Bounded, read-only export-preset names and formats with native paths withheld. |
| premiere-project-metadata | Read-only path-redacted project and active-timeline summary. Not Premiere project-metadata XML or XMP; use get_metadata parse_fields, manage_metadata_uxp inspect_fields, or inspect_project_panel_metadata_uxp for named clip fields. |
| premiere-workflows | High-level, safety-oriented Premiere Pro workflow catalog |
| premiere-project-context | Revisioned local project-context indexing and retrieval workflow |
| extendscript-reference | Complete Premiere Pro ExtendScript API reference for writing custom scripts via execute_extendscript |
TDQS
Scored across 9 tools
Each tool has a distinct role: discovery (pr_catalog, pr_skill), execution (pr_do, pr_batch), diagnostics (pr_verify, pr_install_connector), and state/IO (pr_get_sequence, pr_save_project, pr_export_frame). Minor overlaps exist — pr_catalog vs pr_skill both serve as documentation entry points, and pr_verify vs pr_install_connector status both probe the bridge — but the descriptions give clear guidance on which to pick.
All tools share the pr_ prefix and most follow a verb_noun pattern (get_sequence, save_project, export_frame, install_connector). pr_do, pr_batch, pr_catalog, pr_skill deviate slightly (bare verb or noun-only), but the set is still highly predictable.
Nine tools is well-scoped for a bridge server whose real operation surface lives behind pr_catalog/pr_do. Each tool earns its place: discovery, single execution, batch execution, diagnostics, readback, persistence, visual verification, connector install, and docs.
The meta-tool set covers the full lifecycle of a bridge session: verify, inspect, edit (via pr_do), batch, save, visually check, and repair the connector. Gaps are minor — there is no tool to enumerate projects or switch the active sequence, and undo exists only as a pr_do operation rather than a first-class tool.