MCP server exposing ffmpeg-video-composer as agent-callable video composition tools
LeClap MCP has 6 tools with significant definition gaps. Tool names follow verb_noun convention (get_, validate_, compose_, probe_, render_), which is good. However, descriptions are extremely brief (10-20 chars), falling well below the 50-200 char baseline for LLM-optimized tools. No input schemas are visible in the provided source code, only tool names and descriptions are evident. Parameter documentation is absent. Output schemas are not documented. Error handling and recovery guidance are missing. The server is STDIO-only, which is a hard transport limitation. Overall, this reads as an early-stage implementation lacking production-grade definition quality.
Compose a video from a template specification
Get the JSON schema for video composition templates
Health check — returns a fixed readiness string.
Probe media files to extract metadata
Bundle and execute a caller-supplied Remotion entry for rendering
Validate a video composition template against the schema
No input schemas visible for any tool. Cannot verify parameter types, constraints, or descriptions.
All tool descriptions are under 20 characters (range: 10-25 chars). LLMs cannot determine when/why to select tools from such brief descriptions.
No output schemas documented. LLMs cannot plan downstream tool calls or extract required fields without knowing what each tool returns.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 39 | 2026-07-28+ | v2 |
Destructive/irreversible tools (compose_video, render_remotion_clip) lack error handling, recovery guidance, and confirmation patterns. No dry-run or validation step before execution.
Tool composition unclear. render_remotion_clip accepts 'caller-supplied Remotion entry' but no parameter documentation explains format, constraints, or how it chains with other tools.