@writepanda/mcp 1.74.0 → 1.76.0

package/bin/server.mjs

@@ -379,8 +379,12 @@ const TOOLS = [
 				id: { type: "string", description: "Export entry id." },
 				accountId: { type: "string" },
 				channelId: { type: "string" },
-				title: { type: "string" },
-				description: { type: "string" },
+				title: { type: "string", description: "Max 100 chars; < and > are stripped (YouTube rejects them)." },
+				description: {
+					type: "string",
+					description:
+						"Plain text, line breaks OK. < and > are stripped automatically and the text is clamped to 5000 chars, so a stray angle bracket (common in AI-written copy) no longer fails the upload.",
+				},
 				tags: { type: "array", items: { type: "string" } },
 				categoryId: { type: "string" },
 				privacyStatus: {
@@ -416,8 +420,12 @@ const TOOLS = [
 			properties: {
 				accountId: { type: "string" },
 				videoId: { type: "string" },
-				title: { type: "string" },
-				description: { type: "string" },
+				title: { type: "string", description: "Max 100 chars; < and > are stripped (YouTube rejects them)." },
+				description: {
+					type: "string",
+					description:
+						"Plain text, line breaks OK. < and > are stripped automatically and the text is clamped to 5000 chars, so a stray angle bracket (common in AI-written copy) no longer fails the upload.",
+				},
 				tags: { type: "array", items: { type: "string" } },
 				categoryId: { type: "string" },
 				privacyStatus: { type: "string" },
@@ -911,8 +919,13 @@ const TOOLS = [
 					description:
 						"1 (mild) - 6 (extreme). Default 2 (1.5×) — soft, modern feel. Use 3-4 for emphasis beats, 5-6 for dramatic punch-ins.",
 				},
-				focusX: { type: "number", description: "Normalised 0-1 horizontal center. Default 0.5" },
-				focusY: { type: "number", description: "Normalised 0-1 vertical center. Default 0.5" },
+				focusX: { type: "number", description: "Normalised 0-1 horizontal center. Default 0.5. Ignored when followCursor is true." },
+				focusY: { type: "number", description: "Normalised 0-1 vertical center. Default 0.5. Ignored when followCursor is true." },
+				followCursor: {
+					type: "boolean",
+					description:
+						"When true, the zoom continuously pans to follow the recorded mouse cursor (smoothed) for its duration — the Screen-Studio-style cursor-follow camera. Requires cursor telemetry (screen recordings); falls back to static focus otherwise. Ideal for screen-recording walkthroughs. Default false.",
+				},
 				soundUrl: {
 					type: "string",
 					description:
@@ -1228,7 +1241,7 @@ const TOOLS = [
 	{
 		name: "project_update_region",
 		description:
-			"Patch fields on an existing region without replacing it. Accepts any subset of the region's own properties — only the supplied fields are changed, everything else is preserved. Works on zoom (depth, focusX, focusY), trim (startMs, endMs), speed (startMs, endMs, speed), fx (atMs, durationMs, opacity, blendMode, speed), annotation, overlay, clip-transform (startMs, endMs, preset, transitionMs), and audio-overlay (startMs, endMs, sourceStartMs, volume — lets you drag-trim an audio overlay without removing it). Time shifts on a link-grouped region (e.g. one half of a designed segment) propagate to every peer in the group so the pair stays coherent.",
+			"Patch fields on an existing region without replacing it. Accepts any subset of the region's own properties — only the supplied fields are changed, everything else is preserved. Works on zoom (depth, focusX, focusY, focusMode: 'static'|'auto' — set 'auto' for the cursor-follow camera), trim (startMs, endMs), speed (startMs, endMs, speed), fx (atMs, durationMs, opacity, blendMode, speed), annotation, overlay, clip-transform (startMs, endMs, preset, transitionMs), and audio-overlay (startMs, endMs, sourceStartMs, volume — lets you drag-trim an audio overlay without removing it). Time shifts on a link-grouped region (e.g. one half of a designed segment) propagate to every peer in the group so the pair stays coherent.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -1310,6 +1323,24 @@ const TOOLS = [
 		},
 		command: "project.set-crop",
 	},
+	{
+		name: "project_set_screen_transform",
+		description:
+			"Move and/or scale the MAIN video within the frame — the automation equivalent of dragging or resizing the main clip on the canvas. Distinct from project_set_crop (which trims SOURCE pixels): this repositions and zooms the WHOLE video inside the frame. `scale` is a uniform multiplier (0.1-5; >1 zooms in and the overflow is clipped to the canvas, <1 shrinks it so the wallpaper shows around it). `x`/`y` shift the center as a fraction of canvas width/height (-2..2; 0 = centered). Omitted fields keep their current value. Pass reset:true (or no x/y/scale) to clear it back to the natural layout. Global (whole timeline); preview and export honor it identically.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				x: { type: "number", description: "Center X offset, fraction of canvas width (-2..2)." },
+				y: { type: "number", description: "Center Y offset, fraction of canvas height (-2..2)." },
+				scale: { type: "number", description: "Uniform scale multiplier (0.1..5). 1 = natural." },
+				reset: { type: "boolean", description: "Clear the transform (back to natural layout)." },
+				expectedRevision: { type: "number" },
+			},
+		},
+		command: "project.set-screen-transform",
+	},
 	{
 		name: "project_set_focal_point",
 		description:
@@ -1369,7 +1400,7 @@ const TOOLS = [
 	{
 		name: "project_set_aspect_ratio",
 		description:
-			"Change the project's output aspect ratio. Affects the canvas size and how the video is cropped/letterboxed on export. Pick based on the target platform: 16:9 for YouTube/desktop, 9:16 for Shorts/Reels/TikTok, 1:1 for Instagram feed.",
+			"Change the project's output aspect ratio. Affects the canvas size and how the video is cropped/letterboxed on export. Pick based on the target platform: 16:9 for YouTube/desktop, 9:16 for Shorts/Reels/TikTok, 1:1 for Instagram feed. A camera-only project whose source aspect differs from the new ratio is auto cover-cropped (centered) to fill the frame instead of letterboxing.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -1421,6 +1452,11 @@ const TOOLS = [
 					type: "boolean",
 					description: "Whether to show a blurred background behind the recording.",
 				},
+				cursorScale: {
+					type: "number",
+					description:
+						"Custom-cursor overlay size. 0 = off (no synthetic cursor). >0 (e.g. 1.5) draws an enlarged cursor that tracks the recording's cursor telemetry. Screen recordings only. 0-5.",
+				},
 				expectedRevision: { type: "number" },
 			},
 		},
@@ -1816,7 +1852,7 @@ const TOOLS = [
 	{
 		name: "caption_set_style",
 		description:
-			"Override specific style properties of the caption overlay without changing the template. All fields are optional — pass only what you want to change. positionY controls vertical placement (0=top, 100=bottom, default 85). fontSize is in REM (e.g. '2.6rem'), matching the editor's Font size slider; it is clamped to 1.0–5.0rem (a px value is converted to rem), so you can't exceed the editor's max.",
+			"Override specific style properties of the caption overlay without changing the template. All fields are optional — pass only what you want to change. positionY controls vertical placement (0=top, 100=bottom, default 85). fontFamily sets the caption font (a system font like 'Georgia' or a loaded custom font; unloaded fonts fall back). fontSize is in REM (e.g. '2.6rem'), matching the editor's Font size slider; it is clamped to 1.0–5.0rem (a px value is converted to rem), so you can't exceed the editor's max.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -1827,6 +1863,11 @@ const TOOLS = [
 					description: "Max words shown at once. Default varies by template.",
 				},
 				positionY: { type: "number", description: "Vertical position 0-100. Default 85." },
+				fontFamily: {
+					type: "string",
+					description:
+						"Caption font family, e.g. 'Inter', 'Georgia', or a loaded custom font name. Fonts not loaded in the app fall back to a system default.",
+				},
 				color: { type: "string", description: "Caption text color (hex/CSS)" },
 				backgroundColor: { type: "string", description: "Caption background color" },
 				highlightColor: {

package/package.json

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