@writepanda/mcp 1.32.0 → 1.33.0

package/bin/server.mjs

@@ -489,13 +489,17 @@ const TOOLS = [
 	{
 		name: "project_add_motion_graphic",
 		description:
-			"Drop a motion-graphic MP4 (typically the output of motion_render_html) onto the timeline. Optional SFX plays when it appears.",
+			"Drop a motion-graphic MP4 onto the timeline. The `file` argument MUST be the exact `outputPath` returned by a prior motion_render_html / motion_generate / motion_concat / motion_screenshot job — NEVER hand-author or guess this path. Optional SFX plays when it appears.",
 		inputSchema: {
 			type: "object",
 			properties: {
 				id: { type: "string" },
 				path: { type: "string" },
-				file: { type: "string", description: "Absolute path to MP4" },
+				file: {
+					type: "string",
+					description:
+						"Absolute path to the rendered MP4/WebM. MUST be the exact `outputPath` returned by motion_render_html (or motion_generate / motion_concat / motion_screenshot). Do NOT construct paths manually — guessed paths get truncated at whitespace (e.g. `/Users/.../Library/Application` from `Application Support`) and the overlay flickers and disappears in preview. If you don't have an outputPath, render one first.",
+				},
 				durationMs: { type: "number" },
 				atMs: { type: "number", description: "Default: end of timeline" },
 				soundUrl: {
@@ -562,6 +566,29 @@ const TOOLS = [
 		},
 		command: "project.set-overlay-backdrop-blur",
 	},
+	{
+		name: "project_set_overlay_crop",
+		description:
+			"Set or clear a source-pixel crop on a media overlay (image / video / motion graphic). Coordinates are normalized 0–1 over the overlay's NATIVE source dimensions (NOT the canvas) — independent of where the overlay is positioned on the timeline. Common uses: cut black bars off b-roll before compositing; isolate the centre column of a 16:9 clip when stacking it into a 9:16 short; zoom into one quadrant of a motion graphic. Omit x/y/width/height (or pass identity {0,0,1,1}) to clear the crop entirely. The renderer clamps out-of-range values so a malformed crop is at worst 'whole source'.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				regionId: {
+					type: "string",
+					description: "Media-overlay region id from project.read.",
+				},
+				x: { type: "number", description: "Crop x origin in [0, 1) of source width." },
+				y: { type: "number", description: "Crop y origin in [0, 1) of source height." },
+				width: { type: "number", description: "Crop width in (0, 1] of source width." },
+				height: { type: "number", description: "Crop height in (0, 1] of source height." },
+				expectedRevision: { type: "number" },
+			},
+			required: ["regionId"],
+		},
+		command: "project.set-overlay-crop",
+	},
 	{
 		name: "project_add_fx",
 		description: "Drop an FX overlay (bundled fxId or custom video URL) onto the timeline.",

package/package.json

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