Preview Mogrt Recipe
preview_mogrt_recipePreview a bounded MOGRT recipe from the title, callout, quote, social, and media-placeholder template library, validating one existing workspace output directory without contacting Adobe or writing files.
Instructions
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.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| width | No | Composition width from 320 to 7680 pixels; defaults to 1920. | |
| height | No | Composition height from 240 to 4320 pixels; defaults to 1080. | |
| recipe | No | Supported authored template recipe; defaults to lower_third. | |
| headline | Yes | Primary headline text, at most 160 characters. Required for text recipes; optional caption for media_placeholder. | |
| subtitle | No | Optional secondary lower-third text, at most 160 characters. | |
| brand_kit | No | Optional approved local brand kit. It can constrain naming, request an installed font, place a workspace-contained PNG/JPEG logo, and enforce a safe margin. | |
| frame_rate | No | Composition frame rate; defaults to 30. | |
| text_color | No | Optional text color as #RRGGBB; defaults to #FFFFFF. | |
| accent_color | No | Optional accent fill color as #RRGGBB; defaults to #2563EB. | |
| template_name | Yes | Safe template file stem; the generated artifact is template_name.mogrt. | |
| text_controls | No | full (default) also exposes per-text-layer Font Size, Fill Color, Stroke Color, Stroke Width, Position, Scale, Rotation, Anchor Point, and Opacity controls; text_only exposes only the text strings. | |
| 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 one HTTP session) and held in memory only (200 keys, 1 hour); it does not survive a restart or reconnect. Read-only invocations are never deduplicated. | |
| duration_seconds | No | Composition duration between 2 and 30 seconds; defaults to 5. | |
| output_directory | Yes | Existing absolute output directory inside approved_workspace_path; this workflow never creates directories. | |
| 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. | |
| placeholder_media_path | No | Required for media_placeholder: absolute workspace-contained PNG, JPEG, MOV, or MP4 placed as the swappable Essential Graphics media slot. | |
| approved_workspace_path | Yes | Absolute operator-approved workspace root containing the saved AE project and output directory. |
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. |