MCP server for Pireel Studio video editing platform. Provides tools for video project management, media import/export, and studio automation through the Pireel API.
Two tools with basic schemas and descriptions, but significant gaps in parameter documentation and output schema clarity. 'export' lacks description of return value and error cases. 'import_media' has incomplete parameter descriptions (e.g., 'files' array lacks element type; 'broll' and 'no_transcribe' lack context on when to use them). Neither tool documents output structure or error recovery paths. Naming is reasonable (verb_noun pattern), but descriptions are minimal (export: 156 chars, import_media: 168 chars) and lack actionable guidance for LLM selection. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk profiles (export=READ_ONLY, import_media=WRITE).
Export a Pireel Studio project. Supports local sink delivery via sink_url parameter for agent-driven browsers that discard page downloads.
Import media files (video, audio, images) into a Pireel Studio project. Returns a short-lived import token for use with the import-media.mjs helper script.
Output schemas not documented. Neither tool specifies what fields are returned, their types, or structure. LLMs cannot plan downstream calls or extract required data.
Parameter descriptions incomplete. 'files' array in import_media lacks element type (string? object?). 'broll' and 'no_transcribe' lack context on when/why to use them. 'action' in export only says 'typically start', what other values exist?
No tool annotations despite clear risk profiles. 'export' is READ_ONLY but lacks readOnlyHint. 'import_media' is WRITE but lacks destructiveHint. Agents cannot determine retry safety or side-effect scope.
Error handling absent. No guidance on failure modes (e.g., invalid sink_url, missing files, transcription failure). LLMs cannot self-correct or know whether to retry.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 48 | 2026-07-28+ | v2 |
Parameter constraints not formalized. 'action' should be an enum. 'files' should specify array element type and length limits. 'sink_url' should document URL format and validation rules.