{"$schema":"https://verifymcp.io/schemas/trust-report.json","schemaVersion":1,"license":{"name":"CC BY-NC 4.0","url":"https://creativecommons.org/licenses/by-nc/4.0/"},"generatedAt":"2026-11-22T00:28:03.971Z","url":"https://verifymcp.io/servers/mhbxyz-kdenlive-mcp/mcp-kdenlive","markdownUrl":"https://verifymcp.io/servers/mhbxyz-kdenlive-mcp/mcp-kdenlive.md","server":{"slug":"mhbxyz-kdenlive-mcp","name":"Kdenlive","registryName":"io.github.mhbxyz/kdenlive-mcp","description":"Inspect, edit and render Kdenlive video projects locally on Linux.","registryStatus":"active","deletedAt":null,"statusMessage":null,"liveness":"live","publisher":{"class":"unknown","claimed":false}},"component":{"slug":"mcp-kdenlive","type":"pypi","identifier":"mcp-kdenlive","withdrawn":false,"url":"https://verifymcp.io/servers/mhbxyz-kdenlive-mcp/mcp-kdenlive","version":"0.3.0","transport":"stdio","scoredAt":"2026-11-21T03:09:06.493Z"},"score":{"total":78,"tier":"medium","status":"scored","weekDelta":15,"history":[{"date":"2026-11-21","total":78},{"date":"2026-11-20","total":78},{"date":"2026-11-19","total":78},{"date":"2026-11-18","total":63},{"date":"2026-11-17","total":63},{"date":"2026-11-16","total":63},{"date":"2026-11-15","total":78},{"date":"2026-11-14","total":63},{"date":"2026-11-13","total":63},{"date":"2026-11-12","total":63},{"date":"2026-11-11","total":63},{"date":"2026-11-10","total":63},{"date":"2026-11-09","total":78},{"date":"2026-11-08","total":63}]},"categories":[{"name":"Supply Chain Security","score":100,"verdict":"partial","reasons":["No malware found by supply-chain analysis.","No known CVEs affecting this package version or its production dependencies.","Runs hatchling.build at install time, a recognised build step with no custom scripting around it.","1 of 28 dependencies flagged as unhealthy."],"codes":[{"code":"supplychain.malware_clean","args":{}},{"code":"cve.none","args":{}},{"code":"installscript.allowlisted","args":{"tool":"hatchling.build","hooks":"build_backend"}},{"code":"dephealth.assessed","args":{"deps":"28","unhealthy":"1"}}]},{"name":"Provenance & Transparency","score":100,"verdict":"pass","reasons":["Source repository is publicly reachable at the declared URL.","Cryptographically verified build provenance (signed, bound to mhbxyz/kdenlive-mcp).","Clear OSI-approved license (MIT).","Actively maintained (last published 8 days ago).","Publishes a security disclosure policy (SECURITY.md)."],"codes":[{"code":"provenance.repo_verified","args":{}},{"code":"provenance.verified","args":{"repo":"mhbxyz/kdenlive-mcp"}},{"code":"license.osi","args":{"spdx":"MIT"}},{"code":"maintenance.recent","args":{"age_days":"8"}},{"code":"disclosure.present","args":{}}]},{"name":"Schema Quality & AI Usability","score":60,"verdict":"fail","reasons":["AI-judged instruction clarity (good).","Context-footprint check failed: tool/resource definitions use about 7593 tokens (~205/item across 37 items; 37 tools + 0 resources), over budget; trim descriptions and params.","Usage-examples check failed: none of the tools include examples."],"codes":[{"code":"schema.ai_quality","args":{"band":"good"}},{"code":"schema.footprint_heavy","args":{"avg":"205","items":"37","tools":"37","tokens":"7593","resources":"0"}},{"code":"schema.examples_absent","args":{}}]},{"name":"Stability & Change Management","score":0,"verdict":"unverified","reasons":["Stability not yet verified: not enough scan history yet (needs a 30-day window)."],"codes":[{"code":"stability.insufficient_history","args":{}}]},{"name":"Tool Coverage","score":95,"verdict":"partial","reasons":["100% of tools have a non-trivial description (not blank, and not just the tool's name).","83% of tool parameters carry a description.","Structured output schemas are declared (100% of tools); any adoption earns full credit."],"codes":[{"code":"toolquality.descriptions","args":{"pct":"100"}},{"code":"toolquality.param_docs","args":{"pct":"83"}},{"code":"toolquality.output_present","args":{"pct":"100"}}]},{"name":"Tool Safety","score":100,"verdict":"pass","reasons":["No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.","All 4 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.","An AI judge read all 38 captured unit(s) of tool text and found none that tries to manipulate the model reading it."],"codes":[{"code":"toolsafety.injection_clean","args":{}},{"code":"toolsafety.destructive_declared","args":{"pct":"100","annotated":"4","destructive":"4"}},{"code":"toolsafety.manipulation_clean","args":{"units":"38","judged":"38"}}]},{"name":"Capabilities","score":100,"verdict":"pass","reasons":["Implements a current MCP spec version (2026-07-28)."],"codes":[{"code":"protocol.current","args":{"version":"2026-07-28"}}]}],"inconclusive":["Stability not yet verified: not enough scan history yet (needs a 30-day window)."],"malware":[],"components":[{"slug":"mcp-kdenlive","type":"pypi","identifier":"mcp-kdenlive","withdrawn":false,"score":78,"current":true,"url":"https://verifymcp.io/servers/mhbxyz-kdenlive-mcp/mcp-kdenlive","markdownUrl":"https://verifymcp.io/servers/mhbxyz-kdenlive-mcp/mcp-kdenlive.md"}],"facts":[{"label":"Registry","value":"pypi"},{"label":"Package","value":"mcp-kdenlive"},{"label":"Version","value":"0.3.0"},{"label":"Transport","value":"stdio"}],"install":{"available":true,"bundleSha256":null},"tools":[{"name":"diagnose_environment","title":"Diagnose environment","description":"Report whether Kdenlive, MLT (melt), ffprobe and ffmpeg are installed and usable, with their paths, versions and actionable hints. Read-only: modifies nothing. Locations can be overridden with KDENLIVE_MCP_KDENLIVE, KDENLIVE_MCP_MELT, KDENLIVE_MCP_FFPROBE and KDENLIVE_MCP_FFMPEG in the server environment. `filesystem` lists the folders the tools may read and write (KDENLIVE_MCP_ALLOWED_ROOTS; by default the user's videos directory).","inputs":[],"outputs":[{"name":"filesystem","type":null,"required":true,"description":null},{"name":"notes","type":"array","required":false,"description":"Limitations of this report: what was not verified."},{"name":"platform","type":null,"required":true,"description":null},{"name":"ready","type":"boolean","required":true,"description":"True when every required program is available."},{"name":"server_version","type":"string","required":true,"description":null},{"name":"tools","type":"array","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":120},{"name":"inspect_project","title":"Inspect project","description":"Summarize a Kdenlive project file without modifying it: Kdenlive and document versions, profile (resolution, rational frame rate), bin clip count and each timeline sequence with its duration and track counts. Includes the file's sha256 so later calls can detect changes. Reads the file on disk only: unsaved changes in a running Kdenlive are not visible.","inputs":[{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."}],"outputs":[{"name":"bin_clip_count","type":"integer","required":true,"description":null},{"name":"document_version","type":null,"required":true,"description":null},{"name":"file","type":null,"required":true,"description":null},{"name":"format_generation","type":"integer","required":true,"description":"5 = Kdenlive ≥ 23.04 (multiple sequences)."},{"name":"kdenlive_version","type":null,"required":true,"description":"Kdenlive version that last saved the file."},{"name":"mlt_version","type":null,"required":true,"description":null},{"name":"notes","type":"array","required":true,"description":null},{"name":"profile","type":null,"required":true,"description":null},{"name":"sequences","type":"array","required":true,"description":null},{"name":"warnings","type":"array","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":103},{"name":"get_timeline","title":"Get timeline","description":"Return the tracks, clips, mixes, compositions and guides of one sequence of a Kdenlive project, read-only. Positions are integer frames at the project frame rate; timeline ranges are [start, end) and source in/out are inclusive (see the 'conventions' field). Large timelines are truncated to max_clips.","inputs":[{"name":"max_clips","type":"integer","required":false,"description":"Maximum clips returned."},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."},{"name":"sequence","type":null,"required":false,"description":"Sequence uuid or name; defaults to the active sequence."}],"outputs":[{"name":"compositions","type":"array","required":true,"description":null},{"name":"conventions","type":"string","required":true,"description":null},{"name":"duration_frames","type":"integer","required":true,"description":null},{"name":"duration_timecode","type":"string","required":true,"description":null},{"name":"file","type":null,"required":true,"description":null},{"name":"frame_rate","type":null,"required":true,"description":null},{"name":"guides","type":"array","required":true,"description":null},{"name":"notes","type":"array","required":true,"description":null},{"name":"returned_clips","type":"integer","required":true,"description":null},{"name":"sequence_name","type":null,"required":true,"description":null},{"name":"sequence_uuid","type":"string","required":true,"description":null},{"name":"total_clips","type":"integer","required":true,"description":null},{"name":"tracks","type":"array","required":true,"description":null},{"name":"truncated","type":"boolean","required":true,"description":"True if clips were omitted because of max_clips."},{"name":"warnings","type":"array","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":122},{"name":"list_project_media","title":"List project media","description":"List the media referenced by a Kdenlive project's bin and diagnose missing or unreadable files, plus files used by effects and transitions (LUTs, luma wipes, subtitles). References are resolved exactly like Kdenlive does (project root, moved projects, proxies). Read-only; URLs are reported but never fetched. With probe=true, ffprobe metadata (streams, codecs, sizes, frame rates, rotation) is added for up to 50 available files.","inputs":[{"name":"max_items","type":"integer","required":false,"description":"Maximum bin items returned."},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."},{"name":"probe","type":"boolean","required":false,"description":"Run ffprobe on available files."}],"outputs":[{"name":"asset_files","type":"array","required":true,"description":"Files used by effects and transitions (checked like Kdenlive does)."},{"name":"counts","type":"object","required":true,"description":null},{"name":"items","type":"array","required":true,"description":null},{"name":"missing","type":"array","required":true,"description":"Resolved paths (or references) of missing media."},{"name":"notes","type":"array","required":true,"description":null},{"name":"probed","type":"integer","required":true,"description":null},{"name":"project","type":"string","required":true,"description":null},{"name":"root","type":null,"required":true,"description":null},{"name":"total_items","type":"integer","required":true,"description":null},{"name":"truncated","type":"boolean","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":148},{"name":"probe_media","title":"Probe media file","description":"Check one local media file (absolute path) and return ffprobe metadata: duration, streams, codecs, dimensions, rational frame rate, sample rate, channels, rotation. Read-only; URLs are refused. Probing reads headers and does not prove that every frame decodes.","inputs":[{"name":"path","type":"string","required":true,"description":"Absolute path of a local media file."}],"outputs":[{"name":"detail","type":null,"required":true,"description":null},{"name":"path","type":"string","required":true,"description":null},{"name":"probe","type":null,"required":true,"description":null},{"name":"status","type":null,"required":true,"description":null},{"name":"symlink_target","type":null,"required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":77},{"name":"list_render_presets","title":"List render presets","description":"List the render presets of the installed Kdenlive (system and user custom presets), with group and file extension. Use a returned name with render_project.","inputs":[],"outputs":[{"name":"notes","type":"array","required":true,"description":null},{"name":"presets","type":"array","required":true,"description":null},{"name":"sources","type":"array","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":41},{"name":"render_project","title":"Render project","description":"Render a Kdenlive project to a new local file with an installed Kdenlive preset (kdenlive --render, or MLT's melt: see `engine`), then validate the output with ffprobe. Blocks until the render ends or `timeout_seconds` elapses. Never modifies the project or its media. Refuses an existing output unless overwrite=true (the old file is replaced only after a successful, validated render), unknown presets, and projects with missing media unless allow_missing_media=true. Renders the file on disk, not unsaved changes in a running Kdenlive.","inputs":[{"name":"allow_missing_media","type":"boolean","required":false,"description":"Render even if media files are missing."},{"name":"engine","type":"string","required":false,"description":"'kdenlive' runs kdenlive --render (Kdenlive 24.02+); 'melt' renders with MLT directly using the preset's arguments (not Kdenlive's own render path); 'auto' uses Kdenlive when it can, and melt for old…"},{"name":"output","type":"string","required":true,"description":"Absolute path of the file to create."},{"name":"overwrite","type":"boolean","required":false,"description":"Replace an existing output file."},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."},{"name":"preset","type":"string","required":false,"description":"Kdenlive preset name (see list_render_presets)."},{"name":"timeout_seconds","type":"number","required":false,"description":"Stop the render after this."}],"outputs":[{"name":"elapsed_seconds","type":null,"required":false,"description":null},{"name":"engine","type":"string","required":false,"description":"'kdenlive' (kdenlive --render) or 'melt' (MLT directly, see notes)."},{"name":"error","type":null,"required":false,"description":null},{"name":"exit_code","type":null,"required":false,"description":null},{"name":"log_tail","type":"array","required":false,"description":null},{"name":"notes","type":"array","required":false,"description":null},{"name":"output","type":"string","required":true,"description":null},{"name":"preset","type":"string","required":true,"description":null},{"name":"process_completed","type":"boolean","required":true,"description":"The render process exited with status 0."},{"name":"project","type":"string","required":true,"description":null},{"name":"project_sha256","type":"string","required":true,"description":null},{"name":"sequence","type":null,"required":true,"description":null},{"name":"state","type":null,"required":true,"description":null},{"name":"validation","type":null,"required":false,"description":"ffprobe check of the produced file (separate from completion)."},{"name":"warnings","type":"array","required":false,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":294},{"name":"start_render","title":"Start render job","description":"Start rendering a Kdenlive project in the background and return a job id immediately. Same checks and guarantees as render_project (preset, output, missing media, atomic publication after validation). Poll get_render_job for the state (queued, running, succeeded, failed, cancelled) and cancel with cancel_render_job. Jobs live in memory and are stopped when the server exits.","inputs":[{"name":"allow_missing_media","type":"boolean","required":false,"description":"Render even if media files are missing."},{"name":"engine","type":"string","required":false,"description":"'kdenlive' runs kdenlive --render (Kdenlive 24.02+); 'melt' renders with MLT directly using the preset's arguments (not Kdenlive's own render path); 'auto' uses Kdenlive when it can, and melt for old…"},{"name":"output","type":"string","required":true,"description":"Absolute path of the file to create."},{"name":"overwrite","type":"boolean","required":false,"description":"Replace an existing output file."},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."},{"name":"preset","type":"string","required":false,"description":"Kdenlive preset name (see list_render_presets)."},{"name":"timeout_seconds","type":"number","required":false,"description":"Stop the render after this."}],"outputs":[{"name":"cancel_requested","type":"boolean","required":false,"description":null},{"name":"created_at","type":"string","required":true,"description":null},{"name":"elapsed_seconds","type":null,"required":false,"description":null},{"name":"finished_at","type":null,"required":false,"description":null},{"name":"job_id","type":"string","required":true,"description":null},{"name":"output","type":"string","required":true,"description":null},{"name":"preset","type":"string","required":true,"description":null},{"name":"progress","type":null,"required":false,"description":null},{"name":"progress_note","type":null,"required":false,"description":null},{"name":"project","type":"string","required":true,"description":null},{"name":"queue_position","type":null,"required":false,"description":"1 = next to start."},{"name":"result","type":null,"required":false,"description":"Full result (validation, log tail) once the job has ended."},{"name":"started_at","type":null,"required":false,"description":null},{"name":"state","type":null,"required":true,"description":null},{"name":"timeout_seconds","type":"number","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":249},{"name":"get_render_job","title":"Get render job","description":"State of a render job: queued (with queue position), running (elapsed time; progress only when Kdenlive reports it), or ended with the full result (exit status, output validation, log tail).","inputs":[{"name":"job_id","type":"string","required":true,"description":"Id returned by start_render."}],"outputs":[{"name":"cancel_requested","type":"boolean","required":false,"description":null},{"name":"created_at","type":"string","required":true,"description":null},{"name":"elapsed_seconds","type":null,"required":false,"description":null},{"name":"finished_at","type":null,"required":false,"description":null},{"name":"job_id","type":"string","required":true,"description":null},{"name":"output","type":"string","required":true,"description":null},{"name":"preset","type":"string","required":true,"description":null},{"name":"progress","type":null,"required":false,"description":null},{"name":"progress_note","type":null,"required":false,"description":null},{"name":"project","type":"string","required":true,"description":null},{"name":"queue_position","type":null,"required":false,"description":"1 = next to start."},{"name":"result","type":null,"required":false,"description":"Full result (validation, log tail) once the job has ended."},{"name":"started_at","type":null,"required":false,"description":null},{"name":"state","type":null,"required":true,"description":null},{"name":"timeout_seconds","type":"number","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":64},{"name":"list_render_jobs","title":"List render jobs","description":"List render jobs of this server session, most recent first.","inputs":[],"outputs":[{"name":"jobs","type":"array","required":true,"description":null},{"name":"max_concurrent","type":"integer","required":true,"description":null},{"name":"notes","type":"array","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":21},{"name":"cancel_render_job","title":"Cancel render job","description":"Request cancellation of a queued or running render job. The returned job has cancel_requested=true; its state becomes 'cancelled' once Kdenlive and its child processes have exited and the partial output was removed. Cancelling a finished job changes nothing.","inputs":[{"name":"job_id","type":"string","required":true,"description":"Id returned by start_render."}],"outputs":[{"name":"cancel_requested","type":"boolean","required":false,"description":null},{"name":"created_at","type":"string","required":true,"description":null},{"name":"elapsed_seconds","type":null,"required":false,"description":null},{"name":"finished_at","type":null,"required":false,"description":null},{"name":"job_id","type":"string","required":true,"description":null},{"name":"output","type":"string","required":true,"description":null},{"name":"preset","type":"string","required":true,"description":null},{"name":"progress","type":null,"required":false,"description":null},{"name":"progress_note","type":null,"required":false,"description":null},{"name":"project","type":"string","required":true,"description":null},{"name":"queue_position","type":null,"required":false,"description":"1 = next to start."},{"name":"result","type":null,"required":false,"description":"Full result (validation, log tail) once the job has ended."},{"name":"started_at","type":null,"required":false,"description":null},{"name":"state","type":null,"required":true,"description":null},{"name":"timeout_seconds","type":"number","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":72},{"name":"list_profiles","title":"List project profiles","description":"List the MLT video profiles available for new projects (name, resolution, rational frame rate, progressive).","inputs":[],"outputs":[{"name":"profiles","type":"array","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":29},{"name":"create_project","title":"Create project","description":"Create a new Kdenlive project file containing one media clip placed at the start of the timeline (video on V1, audio on A1, grouped). Like a new Kdenlive project, it has two video tracks (V1, V2) and two audio tracks (A1, A2): V2 is free for overlays and titles before any add_track. The project is modeled on Kdenlive 26.08 files and stays editable in Kdenlive. `profile` is an MLT profile name (see list_profiles) or 'auto' to use the standard profile matching the media. Refuses to replace an existing file unless overwrite=true; writes atomically and never modifies the media. Media inside the project's directory is stored with a relative path.","inputs":[{"name":"destination","type":"string","required":true,"description":"Absolute path of the new .kdenlive file."},{"name":"media_path","type":"string","required":true,"description":"Absolute path of an audio or video file."},{"name":"overwrite","type":"boolean","required":false,"description":"Replace an existing project file."},{"name":"profile","type":"string","required":false,"description":"MLT profile name, or 'auto' to match the media."}],"outputs":[{"name":"clip_duration_frames","type":"integer","required":true,"description":null},{"name":"frame_rate","type":"string","required":true,"description":null},{"name":"kdenlive_format","type":"string","required":true,"description":null},{"name":"media","type":"string","required":true,"description":null},{"name":"media_reference","type":"string","required":true,"description":"Path stored in the project (relative when possible)."},{"name":"notes","type":"array","required":true,"description":null},{"name":"profile","type":"string","required":true,"description":null},{"name":"project","type":"string","required":true,"description":null},{"name":"project_sha256","type":"string","required":true,"description":null},{"name":"tracks","type":"array","required":true,"description":"Tracks that received the clip, e.g. ['V1', 'A1']."},{"name":"warnings","type":"array","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":229},{"name":"save_project_copy","title":"Save project copy","description":"Write a verified copy of a Kdenlive project to another .kdenlive file, preserving all project data (unknown metadata included). Relative media paths are rewritten so they still work from the destination folder. Refuses to overwrite an existing file unless overwrite=true (a timestamped backup is kept), refuses to write over the source unless overwrite=true and expected_sha256 (from inspect_project) match, and refuses if the source changed since it was read or the destination is open in Kdenlive.","inputs":[{"name":"destination","type":"string","required":true,"description":"Absolute path of the .kdenlive to write."},{"name":"expected_sha256","type":null,"required":false,"description":"Required to write over the source: its sha256 as last read."},{"name":"overwrite","type":"boolean","required":false,"description":"Allow replacing an existing file."},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."}],"outputs":[{"name":"backup","type":null,"required":true,"description":"Copy of the replaced file, when one was replaced."},{"name":"changes","type":"array","required":true,"description":"Human-readable list of modifications applied."},{"name":"destination","type":"string","required":true,"description":null},{"name":"notes","type":"array","required":true,"description":null},{"name":"rebased_paths","type":"array","required":true,"description":"References rewritten for the new location."},{"name":"sha256","type":"string","required":true,"description":null},{"name":"side_files","type":"array","required":false,"description":"Other files written next to the project (e.g. subtitles), with it."},{"name":"size_bytes","type":"integer","required":true,"description":null},{"name":"source","type":"string","required":true,"description":null},{"name":"source_sha256","type":"string","required":true,"description":"Revision of the source that was edited."},{"name":"warnings","type":"array","required":true,"description":null},{"name":"written","type":"boolean","required":false,"description":"False when nothing changed and the destination already had this content: no write and no backup."}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":177},{"name":"add_media_to_bin","title":"Add media to bin","description":"Add audio or video files to a project's bin (not to the timeline) and write the result to `destination`. Files already in the bin are reported as 'existing' with their clip id instead of being duplicated. Clip data comes from MLT, as in Kdenlive. Same safety rules as save_project_copy.","inputs":[{"name":"destination","type":"string","required":true,"description":"Absolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules)."},{"name":"expected_sha256","type":null,"required":false,"description":"Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted."},{"name":"media_paths","type":"array","required":true,"description":"Absolute paths of media files."},{"name":"overwrite","type":"boolean","required":false,"description":"Allow replacing an existing destination file."},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."}],"outputs":[{"name":"audio","type":null,"required":false,"description":null},{"name":"effects","type":null,"required":false,"description":null},{"name":"markers","type":null,"required":false,"description":null},{"name":"media","type":null,"required":false,"description":null},{"name":"relink","type":null,"required":false,"description":null},{"name":"saved","type":null,"required":true,"description":null},{"name":"subtitles","type":null,"required":false,"description":null},{"name":"timeline","type":null,"required":false,"description":null},{"name":"title","type":null,"required":false,"description":null},{"name":"track","type":null,"required":false,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":188},{"name":"relink_media","title":"Relink media","description":"Point bin clips at new media files, for example after moving a media folder. `mapping` maps a bin_id, a stored reference or a resolved path (from list_project_media) to the new absolute path. Every copy of the clip (bin and timeline instances) is updated; timing, ids and effects are kept. The new file is read by MLT first: fewer frames than the timeline uses, or a missing video/audio stream it uses, is refused ([media_mismatch]); other differences are warnings. Clips using a proxy are refused. The result is written to `destination` with the save_project_copy rules.","inputs":[{"name":"destination","type":"string","required":true,"description":"Absolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules)."},{"name":"expected_sha256","type":null,"required":false,"description":"Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted."},{"name":"mapping","type":"object","required":true,"description":"{bin_id | old reference | old resolved path: new absolute path}"},{"name":"overwrite","type":"boolean","required":false,"description":"Allow replacing an existing destination file."},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."}],"outputs":[{"name":"audio","type":null,"required":false,"description":null},{"name":"effects","type":null,"required":false,"description":null},{"name":"markers","type":null,"required":false,"description":null},{"name":"media","type":null,"required":false,"description":null},{"name":"relink","type":null,"required":false,"description":null},{"name":"saved","type":null,"required":true,"description":null},{"name":"subtitles","type":null,"required":false,"description":null},{"name":"timeline","type":null,"required":false,"description":null},{"name":"title","type":null,"required":false,"description":null},{"name":"track","type":null,"required":false,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":256},{"name":"add_track","title":"Add track","description":"Add an empty, optionally named audio or video track to a sequence and write the result to `destination`. Video tracks are added on top of the existing video tracks; audio tracks below the existing audio tracks (Kdenlive's track order). Existing clips, groups, compositions and mixes are preserved. Same safety rules as save_project_copy.","inputs":[{"name":"destination","type":"string","required":true,"description":"Absolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules)."},{"name":"expected_sha256","type":null,"required":false,"description":"Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted."},{"name":"kind","type":"string","required":true,"description":"'audio' or 'video'."},{"name":"name","type":null,"required":false,"description":"Track name shown in Kdenlive."},{"name":"overwrite","type":"boolean","required":false,"description":"Allow replacing an existing destination file."},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."},{"name":"sequence","type":null,"required":false,"description":"Sequence uuid or name; default: active sequence."}],"outputs":[{"name":"audio","type":null,"required":false,"description":null},{"name":"effects","type":null,"required":false,"description":null},{"name":"markers","type":null,"required":false,"description":null},{"name":"media","type":null,"required":false,"description":null},{"name":"relink","type":null,"required":false,"description":null},{"name":"saved","type":null,"required":true,"description":null},{"name":"subtitles","type":null,"required":false,"description":null},{"name":"timeline","type":null,"required":false,"description":null},{"name":"title","type":null,"required":false,"description":null},{"name":"track","type":null,"required":false,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":215},{"name":"insert_clip","title":"Insert clip","description":"Place a bin clip (bin_id from list_project_media / get_timeline) on a track at frame `start`, optionally a source sub-range [source_in, source_out] (inclusive). A clip with audio and video put on a video track also gets its audio on `audio_track` (default A1; null for video only), grouped like Kdenlive. Positions are frames at the project rate; nothing ripples and nothing is overwritten (overlaps fail). A clip grouped with its audio/video counterpart is edited together with it. The result is written to `destination` with the save_project_copy rules.","inputs":[{"name":"audio_track","type":null,"required":false,"description":null},{"name":"bin_id","type":"string","required":true,"description":null},{"name":"destination","type":"string","required":true,"description":"Absolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules)."},{"name":"expected_sha256","type":null,"required":false,"description":"Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted."},{"name":"overwrite","type":"boolean","required":false,"description":"Allow replacing an existing destination file."},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."},{"name":"sequence","type":null,"required":false,"description":"Sequence uuid or name; default: active sequence."},{"name":"source_in","type":"integer","required":false,"description":null},{"name":"source_out","type":null,"required":false,"description":null},{"name":"start","type":"integer","required":true,"description":null},{"name":"track","type":"string","required":true,"description":"Track label, e.g. V1."}],"outputs":[{"name":"audio","type":null,"required":false,"description":null},{"name":"effects","type":null,"required":false,"description":null},{"name":"markers","type":null,"required":false,"description":null},{"name":"media","type":null,"required":false,"description":null},{"name":"relink","type":null,"required":false,"description":null},{"name":"saved","type":null,"required":true,"description":null},{"name":"subtitles","type":null,"required":false,"description":null},{"name":"timeline","type":null,"required":false,"description":null},{"name":"title","type":null,"required":false,"description":null},{"name":"track","type":null,"required":false,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":297},{"name":"move_clip","title":"Move clip","description":"Move a clip to frame `start`, optionally to another track of the same kind. Positions are frames at the project rate; nothing ripples and nothing is overwritten (overlaps fail). A clip grouped with its audio/video counterpart is edited together with it. The result is written to `destination` with the save_project_copy rules.","inputs":[{"name":"clip","type":"string","required":true,"description":"Clip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit."},{"name":"destination","type":"string","required":true,"description":"Absolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules)."},{"name":"expected_sha256","type":null,"required":false,"description":"Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted."},{"name":"overwrite","type":"boolean","required":false,"description":"Allow replacing an existing destination file."},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."},{"name":"revision","type":"string","required":true,"description":"sha256 of the project file (file.sha256 from get_timeline) that the clip ref comes from; the edit is refused if the file changed since."},{"name":"sequence","type":null,"required":false,"description":"Sequence uuid or name; default: active sequence."},{"name":"start","type":"integer","required":true,"description":null},{"name":"track","type":null,"required":false,"description":null}],"outputs":[{"name":"audio","type":null,"required":false,"description":null},{"name":"effects","type":null,"required":false,"description":null},{"name":"markers","type":null,"required":false,"description":null},{"name":"media","type":null,"required":false,"description":null},{"name":"relink","type":null,"required":false,"description":null},{"name":"saved","type":null,"required":true,"description":null},{"name":"subtitles","type":null,"required":false,"description":null},{"name":"timeline","type":null,"required":false,"description":null},{"name":"title","type":null,"required":false,"description":null},{"name":"track","type":null,"required":false,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":283},{"name":"trim_clip","title":"Trim clip","description":"Change a clip's timeline bounds to [start, end) (either may be omitted); the source in/out points follow, like resizing in Kdenlive. Extending is limited by the source length. Positions are frames at the project rate; nothing ripples and nothing is overwritten (overlaps fail). A clip grouped with its audio/video counterpart is edited together with it. The result is written to `destination` with the save_project_copy rules.","inputs":[{"name":"clip","type":"string","required":true,"description":"Clip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit."},{"name":"destination","type":"string","required":true,"description":"Absolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules)."},{"name":"end","type":null,"required":false,"description":null},{"name":"expected_sha256","type":null,"required":false,"description":"Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted."},{"name":"overwrite","type":"boolean","required":false,"description":"Allow replacing an existing destination file."},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."},{"name":"revision","type":"string","required":true,"description":"sha256 of the project file (file.sha256 from get_timeline) that the clip ref comes from; the edit is refused if the file changed since."},{"name":"sequence","type":null,"required":false,"description":"Sequence uuid or name; default: active sequence."},{"name":"start","type":null,"required":false,"description":null}],"outputs":[{"name":"audio","type":null,"required":false,"description":null},{"name":"effects","type":null,"required":false,"description":null},{"name":"markers","type":null,"required":false,"description":null},{"name":"media","type":null,"required":false,"description":null},{"name":"relink","type":null,"required":false,"description":null},{"name":"saved","type":null,"required":true,"description":null},{"name":"subtitles","type":null,"required":false,"description":null},{"name":"timeline","type":null,"required":false,"description":null},{"name":"title","type":null,"required":false,"description":null},{"name":"track","type":null,"required":false,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":305},{"name":"split_clip","title":"Split clip","description":"Cut a clip at timeline frame `at` into two adjacent clips (razor). Positions are frames at the project rate; nothing ripples and nothing is overwritten (overlaps fail). A clip grouped with its audio/video counterpart is edited together with it. The result is written to `destination` with the save_project_copy rules.","inputs":[{"name":"at","type":"integer","required":true,"description":null},{"name":"clip","type":"string","required":true,"description":"Clip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit."},{"name":"destination","type":"string","required":true,"description":"Absolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules)."},{"name":"expected_sha256","type":null,"required":false,"description":"Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted."},{"name":"overwrite","type":"boolean","required":false,"description":"Allow replacing an existing destination file."},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."},{"name":"revision","type":"string","required":true,"description":"sha256 of the project file (file.sha256 from get_timeline) that the clip ref comes from; the edit is refused if the file changed since."},{"name":"sequence","type":null,"required":false,"description":"Sequence uuid or name; default: active sequence."}],"outputs":[{"name":"audio","type":null,"required":false,"description":null},{"name":"effects","type":null,"required":false,"description":null},{"name":"markers","type":null,"required":false,"description":null},{"name":"media","type":null,"required":false,"description":null},{"name":"relink","type":null,"required":false,"description":null},{"name":"saved","type":null,"required":true,"description":null},{"name":"subtitles","type":null,"required":false,"description":null},{"name":"timeline","type":null,"required":false,"description":null},{"name":"title","type":null,"required":false,"description":null},{"name":"track","type":null,"required":false,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":278},{"name":"remove_clip","title":"Remove clip","description":"Remove a clip from the timeline, leaving a gap (neighbours do not move; the bin clip stays). Positions are frames at the project rate; nothing ripples and nothing is overwritten (overlaps fail). A clip grouped with its audio/video counterpart is edited together with it. The result is written to `destination` with the save_project_copy rules.","inputs":[{"name":"clip","type":"string","required":true,"description":"Clip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit."},{"name":"destination","type":"string","required":true,"description":"Absolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules)."},{"name":"expected_sha256","type":null,"required":false,"description":"Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted."},{"name":"overwrite","type":"boolean","required":false,"description":"Allow replacing an existing destination file."},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."},{"name":"revision","type":"string","required":true,"description":"sha256 of the project file (file.sha256 from get_timeline) that the clip ref comes from; the edit is refused if the file changed since."},{"name":"sequence","type":null,"required":false,"description":"Sequence uuid or name; default: active sequence."}],"outputs":[{"name":"audio","type":null,"required":false,"description":null},{"name":"effects","type":null,"required":false,"description":null},{"name":"markers","type":null,"required":false,"description":null},{"name":"media","type":null,"required":false,"description":null},{"name":"relink","type":null,"required":false,"description":null},{"name":"saved","type":null,"required":true,"description":null},{"name":"subtitles","type":null,"required":false,"description":null},{"name":"timeline","type":null,"required":false,"description":null},{"name":"title","type":null,"required":false,"description":null},{"name":"track","type":null,"required":false,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":276},{"name":"set_clip_volume","title":"Set clip volume","description":"Set a constant audio level in dB (-100 to +20; 0 = unchanged level) on a clip's audio, with Kdenlive's Volume effect. For an audio/video pair, the audio clip is changed. An existing constant level is replaced; an animated one is refused. The result is written to `destination` with the save_project_copy rules.","inputs":[{"name":"clip","type":"string","required":true,"description":"Clip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit."},{"name":"destination","type":"string","required":true,"description":"Absolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules)."},{"name":"expected_sha256","type":null,"required":false,"description":"Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted."},{"name":"level_db","type":"number","required":true,"description":null},{"name":"overwrite","type":"boolean","required":false,"description":"Allow replacing an existing destination file."},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."},{"name":"revision","type":"string","required":true,"description":"sha256 of the project file (file.sha256 from get_timeline) that the clip ref comes from; the edit is refused if the file changed since."},{"name":"sequence","type":null,"required":false,"description":"Sequence uuid or name; default: active sequence."}],"outputs":[{"name":"audio","type":null,"required":false,"description":null},{"name":"effects","type":null,"required":false,"description":null},{"name":"markers","type":null,"required":false,"description":null},{"name":"media","type":null,"required":false,"description":null},{"name":"relink","type":null,"required":false,"description":null},{"name":"saved","type":null,"required":true,"description":null},{"name":"subtitles","type":null,"required":false,"description":null},{"name":"timeline","type":null,"required":false,"description":null},{"name":"title","type":null,"required":false,"description":null},{"name":"track","type":null,"required":false,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":288},{"name":"set_clip_fades","title":"Set clip audio fades","description":"Set the audio fade-in and/or fade-out of a clip, in frames (omit to keep, 0 to remove), with Kdenlive's Fade in / Fade out effects. Both must fit in the clip. For an audio/video pair, the audio clip is changed. Fades stay at the clip's edges when it is later trimmed or split. The result is written to `destination` with the save_project_copy rules.","inputs":[{"name":"clip","type":"string","required":true,"description":"Clip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit."},{"name":"destination","type":"string","required":true,"description":"Absolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules)."},{"name":"expected_sha256","type":null,"required":false,"description":"Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted."},{"name":"fade_in","type":null,"required":false,"description":null},{"name":"fade_out","type":null,"required":false,"description":null},{"name":"overwrite","type":"boolean","required":false,"description":"Allow replacing an existing destination file."},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."},{"name":"revision","type":"string","required":true,"description":"sha256 of the project file (file.sha256 from get_timeline) that the clip ref comes from; the edit is refused if the file changed since."},{"name":"sequence","type":null,"required":false,"description":"Sequence uuid or name; default: active sequence."}],"outputs":[{"name":"audio","type":null,"required":false,"description":null},{"name":"effects","type":null,"required":false,"description":null},{"name":"markers","type":null,"required":false,"description":null},{"name":"media","type":null,"required":false,"description":null},{"name":"relink","type":null,"required":false,"description":null},{"name":"saved","type":null,"required":true,"description":null},{"name":"subtitles","type":null,"required":false,"description":null},{"name":"timeline","type":null,"required":false,"description":null},{"name":"title","type":null,"required":false,"description":null},{"name":"track","type":null,"required":false,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":306},{"name":"list_markers","title":"List guides and clip markers","description":"List the timeline guides of a sequence, the clip markers of every bin clip, and the marker categories (index, name, color). Positions are frames: timeline frames for guides, source frames for clip markers. Read-only.","inputs":[{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."},{"name":"sequence","type":null,"required":false,"description":"Sequence uuid or name; default: active sequence."}],"outputs":[{"name":"categories","type":"array","required":true,"description":null},{"name":"clip_markers","type":"array","required":true,"description":null},{"name":"guides","type":"array","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":88},{"name":"add_marker","title":"Add guide or clip marker","description":"Add a guide or a clip marker with a comment, a category and an optional duration in frames (0 = point marker). Without `bin_id` the marker is a timeline **guide** (position in timeline frames); with `bin_id` it is a **clip marker** on that bin clip (position in the clip's source frames, shown on every instance). Kdenlive keeps one marker per position. The result is written to `destination` with the save_project_copy rules.","inputs":[{"name":"bin_id","type":null,"required":false,"description":"Bin clip id for a clip marker; omit for a timeline guide."},{"name":"category","type":"integer","required":false,"description":null},{"name":"comment","type":"string","required":false,"description":null},{"name":"destination","type":"string","required":true,"description":"Absolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules)."},{"name":"duration","type":"integer","required":false,"description":null},{"name":"expected_sha256","type":null,"required":false,"description":"Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted."},{"name":"overwrite","type":"boolean","required":false,"description":"Allow replacing an existing destination file."},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."},{"name":"position","type":"integer","required":true,"description":null},{"name":"sequence","type":null,"required":false,"description":"Sequence uuid or name; default: active sequence."}],"outputs":[{"name":"audio","type":null,"required":false,"description":null},{"name":"effects","type":null,"required":false,"description":null},{"name":"markers","type":null,"required":false,"description":null},{"name":"media","type":null,"required":false,"description":null},{"name":"relink","type":null,"required":false,"description":null},{"name":"saved","type":null,"required":true,"description":null},{"name":"subtitles","type":null,"required":false,"description":null},{"name":"timeline","type":null,"required":false,"description":null},{"name":"title","type":null,"required":false,"description":null},{"name":"track","type":null,"required":false,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":268},{"name":"update_marker","title":"Update guide or clip marker","description":"Change the marker at `position`: move it (`new_position`), or change its comment, category or duration; omitted fields are kept. Without `bin_id` the marker is a timeline **guide** (position in timeline frames); with `bin_id` it is a **clip marker** on that bin clip (position in the clip's source frames, shown on every instance). Kdenlive keeps one marker per position. The result is written to `destination` with the save_project_copy rules.","inputs":[{"name":"bin_id","type":null,"required":false,"description":"Bin clip id for a clip marker; omit for a timeline guide."},{"name":"category","type":null,"required":false,"description":null},{"name":"comment","type":null,"required":false,"description":null},{"name":"destination","type":"string","required":true,"description":"Absolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules)."},{"name":"duration","type":null,"required":false,"description":null},{"name":"expected_sha256","type":null,"required":false,"description":"Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted."},{"name":"new_position","type":null,"required":false,"description":null},{"name":"overwrite","type":"boolean","required":false,"description":"Allow replacing an existing destination file."},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."},{"name":"position","type":"integer","required":true,"description":null},{"name":"sequence","type":null,"required":false,"description":"Sequence uuid or name; default: active sequence."}],"outputs":[{"name":"audio","type":null,"required":false,"description":null},{"name":"effects","type":null,"required":false,"description":null},{"name":"markers","type":null,"required":false,"description":null},{"name":"media","type":null,"required":false,"description":null},{"name":"relink","type":null,"required":false,"description":null},{"name":"saved","type":null,"required":true,"description":null},{"name":"subtitles","type":null,"required":false,"description":null},{"name":"timeline","type":null,"required":false,"description":null},{"name":"title","type":null,"required":false,"description":null},{"name":"track","type":null,"required":false,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":271},{"name":"remove_marker","title":"Remove guide or clip marker","description":"Remove the marker at `position`. Without `bin_id` the marker is a timeline **guide** (position in timeline frames); with `bin_id` it is a **clip marker** on that bin clip (position in the clip's source frames, shown on every instance). Kdenlive keeps one marker per position. The result is written to `destination` with the save_project_copy rules.","inputs":[{"name":"bin_id","type":null,"required":false,"description":"Bin clip id for a clip marker; omit for a timeline guide."},{"name":"destination","type":"string","required":true,"description":"Absolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules)."},{"name":"expected_sha256","type":null,"required":false,"description":"Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted."},{"name":"overwrite","type":"boolean","required":false,"description":"Allow replacing an existing destination file."},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."},{"name":"position","type":"integer","required":true,"description":null},{"name":"sequence","type":null,"required":false,"description":"Sequence uuid or name; default: active sequence."}],"outputs":[{"name":"audio","type":null,"required":false,"description":null},{"name":"effects","type":null,"required":false,"description":null},{"name":"markers","type":null,"required":false,"description":null},{"name":"media","type":null,"required":false,"description":null},{"name":"relink","type":null,"required":false,"description":null},{"name":"saved","type":null,"required":true,"description":null},{"name":"subtitles","type":null,"required":false,"description":null},{"name":"timeline","type":null,"required":false,"description":null},{"name":"title","type":null,"required":false,"description":null},{"name":"track","type":null,"required":false,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":229},{"name":"list_effects","title":"List effects","description":"List the effects this server can apply (a subset verified against Kdenlive's own format): identifier, target (video/audio), parameters with units, ranges and defaults, and whether the installed MLT provides them. Crossfades between adjacent clips use add_mix / remove_mix. Read-only.","inputs":[],"outputs":[{"name":"effects","type":"array","required":true,"description":null},{"name":"notes","type":"array","required":true,"description":null},{"name":"transitions","type":"array","required":true,"description":"Same-track transitions."}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":68},{"name":"add_effect","title":"Add effect","description":"Append a verified effect (list_effects) to a clip, with optional parameters; omitted ones take their defaults. Video effects go on the video part of an audio/video pair. The result is written to `destination` with the save_project_copy rules.","inputs":[{"name":"clip","type":"string","required":true,"description":"Clip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit."},{"name":"destination","type":"string","required":true,"description":"Absolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules)."},{"name":"effect","type":"string","required":true,"description":"Effect id from list_effects, e.g. 'crop'."},{"name":"expected_sha256","type":null,"required":false,"description":"Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted."},{"name":"overwrite","type":"boolean","required":false,"description":"Allow replacing an existing destination file."},{"name":"params","type":null,"required":false,"description":null},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."},{"name":"revision","type":"string","required":true,"description":"sha256 of the project file (file.sha256 from get_timeline) that the clip ref comes from; the edit is refused if the file changed since."},{"name":"sequence","type":null,"required":false,"description":"Sequence uuid or name; default: active sequence."}],"outputs":[{"name":"audio","type":null,"required":false,"description":null},{"name":"effects","type":null,"required":false,"description":null},{"name":"markers","type":null,"required":false,"description":null},{"name":"media","type":null,"required":false,"description":null},{"name":"relink","type":null,"required":false,"description":null},{"name":"saved","type":null,"required":true,"description":null},{"name":"subtitles","type":null,"required":false,"description":null},{"name":"timeline","type":null,"required":false,"description":null},{"name":"title","type":null,"required":false,"description":null},{"name":"track","type":null,"required":false,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":280},{"name":"update_effect","title":"Update effect","description":"Change parameters of the clip's effect at `index`; animated parameters (several keyframes) are refused. Video effects go on the video part of an audio/video pair. The result is written to `destination` with the save_project_copy rules.","inputs":[{"name":"clip","type":"string","required":true,"description":"Clip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit."},{"name":"destination","type":"string","required":true,"description":"Absolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules)."},{"name":"expected_sha256","type":null,"required":false,"description":"Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted."},{"name":"index","type":"integer","required":true,"description":"Position of the effect in the clip's `effects` (get_timeline)."},{"name":"overwrite","type":"boolean","required":false,"description":"Allow replacing an existing destination file."},{"name":"params","type":"object","required":true,"description":"Parameter values by name (see list_effects for names, units, ranges)."},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."},{"name":"revision","type":"string","required":true,"description":"sha256 of the project file (file.sha256 from get_timeline) that the clip ref comes from; the edit is refused if the file changed since."},{"name":"sequence","type":null,"required":false,"description":"Sequence uuid or name; default: active sequence."}],"outputs":[{"name":"audio","type":null,"required":false,"description":null},{"name":"effects","type":null,"required":false,"description":null},{"name":"markers","type":null,"required":false,"description":null},{"name":"media","type":null,"required":false,"description":null},{"name":"relink","type":null,"required":false,"description":null},{"name":"saved","type":null,"required":true,"description":null},{"name":"subtitles","type":null,"required":false,"description":null},{"name":"timeline","type":null,"required":false,"description":null},{"name":"title","type":null,"required":false,"description":null},{"name":"track","type":null,"required":false,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":299},{"name":"remove_effect","title":"Remove effect","description":"Remove the clip's effect at `index` (any effect). Video effects go on the video part of an audio/video pair. The result is written to `destination` with the save_project_copy rules.","inputs":[{"name":"clip","type":"string","required":true,"description":"Clip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit."},{"name":"destination","type":"string","required":true,"description":"Absolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules)."},{"name":"expected_sha256","type":null,"required":false,"description":"Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted."},{"name":"index","type":"integer","required":true,"description":"Position of the effect in the clip's `effects` (get_timeline)."},{"name":"overwrite","type":"boolean","required":false,"description":"Allow replacing an existing destination file."},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."},{"name":"revision","type":"string","required":true,"description":"sha256 of the project file (file.sha256 from get_timeline) that the clip ref comes from; the edit is refused if the file changed since."},{"name":"sequence","type":null,"required":false,"description":"Sequence uuid or name; default: active sequence."}],"outputs":[{"name":"audio","type":null,"required":false,"description":null},{"name":"effects","type":null,"required":false,"description":null},{"name":"markers","type":null,"required":false,"description":null},{"name":"media","type":null,"required":false,"description":null},{"name":"relink","type":null,"required":false,"description":null},{"name":"saved","type":null,"required":true,"description":null},{"name":"subtitles","type":null,"required":false,"description":null},{"name":"timeline","type":null,"required":false,"description":null},{"name":"title","type":null,"required":false,"description":null},{"name":"track","type":null,"required":false,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":268},{"name":"add_mix","title":"Add crossfade","description":"Crossfade a clip into the next clip on its track (they must touch), like Kdenlive's Mix Clips: both clips extend into their source handles around the cut, and grouped audio gets the matching audio crossfade. `duration` in frames (default 1 second). The result is written to `destination` with the save_project_copy rules.","inputs":[{"name":"clip","type":"string","required":true,"description":"Clip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit."},{"name":"destination","type":"string","required":true,"description":"Absolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules)."},{"name":"duration","type":null,"required":false,"description":null},{"name":"expected_sha256","type":null,"required":false,"description":"Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted."},{"name":"overwrite","type":"boolean","required":false,"description":"Allow replacing an existing destination file."},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."},{"name":"revision","type":"string","required":true,"description":"sha256 of the project file (file.sha256 from get_timeline) that the clip ref comes from; the edit is refused if the file changed since."},{"name":"sequence","type":null,"required":false,"description":"Sequence uuid or name; default: active sequence."}],"outputs":[{"name":"audio","type":null,"required":false,"description":null},{"name":"effects","type":null,"required":false,"description":null},{"name":"markers","type":null,"required":false,"description":null},{"name":"media","type":null,"required":false,"description":null},{"name":"relink","type":null,"required":false,"description":null},{"name":"saved","type":null,"required":true,"description":null},{"name":"subtitles","type":null,"required":false,"description":null},{"name":"timeline","type":null,"required":false,"description":null},{"name":"title","type":null,"required":false,"description":null},{"name":"track","type":null,"required":false,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":281},{"name":"remove_mix","title":"Remove crossfade","description":"Remove the crossfade at the end of a clip; both clips go back to the original cut. The result is written to `destination` with the save_project_copy rules.","inputs":[{"name":"clip","type":"string","required":true,"description":"Clip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit."},{"name":"destination","type":"string","required":true,"description":"Absolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules)."},{"name":"expected_sha256","type":null,"required":false,"description":"Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted."},{"name":"overwrite","type":"boolean","required":false,"description":"Allow replacing an existing destination file."},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."},{"name":"revision","type":"string","required":true,"description":"sha256 of the project file (file.sha256 from get_timeline) that the clip ref comes from; the edit is refused if the file changed since."},{"name":"sequence","type":null,"required":false,"description":"Sequence uuid or name; default: active sequence."}],"outputs":[{"name":"audio","type":null,"required":false,"description":null},{"name":"effects","type":null,"required":false,"description":null},{"name":"markers","type":null,"required":false,"description":null},{"name":"media","type":null,"required":false,"description":null},{"name":"relink","type":null,"required":false,"description":null},{"name":"saved","type":null,"required":true,"description":null},{"name":"subtitles","type":null,"required":false,"description":null},{"name":"timeline","type":null,"required":false,"description":null},{"name":"title","type":null,"required":false,"description":null},{"name":"track","type":null,"required":false,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":240},{"name":"add_title","title":"Add title","description":"Create a text title (an editable Kdenlive title clip, not an image) and place it on a video track, usually one above the footage (add_track). Unicode and several lines (\\n) are kept. Position: `align` x `vertical` presets inside 5 % margins, or the box's top-left `x`, `y` in pixels. The font must be installed (checked with fontconfig); `font` defaults to an installed sans font. The result gives the bin id, so insert_clip can place the same title again. The result is written to `destination` with the save_project_copy rules.","inputs":[{"name":"align","type":"string","required":false,"description":null},{"name":"color","type":"string","required":false,"description":"#RRGGBB or #RRGGBBAA."},{"name":"destination","type":"string","required":true,"description":"Absolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules)."},{"name":"duration","type":null,"required":false,"description":null},{"name":"expected_sha256","type":null,"required":false,"description":"Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted."},{"name":"font","type":null,"required":false,"description":null},{"name":"font_size","type":null,"required":false,"description":null},{"name":"italic","type":"boolean","required":false,"description":null},{"name":"outline","type":"integer","required":false,"description":"Outline width, pixels."},{"name":"outline_color","type":"string","required":false,"description":"#RRGGBB or #RRGGBBAA."},{"name":"overwrite","type":"boolean","required":false,"description":"Allow replacing an existing destination file."},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."},{"name":"sequence","type":null,"required":false,"description":"Sequence uuid or name; default: active sequence."},{"name":"start","type":"integer","required":true,"description":"Timeline frame."},{"name":"text","type":"string","required":true,"description":"Title text; \\n starts a new line."},{"name":"track","type":"string","required":true,"description":"Video track label, e.g. V2."},{"name":"vertical","type":"string","required":false,"description":null},{"name":"x","type":null,"required":false,"description":null},{"name":"y","type":null,"required":false,"description":null}],"outputs":[{"name":"audio","type":null,"required":false,"description":null},{"name":"effects","type":null,"required":false,"description":null},{"name":"markers","type":null,"required":false,"description":null},{"name":"media","type":null,"required":false,"description":null},{"name":"relink","type":null,"required":false,"description":null},{"name":"saved","type":null,"required":true,"description":null},{"name":"subtitles","type":null,"required":false,"description":null},{"name":"timeline","type":null,"required":false,"description":null},{"name":"title","type":null,"required":false,"description":null},{"name":"track","type":null,"required":false,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":389},{"name":"list_subtitles","title":"List subtitles","description":"Read a sequence's subtitles (Kdenlive's subtitle track, an ASS file next to the project): file and status, styles, and events with start/end frames, layer and text. Read-only.","inputs":[{"name":"max_events","type":"integer","required":false,"description":null},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."},{"name":"sequence","type":null,"required":false,"description":"Sequence uuid or name; default: active sequence."}],"outputs":[{"name":"sequence_uuid","type":null,"required":true,"description":null},{"name":"tracks","type":"array","required":true,"description":null},{"name":"truncated","type":"boolean","required":true,"description":"True when events beyond max_events were left out."}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":92},{"name":"import_subtitles","title":"Import subtitles","description":"Import a SubRip (.srt) or WebVTT (.vtt) file, UTF-8 or UTF-16 with a byte order mark, as the main sequence's subtitles, in Kdenlive's own format: an ASS file named after the saved project (`<destination>.ass`) with Kdenlive's default style. Times are rounded to frames; overlapping subtitles go to separate layers; <i>, <b>, <u> become ASS styling, other styling is dropped (warnings). Existing subtitles are refused ([subtitles_exist]) unless replace=true; written to a new destination their file is untouched, replaced in place it is backed up first. `offset` shifts every subtitle by that many frames. The result is written to `destination` with the save_project_copy rules.","inputs":[{"name":"destination","type":"string","required":true,"description":"Absolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules)."},{"name":"expected_sha256","type":null,"required":false,"description":"Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted."},{"name":"offset","type":"integer","required":false,"description":"Frames added to every subtitle."},{"name":"overwrite","type":"boolean","required":false,"description":"Allow replacing an existing destination file."},{"name":"path","type":"string","required":true,"description":"Absolute path of a .kdenlive project file on this machine."},{"name":"replace","type":"boolean","required":false,"description":null},{"name":"sequence","type":null,"required":false,"description":"Sequence uuid or name; default: active sequence."},{"name":"subtitle_file","type":"string","required":true,"description":"Path of the .srt or .vtt file."}],"outputs":[{"name":"audio","type":null,"required":false,"description":null},{"name":"effects","type":null,"required":false,"description":null},{"name":"markers","type":null,"required":false,"description":null},{"name":"media","type":null,"required":false,"description":null},{"name":"relink","type":null,"required":false,"description":null},{"name":"saved","type":null,"required":true,"description":null},{"name":"subtitles","type":null,"required":false,"description":null},{"name":"timeline","type":null,"required":false,"description":null},{"name":"title","type":null,"required":false,"description":null},{"name":"track","type":null,"required":false,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":321}],"toolsTruncatedAtCapture":false,"diagnostics":{"capturedAt":"2026-11-21T03:09:06.000Z","track":"package","endpoint":null,"declaredUrl":null,"truncated":false,"tls":null,"dnssec":null,"auth":null,"httpsRedirect":null,"transports":[],"provenance":{"outcome":"verified","label":"Verified","reason":"verified","reasonLabel":"Verified","discovery":"attestation_endpoint","discoveryLabel":"Registry attestation endpoint","sourceRepo":null,"attestationSkipped":null,"attestationSkippedLabel":null},"installScripts":[{"hook":"build_backend","tier":"allowlisted"}],"installScriptsTotal":null,"vulnerabilities":[],"vulnerabilitiesTotal":null,"dependencies":{"nodes":28,"partial":false,"deprecated":null,"stale":null,"noRepo":1}},"mismatches":[],"changelog":{"trackingSince":"2026-11-08","recent":[{"id":"chg_01a1f215-25d8-7354-8c7a-135385e9b07f","kind":"check.reverified","summary":"Malware scan (unverified → pass)","materiality":"security","direction":"improvement","scoreDelta":null,"occurredOn":"2026-11-19","url":"https://verifymcp.io/servers/mhbxyz-kdenlive-mcp/mcp-kdenlive#chg-chg_01a1f215-25d8-7354-8c7a-135385e9b07f"},{"id":"chg_01a1f215-25d9-751b-aa95-146693e37412","kind":"score.total_changed","summary":"Trust score (63 → 78)","materiality":"functional","direction":"improvement","scoreDelta":15,"occurredOn":"2026-11-19","url":"https://verifymcp.io/servers/mhbxyz-kdenlive-mcp/mcp-kdenlive#chg-chg_01a1f215-25d9-751b-aa95-146693e37412"},{"id":"chg_01a1e2d8-1c41-7b0d-8d2f-b8b687c8ad65","kind":"check.unverifiable","summary":"Malware scan (pass → unverified)","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-16","url":"https://verifymcp.io/servers/mhbxyz-kdenlive-mcp/mcp-kdenlive#chg-chg_01a1e2d8-1c41-7b0d-8d2f-b8b687c8ad65"},{"id":"chg_01a1e2d8-1c43-7506-aa35-39cdf192d8be","kind":"score.total_changed","summary":"Trust score (78 → 63)","materiality":"functional","direction":"regression","scoreDelta":-15,"occurredOn":"2026-11-16","url":"https://verifymcp.io/servers/mhbxyz-kdenlive-mcp/mcp-kdenlive#chg-chg_01a1e2d8-1c43-7506-aa35-39cdf192d8be"},{"id":"chg_01a1ddb5-72cd-70d6-918e-1b8b96bb7a96","kind":"check.reverified","summary":"Malware scan (unverified → pass)","materiality":"security","direction":"improvement","scoreDelta":null,"occurredOn":"2026-11-15","url":"https://verifymcp.io/servers/mhbxyz-kdenlive-mcp/mcp-kdenlive#chg-chg_01a1ddb5-72cd-70d6-918e-1b8b96bb7a96"},{"id":"chg_01a1ddb5-72d0-7982-9a8c-ddc09643b859","kind":"score.total_changed","summary":"Trust score (63 → 78)","materiality":"functional","direction":"improvement","scoreDelta":15,"occurredOn":"2026-11-15","url":"https://verifymcp.io/servers/mhbxyz-kdenlive-mcp/mcp-kdenlive#chg-chg_01a1ddb5-72d0-7982-9a8c-ddc09643b859"},{"id":"chg_01a1c3ea-ea16-7870-a494-b5694a3757a6","kind":"check.unverifiable","summary":"Malware scan (pass → unverified)","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-10","url":"https://verifymcp.io/servers/mhbxyz-kdenlive-mcp/mcp-kdenlive#chg-chg_01a1c3ea-ea16-7870-a494-b5694a3757a6"},{"id":"chg_01a1c3ea-ea18-7195-974b-042b8d9ad669","kind":"score.total_changed","summary":"Trust score (78 → 63)","materiality":"functional","direction":"regression","scoreDelta":-15,"occurredOn":"2026-11-10","url":"https://verifymcp.io/servers/mhbxyz-kdenlive-mcp/mcp-kdenlive#chg-chg_01a1c3ea-ea18-7195-974b-042b8d9ad669"},{"id":"chg_01a1be21-3655-7561-bb80-035b7a75a8c8","kind":"check.reverified","summary":"Malware scan (unverified → pass)","materiality":"security","direction":"improvement","scoreDelta":null,"occurredOn":"2026-11-09","url":"https://verifymcp.io/servers/mhbxyz-kdenlive-mcp/mcp-kdenlive#chg-chg_01a1be21-3655-7561-bb80-035b7a75a8c8"},{"id":"chg_01a1be21-3656-71af-8eeb-863464caeb6d","kind":"score.total_changed","summary":"Trust score (63 → 78)","materiality":"functional","direction":"improvement","scoreDelta":15,"occurredOn":"2026-11-09","url":"https://verifymcp.io/servers/mhbxyz-kdenlive-mcp/mcp-kdenlive#chg-chg_01a1be21-3656-71af-8eeb-863464caeb6d"},{"id":"chg_01a1bcaf-5b2e-7517-88cd-d7d2d9020819","kind":"score.first_scored","summary":"First indexed and scored","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-08","url":"https://verifymcp.io/servers/mhbxyz-kdenlive-mcp/mcp-kdenlive#chg-chg_01a1bcaf-5b2e-7517-88cd-d7d2d9020819"},{"id":"chg_01a1bb9e-5a1e-7678-ba85-13bbe728cc7e","kind":"score.first_scored","summary":"First indexed and scored","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-08","url":"https://verifymcp.io/servers/mhbxyz-kdenlive-mcp/mcp-kdenlive#chg-chg_01a1bb9e-5a1e-7678-ba85-13bbe728cc7e"},{"id":"chg_01a1ba23-b5c3-7e5f-a3af-a27266654632","kind":"score.first_scored","summary":"First indexed and scored","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-08","url":"https://verifymcp.io/servers/mhbxyz-kdenlive-mcp/mcp-kdenlive#chg-chg_01a1ba23-b5c3-7e5f-a3af-a27266654632"}],"truncated":false,"feedUrl":"https://verifymcp.io/servers/mhbxyz-kdenlive-mcp/mcp-kdenlive/changelog.json"},"links":{"html":"https://verifymcp.io/servers/mhbxyz-kdenlive-mcp/mcp-kdenlive","markdown":"https://verifymcp.io/servers/mhbxyz-kdenlive-mcp/mcp-kdenlive.md","changelogJson":"https://verifymcp.io/servers/mhbxyz-kdenlive-mcp/mcp-kdenlive/changelog.json","changelogRss":"https://verifymcp.io/servers/mhbxyz-kdenlive-mcp/mcp-kdenlive.xml","external":[{"label":"PyPI project","href":"https://pypi.org/project/mcp-kdenlive/"},{"label":"Socket report","href":"https://socket.dev/pypi/package/mcp-kdenlive"},{"label":"Repository","href":"https://github.com/mhbxyz/kdenlive-mcp"}]}}