@writepanda/mcp 1.11.1 → 1.13.0

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,10 +983,81 @@ 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",
 	},
+	{
+		name: "motion_screenshot",
+		description:
+			"Capture a single PNG frame of an HTML composition at a given timestamp — no FFmpeg, sub-second. Use this to validate layout, font sizes, and element positions BEFORE committing to a full motion_render_html render. Returns { outputPath } directly (no jobId polling needed).",
+		inputSchema: {
+			type: "object",
+			properties: {
+				html: {
+					type: "string",
+					description: "Inline HTML string (mutually exclusive with htmlPath).",
+				},
+				htmlPath: {
+					type: "string",
+					description: "Absolute path to .html file (mutually exclusive with html).",
+				},
+				aspectRatio: {
+					type: "string",
+					description: "16:9 (default) | 9:16 | 1:1. Ignored if width+height supplied.",
+				},
+				width: { type: "number" },
+				height: { type: "number" },
+				atMs: {
+					type: "number",
+					description:
+						"Milliseconds into the animation to screenshot. Waits this long after page load. Default 0 (first visible frame). Max 30000. Use e.g. 2000 to preview the animation mid-way.",
+				},
+				assets: {
+					type: "array",
+					items: { type: "string" },
+					description:
+						"Absolute paths to local files to stage alongside inline HTML — same as motion_render_html.",
+				},
+				outputName: { type: "string", description: "Optional PNG filename stem." },
+			},
+		},
+		command: "motion.screenshot",
+	},
+	{
+		name: "motion_concat",
+		description:
+			"Concatenate multiple MP4s into one final video using a lossless stream copy (no re-encode — fast). All clips must share the same resolution and codec; all motion_render_html / motion_generate outputs qualify automatically. Use this after rendering individual scenes to assemble the final promo. Returns { outputPath, clipCount } directly.",
+		inputSchema: {
+			type: "object",
+			required: ["clips"],
+			properties: {
+				clips: {
+					type: "array",
+					items: { type: "string" },
+					description:
+						"Ordered array of absolute paths to MP4 files to join. Minimum 2. The output plays them in the order given.",
+				},
+				outputName: { type: "string", description: "Optional filename stem for the output MP4." },
+			},
+		},
+		command: "motion.concat",
+	},
 
 	// ── assets ──────────────────────────────────────────────────────
 	{

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@writepanda/mcp",
-	"version": "1.11.1",
+	"version": "1.13.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",