@writepanda/mcp 1.11.1 → 1.12.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,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.1",
+	"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",