@writepanda/mcp 1.57.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"],
@@ -986,7 +992,7 @@ const TOOLS = [
 	{
 		name: "project_add_clip_transform_region",
 		description:
-			"Time-bounded transform on the main video clip — between startMs and endMs the clip renders inside a sub-rect of the canvas (per the chosen preset), freeing the rest for motion graphics. Outside the region, the clip renders full-frame. Renderer interpolates over `transitionMs` (default 320ms) at each boundary so the camera smoothly slides + scales. **Use ONLY on camera-only / user-uploaded recordings — for screen recordings, use cursor-telemetry zooms instead.** Typical pattern: agent finds an emphasis moment in the transcript, places a `cam-bottom-half` (9:16) or `cam-right-portrait` (16:9) transform region, and adds a motion graphic in the freed space. When the region ends, the camera returns to full-frame.",
+			"Time-bounded transform on the main video clip between startMs and endMs. TWO families of preset: (1) cam-* render the single clip inside a sub-rect of the canvas, freeing the rest for motion graphics (use ONLY on camera-only / user-uploaded recordings; for screen recordings use cursor-telemetry zooms). (2) layout-* swap the WHOLE podcast composite for the window — this is how you change a PODCAST's layout over time WITHIN ONE recording (e.g. side-by-side intro, then host-only while they talk, then back). Outside the region the clip renders with its natural layout. Renderer interpolates over `transitionMs` (default 320ms) at each boundary so the camera/tiles smoothly resize.",
 		inputSchema: {
 			type: "object",
 			required: ["startMs", "endMs", "preset"],
@@ -1001,12 +1007,21 @@ 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",
+						"cam-right-55",
+						"cam-left-55",
+						"cam-right-50",
+						"cam-left-50",
+						"layout-side-by-side",
+						"layout-podcast",
+						"layout-host-full",
+						"layout-guest-full",
 					],
 					description:
-						"cam-bottom-half / cam-top-half — for 9:16 (camera fills half, other half open for motion graphics). cam-right-portrait / cam-left-portrait — for 16:9 (camera ~35% of canvas in a portrait card on the chosen side, other ~65% open). cam-bottom-right-quarter / cam-bottom-left-quarter — small corner card; rest of canvas open.",
+						"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",
@@ -1498,6 +1513,31 @@ const TOOLS = [
 		},
 		command: "project.set-clip-layout",
 	},
+	{
+		name: "project_set_clip_style",
+		description:
+			"Set ONE clip's framing style — padding, borderRadius (roundness), and/or shadowIntensity (each 0–100) — overriding the project-level values for just that clip. Use in a multi-clip project to frame sources differently: e.g. a full-bleed camera clip (padding 0, borderRadius 0, shadowIntensity 0) next to a padded, rounded podcast clip. Pass a field as null to CLEAR its override (inherit project); omit a field to leave it unchanged. Project-level equivalents are project_set_style. Honored in preview + export.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				clipId: { type: "string", description: "Clip id to style" },
+				padding: { type: "number", description: "Padding 0–100; null clears, omit leaves as-is." },
+				borderRadius: {
+					type: "number",
+					description: "Roundness 0–100; null clears, omit leaves as-is.",
+				},
+				shadowIntensity: {
+					type: "number",
+					description: "Shadow 0–100; null clears, omit leaves as-is.",
+				},
+				expectedRevision: { type: "number" },
+			},
+			required: ["clipId"],
+		},
+		command: "project.set-clip-style",
+	},
 
 	// ── transcript-based editing ────────────────────────────────────
 	{
@@ -1810,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",
@@ -1829,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).
 	{
@@ -2271,7 +2348,7 @@ const TOOLS = [
 const server = new Server(
 	{
 		name: "pandastudio",
-		version: "1.57.0",
+		version: "1.58.0",
 	},
 	{
 		capabilities: {

package/package.json

@@ -1,45 +1,45 @@
 {
-	"name": "@writepanda/mcp",
-	"version": "1.57.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"
+  }
 }