{"id":"io.clueso/video","slug":"io-clueso-video","title":"Clueso","description":"Make videos and docs with your AI agent — describe what you need, every output stays editable.","version":"1.0.2","publisher":{"kind":"domain","id":"clueso.io","label":"clueso.io","url":"https://clueso.io"},"website":"https://help.clueso.io/mcp-setup","repository":"https://github.com/clueso-ai/clueso-mcp","remotes":[{"type":"streamable-http","url":"https://connect.clueso.io/mcp"}],"packages":[],"published":"2026-08-19","updated":"2026-08-19","status":"online","auth":"","latency_ms":1202,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"get_design_guide","title":"Get design guide","description":"Clueso's design guide, the HTML animation pages guide and the Director's skills. Ask for everything you need in ONE call. Each select entry is a section path or plain words; words search all three and return the best few, each labelled with the path that selects it exactly.\n\n  get_design_guide({select: ['gist', 'styles.kinetic-type', 'motion.*', 'stagger from the centre']})\n\nPaths: 'gist' (the des","read_only":true},{"name":"read_animation","title":"Read an HTML animation","description":"Read an HTML animation's page site (index.html, CSS, JS) like a repository. Read-only.\n\n  • project_id alone → this project's animations, with which element shows which revision.\n  • element_id (+ project_id) or animation → the summary: pages with their parameters, actions and cues; files; revisions and labelled versions; probe verdict and checks; where it is used.\n  • path → numbered lines (\"N| \"","read_only":true},{"name":"edit_animation","title":"Edit an HTML animation","description":"Change an HTML animation's site: ONE revision, linted, checked and probed. A passing save with project_id moves that project's uses; a failing one is kept but moves nothing; your next edit continues from it. Saves return a contact sheet (preview: false skips it); preview: true | {filmstrip, video, test} renders the moved element in place (dry run: unsaved page).\n\nSend changes against your copy (se","read_only":false},{"name":"create_project","title":"Create project","description":"Create a new blank Clueso project. Returns the projectId and initialClipId — the project starts with one blank clip already at index 0 (default short duration). Use update_clips to resize/retitle clip 0, add_clips(kind='blank') to append more clips, add_elements to place content, and add_audio to attach a project-level music track.\n\nOptionally place the project inside a folder (use find(type='fold","read_only":false},{"name":"update_project","title":"Update project","description":"Update a project's metadata: rename, change description, move to a different folder, or change aspect ratio.\n\nOnly fields you provide are changed. To move a project to the workspace root, pass folder_id=\"\" (or \"root\").\n\nAspect ratio: pass any \"W:H\" (positive integers). The canvas is fit inside\n1920×1080 keeping the ratio, so element pixel coordinates use the resulting\ncanvas. Common values:\n- \"16:","read_only":false},{"name":"duplicate_project","title":"Duplicate project","description":"Clone an entire project — every clip, voiceover, asset, and metadata field — into a fresh project. The copy has its own S3 namespace, so changes or deletions to the source never affect the duplicate.\n\nDefaults:\n- new_title omitted → \"{source title} (copy)\" when no folder_id is given (or it's empty) and the source stays in the same org; pass an explicit non-empty folder_id and the title is preserve","read_only":false},{"name":"export_project","title":"Export project","description":"Export the project as a video. Exports spend the workspace's export minutes\n(the user's paid allowance), so only export when the user asked for one, never as a\nstep of your own (to get audio or a merged file, say).\n\nTwo calls. The first starts nothing: it returns what the export costs, the minutes\nleft, and a confirm_token. Tell the user the cost and ask; once they say yes, call\nagain with the sam","read_only":false},{"name":"get_export","title":"Get export status","description":"Read a project's video export: its status and, once done, its link. Call it when the user asks for the link or the status, not to wait on an export you just started (the user gets that in the editor's Exports tab, so start it, say so, and stop). Pass exactly one of `export_id` (the one export_project returned) or `project_id` (that project's most recently REQUESTED export, which may still be in pr","read_only":true},{"name":"get_media_job","title":"Get a media job's result","description":"Fetch the outcome of a media job (an article GIF, a frame grab) that did not finish inline: the tool that started it returned { job_id, status: \"processing\" }. Waits for it rather than returning immediately, so one call is usually enough — set `wait_seconds` to how long you are willing to hold.\n\nReturns { job_id, status, created_at, completed_at?, result?, error? }. `status` is processing, complet","read_only":true},{"name":"get_recording_activity","title":"Get Recording Activity","description":"Status of this workspace's auto-recordings, and how many recording generations this billing cycle has used. The same view as the Recordings page in the Clueso app. Returns { usage, rows, total, truncated }.\n\n`usage` is { cycle_start, cycle_end, generations_used, generations_limit (null: no cap), active_recordings, active_recordings_limit }. Each row is one project with its latest recording's `stat","read_only":true},{"name":"get_usage","title":"Get Usage","description":"AI credits and export minutes left for the user in this workspace, and the plan. Call it only when the user asks about credits, limits or export minutes. Returns { credits, export_minutes, plan, cycle_ends_at }.\n\n`credits` is { left (what the user can spend now), personal ({ allowance, used } for this cycle, when the workspace gives members an allowance), workspace_left, resets_at }. `export_minut","read_only":true},{"name":"get_embed","title":"Get embed URL","description":"Get a project's embeddable video player: `embed_url` (permanent) and `embed_code` (a ready-to-paste <iframe>, the same snippet the editor's Share → Embed copies). Use it to put a Clueso video in a website, help center or LMS lesson.\n\nReturns { project_id, published, embed_url?, embed_code?, latest_publish? }.\n  • published=false — the project has never been published as an embed. Call export_proje","read_only":true},{"name":"create_folder","title":"Create folder","description":"Create a folder in the workspace, optionally inside another folder, to organize projects.\n\nReturns { folder_id, name, parent_folder_id, already_existed }. If a folder with the same name (case-insensitive) already exists in that parent, it is returned with already_existed=true instead of creating a duplicate — so it is safe to call to \"ensure\" a folder exists.\n\nPut projects in it with create_projec","read_only":false},{"name":"find","title":"Find resources","description":"Find any resource by `type`; filter by `query` (name substring unless noted) or exact `id`. Returns {type, count, items: [{id, name, type, ...}]} (+ total, has_more for projects/folders); pass ids straight to the consuming tool. Any `duration` is in SECONDS (= add_audio source_duration).\n\n- projects | folders | workspaces | backgrounds.\n- tags: project tags (color, project_count; apply with update","read_only":true},{"name":"switch_workspace","title":"Switch active workspace","description":"Switch the active workspace. The choice sticks for this client until you change it again — including across reconnects — so every later call operates in the new workspace. Use find(type='workspaces') to see available options.","read_only":false},{"name":"report_feedback","title":"Report MCP feedback","description":"Report a problem with this MCP to the Clueso team, with a proposed fix. The team reads every report and ships fixes from them.\n\nCall it, then carry on with the user's task, when:\n- a tool errored, or returned something wrong or surprising;\n- no tool could do what the task needed, or you had to work around a limitation (many calls for one thing, a worse result than asked);\n- a tool's name, paramete","read_only":false},{"name":"get_project","title":"Get project data","description":"Get a summary of a project: canvas dimensions, per-clip summary (ids, indices, durations, element counts, voiceover_volume), and `audio_tracks` — every music/SFX entry on the project flattened to the same wire shape `add_audio` accepts (id, src, name, source_duration, guide_start_time/end_time, music_start_time/end_time, volume, loop, fade_in, fade_out). To copy an audio track to another project: ","read_only":true},{"name":"get_clip","title":"Get clip details","description":"Read one clip: elements (canvas px), voiceover (text, voice, duration, voiceover_volume), background, transition (null if none). Three independent axes:\n- `select` shapes the JSON. Full reads are large (word timings and type_data dominate); ask only for what you need.\n- `element_ids` picks which element rows (e.g. element_ids: ['el_9'], select: ['elements.x','elements.y']).\n- `render` returns a PN","read_only":true},{"name":"update_clips","title":"Update clips (batch)","description":"Update clips in ONE call (always batch): background, transition, duration, title, hidden, position, voiceover_volume, video_styling (video clips), after_clip, subtitle_settings.\n\n- duration: sets the clip's length WITHOUT rescaling anything (unlike generating speech, which rescales the whole clip). A shrink clamps every end_time past the new end to it; a grow carries an element that ended at the o","read_only":false},{"name":"remove_clip","title":"Remove clip","description":"Remove a clip from the project by index. Cannot remove the last remaining clip.\n\nInteractive links to the removed clip are cleared: any button, question/results logic or form that jumped to it now continues, and a clip whose end action jumped to it plays the next clip.\n\nAfter removal, all clips with index > clip_index shift down by 1. When removing multiple clips by index, remove from highest inde","read_only":false},{"name":"split_clip","title":"Split clip","description":"Split a video clip into two clips at the given timestamp. The left clip keeps the original clip ID; the right clip gets a new ID and is inserted immediately after. Elements spanning the split point are duplicated into both clips with adjusted timing. Exception: a question, results card, form, or any element with a clickaction stays whole in the left clip (trimmed to end at the split), so it is nev","read_only":false},{"name":"captions","title":"Edit captions","description":"Read and edit a clip's CAPTIONS (subtitles) — what they say, where one caption ends and the next begins, when each shows, captions not tied to the voiceover, and translation. Captions are built from the clip's voiceover words: each caption is a run of words, addressed by its `start_word_index`.\n\nStart with action=\"list\" on the clip — it returns `blocks` (voiceover captions: start_word_index, end_w","read_only":false},{"name":"duplicate_clip","title":"Duplicate a clip","description":"Clone one clip — within the same project, or **from another project** — into a target project.\n\n- Same project: pass `target_project_id` and `source_clip_id` (omit `source_project_id`).\n- Cross-project: pass `target_project_id`, `source_project_id`, `source_clip_id`. The source clip's S3 assets (voiceover audio, original video footage, generated video, etc.) are re-hosted into the target guide's S","read_only":false},{"name":"add_clips","title":"Add clips to project","description":"Create new clips on a project. One tool, four sources:\n\n- kind=\"blank\": empty slide clips you'll populate with add_elements / generate_media. Pass `clips: [{title?, duration?}, ...]`. Note: create_project already creates clip 0; calling with N blank entries gives N+1 clips total.\n- kind=\"pptx\": extract slides from an uploaded .ppt/.pptx. Pass `mcp_upload_id` (from upload_file), optional `slide_ind","read_only":false},{"name":"get_element_schema","title":"Get element schema","description":"Return the schema for an element type's type_data, as TypeScript declarations. Call this before add_elements / update_elements when you don't already know the field shape for the element_type you're placing.\n\nBy default it is compact: every field with its type and a one-line note, plus the keyframable list. Ask about specific properties with `fields: ['background_setting']` or `query: 'pill backgr","read_only":true},{"name":"add_elements","title":"Add elements to clips","description":"Add elements to one or more clips in ONE call (always batch). Items apply in order; one result per item (partial success ok). type_data shape: get_element_schema.\n\n- `defaults`: hoist what repeats (clip_index, element_type, font_setting, alignment…); items carry only what differs. `returning` shapes the reply.\n- Native elements by default (editable, translatable); compute boxes and keyframes in ru","read_only":false},{"name":"update_elements","title":"Update elements","description":"Update elements across one or more clips in ONE call (always batch). Items apply in order; partial success ok. clip_index not needed (element_id is project-unique).\n\n- Per item: position/timing fields, and/or type_data with element_type (settable fields: get_element_schema mode 'update'). `defaults` hoists shared keys; `returning` shapes the reply ([] = counts + errors).\n- Keyframes: top-level `ke","read_only":false},{"name":"remove_elements","title":"Remove elements from clips","description":"Remove many elements across one or more clips in a single tool call. One entry per element ({clip_index, element_id}).\n\nConcurrency: parallel-safe (conflict domain: the individual element) — same as update_elements. Each removal is a granular element_remove patch scoped to that element id, and the whole batch lands in ONE save. Fan out across subagents as long as they touch DIFFERENT element ids. ","read_only":false},{"name":"reorder_elements","title":"Reorder elements within a clip","description":"Reorder the elements inside a clip. List position IS the z-index — later entries in `ordered_element_ids` render on top of earlier ones.\n\nYou MUST pass the full set of element IDs currently in the clip. The handler rejects partial lists so a reorder can never silently drop an element. Get the current list via get_clip — the order it returns is exactly the order this takes.\n\nWorks on grouped clips.","read_only":false},{"name":"update_groups","title":"Update groups","description":"Transform, keyframe, rename, nest or lock GROUPS. A group moves, scales, rotates and fades as ONE unit without touching children's stored positions: a camera push instead of building the layout twice.\n\n- Address by `group_id` (from get_clip select:['groups'], or returned by add_elements/update_elements with `group`), never by name; an unknown id is an error. No add_groups: create a group by adding","read_only":false},{"name":"remove_from_project","title":"Remove element, group or audio track","description":"Remove an element, a group or an audio track from a project.\n- target=\"element\": removes an element (requires element_id, or element_ids for several). clip_index is optional — the element is located by id; pass it only as a hint\n- target=\"group\": removes a GROUP node (requires clip_index + group_id). By default its children survive — they rise to the removed group's own parent, which for a top-lev","read_only":false},{"name":"add_audio","title":"Add audio track","description":"Add a music track or sound effect that plays as a project-level audio layer over all clips. Does NOT consume a clip slot. Use this for background music or a soundtrack that should play under the existing timeline. Sound for an HTML animation goes here, not in its page: guide_start_time = the element's start + the cue's t. (For inserting an audio file as its own sequential clip with auto-transcript","read_only":false},{"name":"update_audio","title":"Update an existing audio track","description":"Mutate fields on an existing music/SFX track by id. Read existing tracks via `get_project.audio_tracks` — the per-entry shape there matches this tool's args, so you can flip a knob (volume, fades, timing, loop) and write it back without losing the track's id.\n\nOnly fields you pass are changed; omitted fields are preserved. To delete a track entirely, use `remove_from_project(target='audio')` inste","read_only":false},{"name":"extract_audio","title":"Extract a clip's audio onto its own layer","description":"The editor's \"Extract Audio\": a clip's own audio — the recording's sound on a video clip, or its generated voiceover — becomes a separate audio track (returns music_id), and the clip goes silent.\n\n- The track starts where the clip starts and plays at normal speed. Shape it with update_audio (trim music_start_time / music_end_time, move guide_start_time, fade, volume); analyze_audio(file_url=<its s","read_only":false},{"name":"voiceover_batch","title":"Set voiceover scripts","description":"Set voiceover text and/or generate speech for many clips in ONE call. Per entry: \"set_text\" (clip_index + text), \"generate_speech\" (async TTS; wait: true blocks until it lands), \"set_and_generate\" (both). Entries apply in order, one result each; all text lands in one save, TTS runs async per clip after.\n\n- Address by clip_index, or clip_id (survives inserts/reorders); never both needed.\n- Text: [e","read_only":false},{"name":"auto_sync","title":"Auto-generate sync points","description":"Run the agentic auto-sync pipeline on a clip with a source recording: detects natural sync points (UI changes, narrated steps) and inserts sync-marker nodes into its transcript. Required before voiceover TTS on video clips (clueso://docs/sync-points).\n\nSkips (no run): \"audio_extracted\" (read-only transcript); \"clip_busy\" + held_by (retry later); \"clip_too_long\" + {clip_id, duration_label} (trimmed","read_only":false},{"name":"add_sync_point","title":"Add a sync point at a word + timestamp","description":"Insert one sync marker on a clip's transcript.\n\nUse this when:\n- The user is explicit about WHERE the camera should pause / cut (e.g. \"sync the word 'submit' to 4.2s of the demo\").\n- `auto_sync` ran but missed a step you care about.\n\nHow matching works:\n- `word`: case-insensitive, punctuation-stripped. The first match in the transcript is used unless `occurrence > 1`.\n- `occurrence`: 1-indexed — p","read_only":false},{"name":"upload_file","title":"Upload file","description":"Upload files to Clueso. Pick a mode by client and where the file lives:\n- `files` (ChatGPT only): the user's attachments, filled by ChatGPT; pass them instead of asking for a re-upload.\n- `file_name` (default for agents/scripts: Claude Code, Cursor, Claude Desktop): returns an upload URL on Clueso's own domain (not S3; works where cloud storage is blocked) + a ready curl that PUTs one local file; ","read_only":false},{"name":"check_uploads","title":"Check upload status","description":"Fetch all files the user uploaded via the hosted upload page. Returns one mcp_upload_id per file — pass each to the appropriate tool (add_clips, add_article_media, etc.). Call this once after the user confirms they are done uploading; the token covers all files they dropped on the page.","read_only":true},{"name":"generate_media","title":"Generate AI media (image or animation)","description":"Generate an AI image or a canvas-code-based animation directly into a clip.\n\n- kind=\"image\": text-to-image. Pass `prompt`. Optional: `animation_setting` (entry/exit — set it HERE, see below), `style_id` (from find type='image_gen_style_packs'), `reference_image_url` or `mcp_upload_id` for image-to-image grounding.\n\n- kind=\"animation\": canvas-code animation rendered from a prompt. Pass `prompt`. Op","read_only":false},{"name":"analyze_audio","title":"Analyze audio","description":"Analyze an audio file. Modes:\n- transcript: Speech-to-text with word-level timestamps — returns `{language, full_text, words}` where each word is `{word, start_ms, end_ms, punctuated_word}`. ⚠ MILLISECONDS here; get_clip's `voiceover_words` gives the same words in SECONDS as `{word, start, end}`. Use for caption timing, script editing, or word-level visual sync. Works on narration and on sung lyri","read_only":true},{"name":"get_article","title":"Get article","description":"Get the article content as markdown. Screenshots appear as <SCREENSHOT {id}> placeholders, and things markdown can't show (an embedded video, a pasted image) as <EMBED {id}> placeholders. Returns the markdown text, a list of screenshot IDs and the article_version to pass to update_article.","read_only":true},{"name":"update_article","title":"Update article","description":"Update article text content from markdown. Use <SCREENSHOT {id}> placeholders to position screenshots.\nScreenshots in the markdown are kept. Screenshots removed from markdown are deleted. Order in markdown defines final order. Keep each <EMBED {id}> placeholder unchanged, or what it stands for is deleted.\nGet the current article first with get_article, modify the markdown, then call this with the ","read_only":false},{"name":"add_article_media","title":"Add article media (image or GIF)","description":"Add a screenshot or GIF to the article. It goes right after the block holding the screenshot named in `after` (\"start\" for the top), in place of the screenshot named in `replace`, or else at the end of the article. Returns its screenshot_id (it appears in the article as `<SCREENSHOT screenshot_id>`) and the new article_version.\n\n- kind=\"image\": one of `timestamp` (capture a frame from the project'","read_only":false},{"name":"update_article_media","title":"Update or inspect article media","description":"Update an article image/GIF (screenshot), or inspect its current state.\n- Provide one or more of `zoom_factor`, `crop`, `shapes` to change metadata.\n- Pass `render=true` (with no other updates) to fetch the current details without mutating.\n\nTo DELETE an article image/GIF: call `update_article` with markdown that omits the `<SCREENSHOT id>` reference. Unreferenced media is pruned server-side on sa","read_only":false},{"name":"create_clueprint","title":"Create clueprint","description":"Create a new clueprint (reusable video template). A clueprint is a structured file directory with design notes, composition rules, and screenshots that can be used to generate videos.\n\nUse human-readable folder categories: design/ (colors, typography, backgrounds, animation), rules/ (composition, voiceover, editing), screenshots/ (rendered clip previews). See the \"Creating Clueprints\" section in t","read_only":false},{"name":"get_clueprint","title":"Get clueprint","description":"Fetch clueprint data. Use `include` to control how much you pull back:\n- include=\"metadata\": just the clueprint's name/description/tags/visibility/thumbnail.\n- include=\"tree\": metadata + the full file tree (path, mime_type, and size per entry). Call this first when exploring an unfamiliar clueprint.\n- include=\"files\": the contents of the files listed in `file_paths` (no metadata — call include='tr","read_only":true},{"name":"update_clueprint","title":"Update clueprint","description":"Update a clueprint's metadata and/or file contents in one call.\n\nMetadata fields (`name`, `description`, `tags`, `visibility`, `thumbnail_path`) are applied as a patch — only the fields you pass change. Pass at least one to update metadata.\n\n`files` is a list of file mutations:\n- Write text: `{ path, content }`\n- Write binary: `{ path, content, encoding: \"base64\" }`\n- Write from URL: `{ path, sour","read_only":false},{"name":"manage_brand_kit","title":"Manage brand kit","description":"Create and change the workspace's brand kits (editors and admins). The same operations as the brand kit page, so a kit made here looks the same there.\n\nActions:\n- \"create\": a kit from `url` (reads the site's logos, colors, fonts and icons; company details are researched in the background and land in about a minute), or blank with clearly marked placeholders. `name` is optional.\n- \"preview_fill\": w","read_only":false},{"name":"set_voice","title":"Set voice","description":"Set the voiceover voice for every clip in a project, or only for the clips in `clip_ids`.\n\nUse this to apply a clueprint's voice (read `voiceover.voice.name` and `voiceover.voice.engine` from the clueprint source data), or to switch all clips to a specific voice in one call. When the user names specific clips, pass their ids in `clip_ids` so the other clips keep their voice. The voice is looked up","read_only":false},{"name":"pronunciation","title":"Pronunciation dictionary","description":"Read and edit the workspace pronunciation dictionary (Settings → Team → Pronunciation Dictionary). Use it whenever the user asks how a word, name or acronym is said. Do NOT respell the word in the voiceover script instead: the respelling shows in the script and captions, and every new video needs the fix again.\n\nAn entry is WORKSPACE-WIDE: it changes the word in every video in this workspace; tell","read_only":false},{"name":"translation_glossary","title":"Translation glossary and rules","description":"Read and edit the workspace's translation glossary and translation rules (Settings → Translation). Every translation in the workspace follows them: captions translate, translated videos and articles. Use it when the user says how a term must be translated, that a product or brand name must stay untranslated, or how translations into a language should read (tone, formality). Do NOT hand-edit transl","read_only":false},{"name":"add_comment","title":"Add comment","description":"Post a review comment on a project, attributed to \"Clueso AI\".\n\nUse this to leave feedback, suggestions, or notes — either at the project level (no clip_id) or pinned to a specific clip with an optional timestamp inside that clip.\n\nPass `parent_comment_id` to REPLY to an existing comment rather than open a new thread. Read what is already there with `get_comments` first: answering a reviewer in th","read_only":false},{"name":"get_comments","title":"Get comments","description":"Read the review comments on a project — the other half of `add_comment`, which could post but never read.\n\nComments are how a human reviewer tells you what is wrong with a video: a note pinned to a clip and a moment inside it. Read them before an editing pass so you act on what was actually asked for, and read them again after a build if a reviewer has seen it.\n\nThreads come back nested: each top-","read_only":true},{"name":"record_screen","title":"Record screen","description":"Records the product on a mock (Code record) as a screen-recording clip in a project.\nCreates blank placeholder clips, registers job entities, and sends the job to AVS.\n\nThe blank clips this tool creates are placeholders; they become video clips\nwhen processing completes, so removing one loses that scene. Article placeholders are also inserted\nautomatically into plainDoc.\n\nCheck how the recording i","read_only":false},{"name":"run_script","title":"Run a script that calls these tools","description":"Run a JavaScript program that calls this server's tools: loops, math, values carried between calls, one round trip. Use it whenever code says it more directly than separate calls (often). COMPUTE rather than hand-type literals: eased keyframe tracks, staggers, grids, palettes, positions from measured text.\n\nSTDLIB (loaded): anim (interpolate, spring, stagger, cues), ease, math, vec, rng, noise, co","read_only":false},{"name":"get_script_job","title":"Get a script job's result","description":"Fetch the outcome of a run_script that did not finish inline. Waits for it rather than returning immediately, so one call is usually enough — set `wait_seconds` to how long you are willing to hold.\n\nReturns { job_id, status, result?, error? }. `status` is processing, completed or failed; `result` carries the same { ok, result, stdout, ops } the inline reply would have. The script runs to completio","read_only":true}],"server_info":{"name":"clueso-connect","version":"1.0.0"},"category":"image-video","tags":["audio-voice","project","news"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":151834,"score":100,"indexable":true,"first_seen":"2026-08-19","stars":0,"badges":["official"],"sponsor":null,"page":"https://agentsindex.org/agents/io-clueso-video/"}