@writepanda/mcp 1.11.0 → 1.12.0

package/README.md

@@ -48,17 +48,20 @@ After adding, restart your client. The MCP server auto-launches PandaStudio if i
 
 ## What the agent gets
 
-30+ tools covering the full PandaStudio editorial surface:
+55 tools covering the full PandaStudio editorial surface — complete UI parity:
 
 | Category | Tools |
 |---|---|
 | Discovery | `system_status`, `system_list_commands` |
-| Project lifecycle | `project_list`, `project_show`, `project_read`, `project_new`, `project_open` |
-| Composition | `project_add_clip`, `project_add_motion_graphic`, `project_add_fx`, `project_add_lower_third`, `project_add_zoom`, `project_add_trim`, `project_add_speed` |
-| Transcript editing | `transcript_transcribe`, `transcript_get`, `transcript_delete_words`, `transcript_remove_fillers`, `transcript_search` |
+| Project lifecycle | `project_list`, `project_show`, `project_read`, `project_new`, `project_open`, `project_save`, `project_delete` |
+| Clips | `project_add_clip`, `project_remove_clip`, `project_split_clip` |
+| Composition | `project_add_motion_graphic`, `project_add_fx`, `project_add_lower_third`, `project_add_zoom`, `project_add_trim`, `project_add_speed`, `project_add_annotation` |
+| Region editing | `project_remove_region`, `project_update_region` |
+| Canvas & style | `project_set_aspect_ratio`, `project_set_wallpaper`, `project_set_style`, `project_set_crop`, `project_set_webcam_layout`, `project_set_export_settings` |
+| Transcript editing | `transcript_transcribe`, `transcript_get`, `transcript_delete_words`, `transcript_remove_fillers`, `transcript_search`, `transcript_find_replace`, `transcript_remove_silences` |
 | Audio | `audio_clean` (DeepFilter denoising) |
-| Captions | `caption_toggle`, `caption_set_template` |
-| Motion graphics | `motion_list`, `motion_themes`, `motion_generate` |
+| Captions | `caption_toggle`, `caption_set_template`, `caption_set_style` |
+| Motion graphics | `motion_list`, `motion_themes`, `motion_generate`, `motion_render_html` |
 | Assets | `asset_list_sounds`, `asset_list_fx` |
 | AI metadata | `llm_generate_title`, `llm_generate_description`, `llm_generate_timestamps` |
 | Export | `export_start`, `export_list` |

package/bin/server.mjs

@@ -684,6 +684,54 @@ const TOOLS = [
 		command: "project.set-style",
 	},
 
+	{
+		name: "project_add_audio",
+		description:
+			"Add a background audio track (music, VO, ambient sound) to the project. The audio plays over the full mix from startMs and is exported automatically. Use project_remove_audio to remove it. Returns { overlayId } — save this to remove it later.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				audioPath: {
+					type: "string",
+					description: "Absolute path to audio file (mp3, wav, aac, m4a, ogg)",
+				},
+				startMs: {
+					type: "number",
+					description: "Where in the edited timeline playback starts. Default 0.",
+				},
+				volume: { type: "number", description: "Volume multiplier 0–2. Default 0.8." },
+				maxDurationMs: {
+					type: "number",
+					description: "Clip the audio at this duration. Omit to play the full file.",
+				},
+				expectedRevision: { type: "number" },
+			},
+			required: ["audioPath"],
+		},
+		command: "project.add-audio",
+	},
+	{
+		name: "project_remove_audio",
+		description:
+			"Remove a background audio overlay by its id. Use project_read to find overlay ids in project.audioOverlays.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				overlayId: {
+					type: "string",
+					description: "Audio overlay id (e.g. audio-1) from project.audioOverlays",
+				},
+				expectedRevision: { type: "number" },
+			},
+			required: ["overlayId"],
+		},
+		command: "project.remove-audio",
+	},
+
 	// ── transcript-based editing ────────────────────────────────────
 	{
 		name: "transcript_transcribe",
@@ -914,7 +962,7 @@ const TOOLS = [
 	{
 		name: "motion_render_html",
 		description:
-			"Render arbitrary HTML/CSS/JS to an MP4. Use this when the bundled motion-graphic templates don't fit the brief — Claude can author full animations and we'll render them. Pass either inline `html` or a `htmlPath`. The HTML loads in a Chromium offscreen window at the requested dimensions; we capture frames for durationMs starting after the first paint. Animations should auto-start on DOMContentLoaded (CSS animations, GSAP, Lottie via CDN, anything Chromium can render). Async — returns { jobId, outputPath }; poll job_wait for the final MP4.",
+			"Render arbitrary HTML/CSS/JS to an MP4. Use this when the bundled motion-graphic templates don't fit the brief. Pass either inline `html` or a `htmlPath`. Animations should auto-start on DOMContentLoaded. IMPORTANT: renders are sequential — call job_wait to completion before starting another render, or you'll get a RENDER_BUSY error. Async — returns { jobId, outputPath }; poll job_wait for the final MP4.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -935,6 +983,21 @@ const TOOLS = [
 				durationMs: { type: "number", description: "How long to capture. Default 2500." },
 				frameRate: { type: "number", description: "Default 30." },
 				outputName: { type: "string", description: "Optional filename stem." },
+				audioPath: {
+					type: "string",
+					description:
+						"Absolute path to an audio file (mp3, wav, aac, m4a) to mux into the MP4. Without this the output is silent.",
+				},
+				audioVolume: {
+					type: "number",
+					description: "Volume multiplier for audioPath. Range 0–2. Default 1.0.",
+				},
+				assets: {
+					type: "array",
+					items: { type: "string" },
+					description:
+						"Absolute paths to local files to stage alongside inline HTML. Reference them by basename: pass [\"/path/logo.png\"] and use <img src=\"logo.png\"> in the HTML. Avoids base64-encoding large images.",
+				},
 			},
 		},
 		command: "motion.render-html",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@writepanda/mcp",
-	"version": "1.11.0",
+	"version": "1.12.0",
 	"description": "Model Context Protocol server for PandaStudio. Exposes the desktop video editor's automation surface to Cursor, Continue, Cline, Claude Desktop, and any MCP-compliant client.",
 	"keywords": [
 		"pandastudio",