@writepanda/mcp 1.72.0 → 1.75.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" },
 			},
 		},
@@ -1719,7 +1755,11 @@ const TOOLS = [
 			properties: {
 				id: { type: "string" },
 				path: { type: "string" },
-				find: { type: "string", description: "Phrase to search for (case-insensitive)" },
+				find: {
+					type: "string",
+					description:
+						"Phrase to search for. Case-insensitive; digits and punctuation are ignored on both sides, so \"than60\" and \"than\" both match the word \"than60\". A pure-number/punctuation phrase can't be targeted (it normalizes to empty) — include a letter word.",
+				},
 				replace: { type: "string", description: "Replacement text (replaces the whole phrase)" },
 				expectedRevision: { type: "number" },
 			},
@@ -1730,7 +1770,7 @@ const TOOLS = [
 	{
 		name: "transcript_remove_silences",
 		description:
-			"Detect and trim silent gaps in the recording — leading silence before the first word, trailing silence after the last word, and inter-word gaps longer than `thresholdMs`. Bulk-creates trim regions. Returns { removed, totalTrimmedMs }.",
+			"Detect and trim silent sections — the SAME two passes as the UI Remove Silences button, unioned: (1) transcript word-gaps (leading, inter-word, trailing) longer than `thresholdMs`; (2) ffmpeg audio-level silencedetect on each clip's media, catching real dead air the transcript misses (speech-to-text invents phantom words over quiet stretches). Bulk-creates trim regions. Returns { removedCount, totalTrimmedMs, audioDetectionFailed }.",
 		inputSchema: {
 			type: "object",
 			properties: {

package/package.json

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