BeatDesign
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
| completions | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| bdesign_organization_getB | Read project folders and versioned Elements. Optionally preview removing one folder or Element without applying changes. |
| bdesign_organization_applyA | Apply project folder or Element operations atomically. Supply stable commandId/idempotencyKey and the organization revision from organization_get. Folder removal requires a matching previewRevision. Never generates or uploads media. |
| bdesign_asset_queryA | Search distinct project Assets using cursor pagination. scope=current with folderId=null means unclassified; project searches the entire project. Organization changes invalidate the cursor. |
| bdesign_workflow_template_listA | List reusable workflow templates in this local installation. Reading does not instantiate or run them. |
| bdesign_workflow_template_getB | Read a local workflow template definition, exact revision and definition digest. |
| bdesign_workflow_template_previewA | Preview capturing selected Canvas steps, or inserting an exact template revision into the selected project. Returns source revision/digest or draft blockers without writing, uploading or generating. |
| bdesign_workflow_template_applyB | Capture, rename, remove or instantiate a workflow using shared commands. expectedRevision is zero for capture, template revision for rename/remove, Canvas revision for instantiate. Explicit IDs and revisions are required; no automatic generation. |
| bdesign_timeline_usageB | Read actual Timeline media usage, active takes and source ranges. It does not follow a Canvas latest output or create an index node. |
| bdesign_skill_listA | List official creative Skills bundled with this BeatDesign installation, including compatibility and MCP resource URIs. |
| bdesign_skill_getA | Read one bundled BeatDesign Skill with its manifest, compatibility result, and full workflow instructions. |
| bdesign_project_listB | List local BeatDesign projects. |
| bdesign_project_getB | Read one project with its Canvas and Editor documents. |
| bdesign_project_updateA | Update project name, short description or cover through the shared revision-checked command kernel. Get settingsRevision from project_get; manual coverAssetId must belong to the project. Auto cover uses the first image, then a local video poster. |
| bdesign_project_createB | Create a new local BeatDesign project. |
| bdesign_project_targetA | Bind this MCP session to a BeatDesign project so later project-scoped tools may omit projectId, and return the requested workspace handoff. |
| bdesign_project_openB | Return a browser handoff for the selected BeatDesign project. Use it early so the user can watch Agent changes in Canvas, Editor, Studio, or Assets. |
| bdesign_asset_listA | List Assets that belong to a project. |
| bdesign_asset_getB | Read one project Asset by stable assetId. |
| bdesign_asset_importA | Import a local image, video, or audio file into the project Asset library from an absolute path. |
| bdesign_asset_extract_frameA | Extract a PNG frame from a project video Asset. Use position last for tail-frame continuation. |
| bdesign_canvas_getC | Read the Canvas document and revision for a project. |
| bdesign_canvas_viewB | Return a Canvas browser handoff, optionally focused on one card, plus the current Canvas revision and focused card summary. |
| bdesign_canvas_searchB | Search Canvas nodes by name, prompt, result text, model, kind, or media type. |
| bdesign_canvas_applyB | Apply incremental Canvas operations. For a newly connected node, append place_card to position it once to the right of its references; later user drag positions remain untouched unless place_card is called again. Raw document replacement is not exposed. |
| bdesign_canvas_continue_from_tailB | Extract the tail frame of a video, place it on Canvas, and create a continuation generation node. The returned prompt explicitly maps @Image1 as the first frame; submit the image as a normal reference. |
| bdesign_generation_modelsA | List logical generation models and their current parameter/reference capabilities. |
| bdesign_generation_model_getB | Read one logical model, including defaults and accepted parameters. |
| bdesign_generation_submitC | Submit from a reviewed Canvas generation node. A visible output node is created before the provider request, and successful outputs remain reusable Assets. |
| bdesign_generation_statusC | Read and, when possible, refresh one generation task. |
| bdesign_generation_historyC | List generation history for a project. |
| bdesign_editor_getB | Read the current Editor timeline and revision. |
| bdesign_editor_editC | Apply incremental timeline operations such as media and image-overlay add/update, trim, split, move, remove, audio updates, Takes, captions, per-caption layout, caption styles, and SRT import. |
| bdesign_editor_import_srtB | Import SRT captions onto the project timeline caption track. Provide srt text or an absolute filePath. |
| bdesign_editor_renderA | Render the authoritative Editor timeline to a project-owned MP4 Asset with overlays, captions, and mixed audio. Requires local ffmpeg and ffprobe. |
| bdesign_editor_snapshotD | Resolve the active timeline clips at a time. This is semantic inspection, not a pixel screenshot. |
| bdesign_editor_diagnosticsB | Diagnose gaps, overlaps, missing media, duration mismatches, and tiny clips. |
| bdesign_editor_viewB | Return an Editor browser handoff for a timeline time and include its semantic snapshot. |
| bdesign_editor_historyB | Read persisted command receipts for timeline and Canvas changes. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| beatdesign-skill-catalog | Versioned catalog of official creative Skills bundled with this BeatDesign installation. |
TDQS
Scored across 38 tools
Most tools map to a distinct domain+action, but several boundaries blur: bdesign_editor_import_srt overlaps with bdesign_editor_edit (whose description already lists SRT import), and bdesign_generation_models vs bdesign_generation_model_get, bdesign_project_open vs bdesign_project_target, and the four view/handoff tools (project_open, canvas_view, editor_view, project_target) are easy to confuse. The multiple *_apply tools (organization, canvas, workflow_template) are separable by description but require careful reading.
A predictable bdesign_<domain>_<action> pattern holds across nearly all 38 tools (project_list/get/create, asset_list/get/import, canvas_get/apply/search). Minor deviations like bdesign_generation_models (list without a verb) and a few compound verbs (continue_from_tail, extract_frame, import_srt) break the pattern slightly but remain readable.
38 tools is heavy even for a multi-surface creative app (project, asset, canvas, editor, generation, organization, workflow, skills). Several micro-tools such as generation_model_get, canvas_search, and editor_snapshot could plausibly fold into neighbors, making the surface feel enumerated rather than curated.
Lifecycle coverage is broad: project create/read/update/open, asset import/query/extract, canvas read/apply/search, full editor edit/render/history/diagnostics, generation submit/status/history, workflow templates preview/apply. Gaps are minor—no asset or project delete, no generation cancel—and likely recoverable from the shared command kernel.