> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP tools reference

> The tool families an agent uses to edit your CoClip project, with a sample prompt for each.

An agent edits your project through the CoClip MCP server. Every agent gets the same tools, in the [AI dock](/docs/ai-agents/ai-dock.md) and [outside the editor](/docs/ai-agents/outside-the-editor.md). You do not call tools yourself: you ask in plain words, and the agent picks the tools.

This page lists the tool families in the order agents see them, with each family's tool names and one prompt to try. The exact list can change between CoClip releases. To see the tools your version has, run `/mcp` in Claude Code.

> [!TIP]
>
> In Claude Code the tools show with a prefix, for example `mcp__coclip__clip_add`. The name after the prefix is the one listed here.

## Tool families

| Family | What it does | Tools | Try asking |
| - | - | - | - |
| Project | Create, open, read and validate a project. | `project_create`, `project_open`, `project_get`, `project_validate`, `project_schema` | "Open my project and tell me what is on the timeline." |
| Clip script | Read and write the clip script, line by line. | `script_get`, `script_set`, `script_edit_line` | "Write a clip script for a 30-second tips video from my notes." |
| Media | Import, rename, relink, inspect and remove media in the Library. | `media_import`, `media_remove`, `media_remove_unused`, `media_rename`, `media_relink`, `media_inspect`, `media_list` | "Import every video in my Downloads folder and list them." |
| Timeline | Add tracks; place, move, trim, split, delete and frame clips. | `track_add`, `track_reorder`, `track_remove_empty`, `track_compact_lanes`, `clip_add`, `clip_move`, `clip_move_many`, `clip_trim`, `clip_split`, `clip_delete`, `timeline_ripple`, `clip_extend_to_source`, `clip_replace_asset`, `clip_set_transform`, `clip_set_framing`, `clip_set_transform_many` | "Split the intro clip at 3 seconds and delete the first part." |
| Timing | Change clip speed, project frame rate and canvas size. | `clip_set_speed`, `canvas_set_fps`, `canvas_set_size` | "Make this clip play at 1.5× speed." |
| Text and styles | Insert and edit text; create and apply text styles. | `text_insert`, `text_update`, `style_create`, `style_update`, `style_apply` | "Add a title "3 mistakes beginners make" at the top for 4 seconds." |
| Fonts | List the fonts CoClip has and add one to the project. | `font_list`, `font_use` | "Use a rounded bold font that supports Vietnamese for the titles." |
| Google Fonts | Search, download and preview Google Fonts. | `font_search`, `font_download`, `font_preview` | "Find three handwritten Google Fonts and show me a preview." |
| Text templates | Save a text look as a template and apply it again. | `template_save`, `template_apply` | "Save this title as a template and use it for every section title." |
| Captions | Store transcripts, find words, make and edit captions. | `transcript_set`, `transcript_find`, `captions_from_transcript`, `captions_edit_word`, `captions_retime` | "Make captions from the voice-over and highlight the key words." |
| Effects | Audio levels and fades, transitions, keyframes, zooms, extract and restore audio. | `audio_set`, `transition_set`, `transition_list`, `transition_apply`, `keyframe_set`, `zoom_from_events`, `fx_delete`, `clip_extract_audio`, `clip_restore_audio` | "Add a soft transition at every cut on the main video track." |
| Camera | Add or change camera moves over the tracks below. | `camera_set` | "Slowly zoom in on the chart between 10 and 14 seconds." |
| Filters | List colour looks and add or change filters. | `filter_list`, `filter_add`, `filter_update` | "Give the whole video a warm film look." |
| Preview and export | Preview frames, take an editor screenshot, start, follow and cancel exports. | `preview_frame`, `editor_screenshot`, `export_start`, `export_status`, `export_cancel` | "Show me a contact sheet of the first 10 seconds." |
| Audio mix | Measure loudness and check voice against music. | `audio_mix_check`, `audio_measure` | "Check that the music never drowns out the voice." |
| Layout | Check overlaps, small text, off-screen items and safe zones without rendering. | `layout_check` | "Check the layout for TikTok safe zones and fix any problems." |
| History | List edits, undo and redo. | `history_list`, `history_undo`, `history_redo` | "Undo my last edit." |
| Selection | Read what you selected on the timeline. | `selection_get` | "Make the selected clips 20% quieter." |
| Automation | Apply many edits at once, cut ranges, find silences and scene changes, transcribe speech. | `commands_apply`, `clip_remove_ranges`, `audio_detect_silence`, `media_detect_scenes`, `transcript_generate` | "Find the silences in my recording and cut them out." |
| Voice and music | Generate and check voice-overs, pronunciation dictionaries and music through your connectors. | `connectors_list`, `tts_voices`, `tts_generate`, `tts_generate_script`, `tts_verify`, `tts_dictionary_create`, `tts_dictionary_add_rules`, `music_plan`, `music_generate`, `jobs_wait` | "Generate a voice-over for every script line with my usual voice." |
| Sound effects | Search, generate, place and check sound effects on visual cues. | `sfx_search`, `sfx_generate`, `sfx_insert`, `visual_cues`, `sfx_check` | "Add a whoosh on every title entrance." |
| Image and video generation | List models and generate images or short video clips. | `media_models`, `image_generate`, `video_generate` | "Generate a background image of a night city skyline in 9:16." |
| Elements and widgets | Browse the element catalog, insert and edit elements, build Threads stories. | `widget_types`, `widget_insert`, `widget_update`, `template_thread_story`, `template_thread_story_update` | "Add a bar chart comparing the three prices at 0:12." |
| Custom elements | Draw an element off the timeline, define, read and remove custom elements. | `element_render`, `element_define`, `element_remove`, `element_source` | "Make a custom progress ring element in my brand colours." |
| Element list | List the custom elements of a project and their state. | `element_list` | "Which custom elements does this project have?" |
| Element presets | List, save, apply and delete your saved element looks. | `element_preset_list`, `element_preset_save`, `element_preset_apply`, `element_preset_delete` | "Save this lower third as a preset called "Guest name"." |
| Stickers | Browse and insert stickers. | `sticker_list`, `sticker_insert` | "Add a thumbs-up sticker when I say "great"." |
| Graphics | Draw HTML or SVG as a transparent image. | `graphic_render` | "Draw a sticky note that says "Tip #1" in the top corner." |
| Maps | Look up the countries and Vietnamese provinces a satellite map can show. | `map_places` | "Show a satellite map that flies from Vietnam to Đà Nẵng." |
| Reference videos | Import and analyse reference videos, read and update blueprints, build a project skeleton. | `reference_import`, `reference_list`, `reference_analyze`, `reference_frames`, `reference_blueprint`, `reference_blueprint_update`, `blueprint_to_project` | "Analyse this reference video and tell me why its hook works." |
| Brand kits | Create, read, edit, link and apply brand kits. | `brand_list`, `brand_get`, `brand_create`, `brand_update`, `brand_delete`, `brand_link`, `brand_apply` | "Apply my brand kit to this project." |
| Video check | Check a rendered video for flicker, black and frozen frames. | `video_check` | "Check the exported video for black or frozen frames." |
| Motion preview | Render a short silent low-resolution draft to check motion. | `preview_motion` | "Render a motion draft of the intro so I can check the timing." |
| Parallel build | Coordinate helper agents that build sections at the same time. | `parallel_build` | "The script is approved: build all four sections in parallel." |
| Sprites | Draw a set of SVG sprites in one shared look. | `sprite_render` | "Draw five flat icons for the steps: idea, plan, build, test, launch." |

## What the tools never do

* **Export without you.** The CoClip skills tell the agent to ask you before it starts an export. Exports and preview frames always render in the visible editor window, never in the background.
* **Ask for API keys.** Voice, music, image and sound tools use the keys you saved in **Settings** → **Connectors**. If a key is missing, the agent tells you which **Settings** step to open. See [Connectors](/docs/reference/connectors.md).
* **Spend paid credits silently.** When a generation would cost more than a set limit, the agent asks you first.
* **Change locked tracks without telling you.** An agent can still edit a locked track, but it is told to tell you when it does.
* **Run untrusted code.** A custom element the agent writes is not drawn until you trust it in the editor.

Every edit is recorded in the **AI log** and can be undone. See [AI log and undo](/docs/ai-agents/ai-log-and-undo.md).

## Related pages

* [Example prompts](/docs/ai-agents/example-prompts.md)
* [Skills and agent roles](/docs/ai-agents/skills-and-agents.md)
* [Troubleshooting](/docs/reference/troubleshooting.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.