Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_libraries | Get all open libraries in Final Cut Pro with their names, IDs, file paths, and event counts. |
| get_events | Get all events within a specific library. |
| get_projects | Get all projects within a specific event, including sequence/timeline details (duration, frame rate, timecode format). |
| new_library | Create a new library in Final Cut Pro. |
| new_event | Create a new event in the current library. |
| new_project | Create a new project. Opens the new project dialog. |
| close_library | Close the current library. |
| project_properties | Open the project properties/settings inspector. |
| playback | Control playback in Final Cut Pro. |
| navigate | Navigate through the timeline. |
| set_playback_speed | Set the playback speed/rate. |
| go_to_timecode | Navigate to a specific timecode position. Opens the timecode entry dialog and types the timecode. |
| blade | Blade (cut/split) clips at the playhead position. |
| edit_insert | Perform an edit insertion into the timeline. |
| delete_selection | Delete selected clips or replace with a gap. |
| clipboard | Clipboard operations (copy, cut, paste). |
| selection | Selection operations. |
| undo_redo | Undo or redo the last action. |
| trim | Trim clip edges. |
| nudge | Nudge selected clip(s) in a direction. |
| insert_placeholder | Insert a placeholder or gap clip into the timeline. |
| create_compound_clip | Create a compound clip from the current selection. |
| create_storyline | Create a connected storyline from selection, or collapse/lift storyline clips. |
| change_duration | Open the change duration dialog to set a specific clip or selection duration via timecode. |
| rename_clip | Rename the selected clip. |
| add_transition | Add the default cross dissolve transition to the selected edit point(s). |
| add_effect | Add a default effect to the selected clip(s). |
| add_color_correction | Add a color correction effect to the selected clip. |
| add_title | Add a title to the timeline. |
| manage_effects | Copy, paste, or remove effects and attributes on clips. |
| add_mask | Add a mask to the selected clip. |
| retime | Change the speed/retiming of the selected clip. |
| retime_quality | Set the video quality for retimed clips. |
| show_retime_editor | Toggle the retime editor in the timeline. |
| add_marker | Add a marker at the current playhead position. |
| delete_markers | Delete markers. |
| rate_clip | Rate the selected clip(s). |
| add_keyword | Apply a keyword group (1-9) to the selected clip(s). Keyword groups are pre-configured in FCP's keyword editor. |
| set_role | Set the role of the selected clip. |
| open_keyword_editor | Open the keyword editor panel. |
| captions | Caption operations. |
| select_tool | Switch to a specific editing tool. |
| toggle_snapping | Toggle timeline snapping on/off. |
| adjust_volume | Adjust audio volume of the selected clip. |
| solo | Solo or unsolo the selected clip(s) audio. |
| audio_operations | Audio-specific operations. |
| toggle_panel | Show or hide various panels and browsers in the FCP interface. |
| zoom_timeline | Zoom the timeline view. |
| window_layout | Switch to a predefined window layout. |
| go_to_panel | Navigate focus to a specific panel. |
| color_channels | Change the viewer color channel display. |
| clip_appearance | Change the clip appearance in the timeline. |
| import_media | Open the import media dialog in Final Cut Pro. |
| import_xml | Import an FCPXML file into Final Cut Pro. |
| export_xml | Export the current project/event as FCPXML. |
| import_captions | Import a captions file (SRT, SCC, ITT, etc.). |
| export_captions | Export captions from the current project. |
| share | Share/export the project using the default destination or send to Compressor. |
| render | Render the timeline. |
| reveal_in_finder | Reveal the selected clip's source media file in Finder. |
| transcode_media | Open the transcode media dialog for the selected clips. |
| consolidate_files | Consolidate media files for the selected items. |
| relink_files | Relink media files. |
| analyze_and_fix | Run analyze and fix on the selected clips. |
| synchronize_clips | Synchronize selected clips (align audio/video from multiple sources). |
| switch_angle | Switch to a specific angle in a multicam clip. |
| create_multicam_clip | Create a multicam clip from the selected clips. |
| av_edit_mode | Set the audio/video edit mode to control which components are affected by edits. |
| color_board | Control the color board for color grading. |
| generate_fcpxml | Generate FCPXML content for creating timeline structures programmatically. Generates valid FCPXML 1.11 that can be imported into FCP. Use this to create projects with clips, transitions, titles, and effects defined in XML. |
| execute_menu_command | Execute any Final Cut Pro command by navigating the menu bar. Provide the menu path as an array (e.g., ['File', 'New', 'Project...'] or ['Edit', 'Paste as Connected']). |
| send_shortcut | Send a keyboard shortcut to Final Cut Pro. Use this for any command that has a keyboard shortcut. |
| find | Open the Find dialog, or Find and Replace in title text. |
| auto_reframe | Apply Auto Reframe to the selected clip to automatically adjust framing for different aspect ratios. |
| object_tracking | AI-powered object tracking and segmentation mask controls. Uses neural network-based tracking to follow objects across frames. |
| cinematic_editor | Control the AI-powered Cinematic mode editor for iPhone Cinematic video. Navigate between AI focus/framing decisions. |
| detect_beats | AI-powered automatic beat detection and beat grid for music/audio clips. Analyzes audio to find beat positions. |
| voiceover | Voice-over recording controls. Open the recording panel and start/stop recording. |
| compare_frame | Compare frame/viewer for before-and-after comparison of color corrections and effects. Save a reference frame and compare side-by-side. |
| spatial_video | Controls for 360°, VR, and spatial video editing. Includes stereoscopic viewing modes, 360° navigation, and field of view adjustments. The 360° viewer must be open for navigation controls. |
| adjustment_layer | Add an adjustment layer (adjustment clip) above the current clip. Adjustment layers apply effects to all clips beneath them in the timeline. |
| keyframes | Keyframe animation controls for effects, transforms, and audio parameters. |
| variants | Variant (audition) controls for comparing different versions of clips. Create alternate clip versions and preview them before committing. |
| duplicate_detection | Find and manage duplicate clips in the browser/timeline. |
| effect_presets | Save and manage effect presets for color corrections, video effects, and audio effects. |
| detach_audio | Detach audio from the selected video clip, creating separate audio and video clips in the timeline. |
| merge_clips | Merge adjacent selected clips into a single clip. |
| break_apart_clip | Break apart a compound clip or multicam clip into its individual component clips. |
| speed_editor | Advanced speed editing tools for creating speed ramps and custom speed segments. |
| snapshot_project | Create a snapshot (backup) of the current project state. The snapshot is saved as a duplicate within the event. |
| image_playground | Open Apple's AI-powered Image Playground for generating and editing images within Final Cut Pro. |
| video_output | Toggle external video output (A/V Output) for monitoring on external displays, broadcast monitors, or HDMI devices. |
| custom_overlay | Toggle the custom overlay display in the viewer (title safe, action safe zones, etc.). |
| anchored_storyline | Create and manage anchored storyline spines for organizing connected clips. |
| timeline_history | Navigate timeline hierarchy levels when editing inside compound clips, multicam clips, or auditions. |
| color_correction_nav | Navigate between color corrections on a clip and apply corrections from previous clips. |
| match_color | Match the color of the selected clip to a reference clip for consistent color grading across scenes. |
| audio_fade_management | Advanced audio fade controls for managing fade handles and crossfades. |
| duplicate_project | Duplicate the current project, optionally with different settings (resolution, frame rate, color space, etc.). |
| transcribe_to_captions | Use AI to automatically transcribe audio in the selected clips to captions/subtitles. Requires macOS speech recognition. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |