Validate Project For Export
validate_project_for_exportRead-onlyIdempotent
Run a non-mutating export preflight on a sequence to catch blocking offline media, empty timelines, inaccessible preset or output paths, and optional gaps before queuing an export.
Instructions
Run a non-mutating export preflight for an active or named sequence. It reports blocking offline media, empty timelines, inaccessible preset/output paths, duration, and optional timeline gaps without queuing an export. readyForExport means these preflight checks passed; it does not test exporter initialization, encoder availability, or whether the host can render. Require an actual output file from export_sequence and verify_delivery_file before claiming delivery.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "validate_project_for_export"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gap_limit | No | Maximum per-track gaps to return when per_track_gaps is true (default 200). | |
| check_gaps | No | Report gaps on populated tracks as warnings (defaults to true). | |
| gap_offset | No | Zero-based offset into the optional per-track gap list (default 0). | |
| output_path | No | Optional intended delivery path; its parent folder is checked. | |
| preset_path | No | Optional .epr preset path to check. | |
| sequence_id | No | Sequence ID or name. Defaults to the active sequence. | |
| per_track_gaps | No | Include the per-track gap list in a bounded page (default false); composite black/dead-air checks remain available without it. | |
| idempotency_key | No | Optional client-chosen key (1-128 chars of A-Z a-z 0-9 . _ : -) for this intended edit. Pass a fresh key per edit and reuse it only when retrying that same edit, for example after a client-side timeout. A repeat with the same tool, key and arguments is not run again: while the first call is running it fails with IDEMPOTENCY_IN_PROGRESS (poll get_last_operations); after it finished it returns the original outcome marked replayed. A definite failure with nothing applied (receipt outcome not_applied) may be retried with the same key. Reusing a key with different arguments fails with IDEMPOTENCY_KEY_REUSED. Scoped to this MCP session (the stdio server process, or the HTTP server process when Streamable HTTP is stateless per request) and held in memory only (200 keys, 1 hour); it does not survive a restart or reconnect. Read-only invocations are never deduplicated. | |
| expected_cep_target | No | Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard. | |
| expected_project_path | No | Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior. | |
| require_non_empty_timeline | No | Treat an empty sequence as a blocking error (defaults to true). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | Whether the tool completed successfully. | |
| data | No | Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it. | |
| tool | Yes | The registered MCP tool name. | |
| error | No | Failure detail when ok is false. | |
| receipt | No | Versioned common mutation receipt; success never implies rendered verification. | |
| idempotency | No | Present when idempotency_key deduplicated this call: replayed is true when the original outcome was returned instead of running again. |