@writepanda/mcp 1.58.0 → 1.62.0

package/bin/server.mjs

@@ -646,6 +646,12 @@ const TOOLS = [
 					description:
 						"Optional CSS color string composited over the blurred backdrop. Editor default: 'rgba(10,10,10,0.18)' (slight dark glass). Only applied when backdropBlurStrength > 0.",
 				},
+				layer: {
+					type: "string",
+					enum: ["overlay", "background"],
+					description:
+						"'background' renders this full-frame graphic BEHIND the camera (graphic-background + talking-head-card layout) — pair it with a CARD camera clip-transform (cam-right-portrait / cam-bottom-right-quarter) over the same span. The camera card composites on top in preview AND export. Default 'overlay' (on top).",
+				},
 				expectedRevision: { type: "number" },
 			},
 			required: ["durationMs"],
@@ -1001,6 +1007,7 @@ const TOOLS = [
 						"cam-bottom-half",
 						"cam-top-half",
 						"cam-right-portrait",
+						"cam-right-portrait-sm",
 						"cam-left-portrait",
 						"cam-bottom-right-quarter",
 						"cam-bottom-left-quarter",
@@ -1014,7 +1021,7 @@ const TOOLS = [
 						"layout-guest-full",
 					],
 					description:
-						"cam-* (camera reposition into a sub-rect): cam-bottom-half / cam-top-half (9:16); cam-right-portrait / cam-left-portrait (16:9 ~35% card); cam-bottom-right-quarter / cam-bottom-left-quarter (corner card); cam-right-55/left-55/right-50/left-50 (designed splits). layout-* (PODCAST ONLY — whole-composite swap over time): layout-side-by-side, layout-podcast (two equal tiles), layout-host-full (speaker 1 only), layout-guest-full (speaker 2 only). IMPORTANT: layout-* presets only do anything on a PODCAST clip (kind='podcast' — a clip with BOTH a host and a guest source). On any other clip there is no second speaker, so they are a no-op; use cam-* there. Check clip.kind via project_read before using layout-*.",
+						"cam-* (camera reposition into a sub-rect): cam-bottom-half / cam-top-half (9:16); cam-right-portrait / cam-left-portrait (16:9 ~35% card); cam-right-portrait-sm (small ~25% host card — for a full-frame graphic background); cam-bottom-right-quarter / cam-bottom-left-quarter (corner card); cam-right-55/left-55/right-50/left-50 (designed splits). layout-* (PODCAST ONLY — whole-composite swap over time): layout-side-by-side, layout-podcast (two equal tiles), layout-host-full (speaker 1 only), layout-guest-full (speaker 2 only). IMPORTANT: layout-* presets only do anything on a PODCAST clip (kind='podcast' — a clip with BOTH a host and a guest source). On any other clip there is no second speaker, so they are a no-op; use cam-* there. Check clip.kind via project_read before using layout-*.",
 				},
 				transitionMs: {
 					type: "number",
@@ -1843,7 +1850,7 @@ const TOOLS = [
 				slots: {
 					type: "object",
 					description:
-						"Editable values keyed by slot key (see motion_list / the SKILL catalog): text strings, color hex strings, or list arrays. Omitted slots fall back to the template default.",
+						"Editable values keyed by slot key (see motion_list / the SKILL catalog): text strings, color hex strings, or list arrays. An 'image'-typed slot (see its `type` in motion_list) takes an ABSOLUTE FILE PATH to an image — the server stages the file into the render, so you can pass a project-media path or a generated image (e.g. from media_generate_image). Omitted slots fall back to the template default.",
 				},
 				aspectRatio: {
 					type: "string",
@@ -1862,6 +1869,43 @@ const TOOLS = [
 		},
 		command: "motion.generate",
 	},
+	// Video templates ("storyboards") — multi-scene, parameterized videos that
+	// render several templates and concatenate them into one finished clip.
+	{
+		name: "motion_list_storyboards",
+		description:
+			"List the bundled VIDEO templates (storyboards). Unlike single-scene templates (motion_list), a storyboard is a whole short video: an ordered set of scenes plus a `params` brief you fill in once. Returns each storyboard's id, name, audience (youtube|podcaster|course), description, aspectRatios, and `params` (the brief: key, label, type string|color|asset, required, default — color params default to the workspace brand kit via brand.* sentinels). Use a storyboard when the user wants a finished intro/outro/episode-open/lesson-open rather than a single overlay. Render one with motion_generate_storyboard.",
+		inputSchema: { type: "object", properties: {} },
+		command: "motion.list-storyboards",
+	},
+	{
+		name: "motion_generate_storyboard",
+		description:
+			"Render a multi-scene VIDEO template (storyboard) by id. Fill the brief via `params`; missing color params fall back to the workspace brand kit, missing required text params fail fast. The server renders each scene and concatenates them into one MP4. Async — returns { jobId, outputPath, sceneCount }; call job_wait, then pass that jobId as `fromJob` to project_add_motion_graphic. Discover storyboards + their params with motion_list_storyboards.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				storyboardId: {
+					type: "string",
+					description:
+						"Storyboard id from motion_list_storyboards (e.g. youtube-creator-intro, podcast-episode-open, course-lesson-open).",
+				},
+				params: {
+					type: "object",
+					description:
+						"The brief, keyed by param key (see motion_list_storyboards). Text and color values. Omitted color params fall back to the workspace brand kit; omitted required text params cause a fast failure.",
+				},
+				aspectRatio: {
+					type: "string",
+					enum: ["16:9", "9:16", "1:1"],
+					description: "Defaults to the storyboard's first listed aspect.",
+				},
+				outputName: { type: "string", description: "Optional filename stem (no extension)." },
+			},
+			required: ["storyboardId"],
+		},
+		command: "motion.generate-storyboard",
+	},
 	// Custom HTML authoring path is `motion_render_html` (for briefs no
 	// bundled template fits).
 	{

package/package.json

@@ -1,45 +1,45 @@
 {
-	"name": "@writepanda/mcp",
-	"version": "1.58.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",
-		"mcp",
-		"model-context-protocol",
-		"video-editor",
-		"agent",
-		"cursor",
-		"continue",
-		"cline",
-		"claude-desktop"
-	],
-	"author": "Kamala Kannan Sankarraj",
-	"license": "MIT",
-	"homepage": "https://www.writepanda.ai/cli",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/kamskans/openscreen.git",
-		"directory": "packages/mcp"
-	},
-	"bugs": {
-		"url": "https://github.com/kamskans/openscreen/issues"
-	},
-	"type": "module",
-	"engines": {
-		"node": ">=18"
-	},
-	"bin": {
-		"writepanda-mcp": "./bin/server.mjs"
-	},
-	"files": [
-		"bin",
-		"README.md",
-		"LICENSE"
-	],
-	"dependencies": {
-		"@modelcontextprotocol/sdk": "^1.0.4"
-	},
-	"publishConfig": {
-		"access": "public"
-	}
+  "name": "@writepanda/mcp",
+  "version": "1.62.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",
+    "mcp",
+    "model-context-protocol",
+    "video-editor",
+    "agent",
+    "cursor",
+    "continue",
+    "cline",
+    "claude-desktop"
+  ],
+  "author": "Kamala Kannan Sankarraj",
+  "license": "MIT",
+  "homepage": "https://www.writepanda.ai/cli",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kamskans/openscreen.git",
+    "directory": "packages/mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/kamskans/openscreen/issues"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "bin": {
+    "writepanda-mcp": "./bin/server.mjs"
+  },
+  "files": [
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
 }