@writepanda/mcp 1.15.0 → 1.17.0

package/bin/server.mjs

@@ -242,8 +242,7 @@ const TOOLS = [
 				media: { type: "string", description: "Absolute path to video file" },
 				atIndex: {
 					type: "number",
-					description:
-						"Insert before this zero-based clip index. Omit to append at the end.",
+					description: "Insert before this zero-based clip index. Omit to append at the end.",
 				},
 				expectedRevision: { type: "number" },
 			},
@@ -305,7 +304,7 @@ const TOOLS = [
 				designType: {
 					type: "string",
 					description:
-						"name-bar | slash-reveal | center-stack | minimal-underline | box-reveal | corner-brackets | border-frame | split-horizontal",
+						"slash-reveal | center-stack | split-horizontal | name-bar | border-frame | minimal-underline | box-reveal | corner-brackets. Default: slash-reveal.",
 				},
 				accentColor: { type: "string", description: "Hex accent/background color" },
 				textColor: { type: "string", description: "Hex text color. Default #ffffff" },
@@ -605,8 +604,7 @@ const TOOLS = [
 				},
 				resolution: {
 					type: "string",
-					description:
-						"Output resolution: 4k | 1080p | 720p | 480p | source. Default source.",
+					description: "Output resolution: 4k | 1080p | 720p | 480p | source. Default source.",
 				},
 				gifFrameRate: {
 					type: "number",
@@ -614,8 +612,7 @@ const TOOLS = [
 				},
 				gifSize: {
 					type: "string",
-					description:
-						"GIF size preset: small | medium | large. Only used when format is gif.",
+					description: "GIF size preset: small | medium | large. Only used when format is gif.",
 				},
 				expectedRevision: { type: "number" },
 			},
@@ -957,7 +954,7 @@ const TOOLS = [
 	{
 		name: "motion_list",
 		description:
-			"List every motion-graphic template (id, name, slots, defaults, aspectRatios). 19 templates ship today.",
+			"List every motion-graphic template (id, name, slots, defaults, aspectRatios). 20 templates ship today, including youtube-lower-third for YouTube-style name plates.",
 		inputSchema: { type: "object", properties: {} },
 		command: "motion.list",
 	},
@@ -971,7 +968,7 @@ const TOOLS = [
 	{
 		name: "motion_generate",
 		description:
-			"Render a motion graphic asynchronously. Returns { jobId, outputPath }; call job_wait. Output is an MP4 you can pass to project_add_motion_graphic.",
+			"Render a motion graphic asynchronously. Returns { jobId, outputPath }; call job_wait. Output is an MP4 you can pass to project_add_motion_graphic. Use templateId=youtube-lower-third (slots: channelName, handle, accentColor) for YouTube-style name plates with avatar + Subscribe button.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -987,7 +984,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. 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.",
+			"Render arbitrary HTML/CSS/JS to video. Use this when the bundled motion-graphic templates don't fit the brief — you write the HTML, the Chromium → capturePage → FFmpeg pipeline does the rest. Pass either inline `html` or a `htmlPath`. Animations should auto-start on DOMContentLoaded. Set `transparent: true` to get a WebM with alpha channel for overlays (lower thirds, watermarks, name plates) that composite over existing video. 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 file.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -1011,7 +1008,7 @@ const TOOLS = [
 				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.",
+						"Absolute path to an audio file (mp3, wav, aac, m4a) to mux into the MP4. Without this the output is silent. Ignored when transparent: true.",
 				},
 				audioVolume: {
 					type: "number",
@@ -1021,7 +1018,12 @@ const TOOLS = [
 					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.",
+						'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.',
+				},
+				transparent: {
+					type: "boolean",
+					description:
+						"Render with a transparent background (VP9/yuva420p WebM instead of H.264 MP4). Use for overlays — lower thirds, watermarks, bug logos, name plates — anything that composites on top of existing video without a white/black fill. The returned outputPath will have a .webm extension. Note: audioPath is ignored in transparent mode.",
 				},
 			},
 		},
@@ -1159,7 +1161,7 @@ const TOOLS = [
 	{
 		name: "export_start",
 		description:
-			"Render the project to MP4 via the same Skia native render-helper the editor's Export button uses. ASYNC — returns { jobId, outputPath }; call job_wait. Honours every region/style/caption/FX/lower-third/motion-graphic.",
+			"Render the project to MP4 via the same Skia native render-helper the editor's Export button uses. ASYNC — returns { jobId, outputPath }; call job_wait. Honours every region/style/caption/FX/lower-third/motion-graphic. Video overlays (motion graphics added via project_add_motion_graphic) are automatically composited in a post-process FFmpeg pass — both opaque MP4 and transparent WebM/VP9+alpha overlays are supported; no extra call needed.",
 		inputSchema: {
 			type: "object",
 			properties: {

package/package.json

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