# Higgsfield Premiere Pro MCP

Local MCP server for inspecting and editing Adobe Premiere Pro projects. Supports
media import, bins, sequences, timeline clips, track controls and video export.

## Requirements

- Node.js 24 or later.
- Adobe Premiere Pro and Creative Cloud installed on the same computer as the MCP client.
- Tested on macOS with Premiere Pro 26.5.1. Windows support is experimental.

## Installation

```sh
npm install --global @higgsfield_org/premiere-mcp
fnf-premiere doctor
fnf-premiere install-bridge
fnf-premiere config
```

The package includes a signed CEP extension. `install-bridge` installs it using
Adobe's installer and verifies its version. Save open projects and restart
Premiere once after installation or a bridge update. No visible panel or pairing
is needed; the extension starts with Premiere.

Add the server entry printed by `config` to your MCP client's configuration,
preserving existing entries. It uses absolute Node and server paths. Reconnect
the client after registration. `config` does not change client settings itself.

Once Premiere has finished starting, check the connection:

```sh
fnf-premiere probe
```

The stdio executable is `fnf-premiere-mcp`. New client sessions reuse the installed
bridge. No developer mode, signing tools or certificates are required by users.

## Tools

| Tool                 | Purpose                                                     |
| -------------------- | ----------------------------------------------------------- |
| `pr_document_info`   | Inspect the active project.                                 |
| `pr_catalog`         | List 26 operations and retrieve exact argument schemas.     |
| `pr_do`              | Execute a catalog operation.                                |
| `pr_guide`           | Read editing and targeting instructions.                    |
| `pr_get_skill`       | Index and read bundled Premiere workflows and references.   |
| `pr_get_skill_asset` | Resolve a bundled asset or script to a verified local path. |
| `pr_status`          | Inspect local connection state.                             |

Call `pr_get_skill` without arguments to discover any specialized workflows in
the installed version; an empty index means use `pr_guide`. Asset paths returned
by `pr_get_skill_asset` exist on this computer only. Reading a skill does not
prove Premiere is connected or that every described operation is supported.

Use the active project path and unique sequence names. Refresh clip indexes,
names and start times after timeline edits. Time values are seconds. Sequence
creation requires a local `.sqpreset`; export requires a local `.epr` preset.
Save/export requires a new absolute path. Save As changes the active project path.
Set `ADOBE_MCP_READONLY=1` in the server environment to disable mutations and exports.

## Troubleshooting and limits

`doctor` checks local prerequisites; `probe` reads Premiere. Verify a tool call
in the MCP client after registration.

- `SIGNED_BRIDGE_MISSING`: reinstall a complete published package.
- `BRIDGE_OFFLINE`: open Premiere and wait for startup; restart after installing the bridge.
- `BRIDGE_VERSION_MISMATCH`: run this package's `install-bridge` and restart Premiere.
- `BUSY` or uncertain completion: a call may still be running. Inspect Premiere before
  recovering `~/.higgsfield-adobe/premiere-native/call.lock`; never blindly replay edits.

Calls are serialized and claimed requests are not replayed after a restart.
Native errors may leave partial changes; edits are not transactions. The bridge
uses the default configuration directory; a custom `ADOBE_MCP_CONFIG_DIR` is unsupported.

Direct export waits for the native exporter. Adobe Media Encoder mode reports job
submission, not completed encoding. Inspect the resulting media independently.
Effects, keyframes, captions, transitions, inline previews and nested-bin traversal
are not supported.