@writepanda/mcp 1.98.0 → 1.99.0

package/bin/server.mjs

@@ -854,7 +854,7 @@ const TOOLS = [
 	{
 		name: "project_add_motion_graphic",
 		description:
-			"Drop a motion-graphic MP4/WebM onto the timeline. PREFERRED: pass `fromJob` (the jobId from motion_render_html / motion_generate / motion_concat) — the server resolves the outputPath internally, so you never handle the path string at all. Fallback: pass `file` (an absolute path) only for external/uploaded files. Also accepts `file: 'bundled:transition/<id>'` (ids from asset_list_transitions) — the house-opener pattern: a bundled transition placed as an overlay auto-stamps transitionId so it COVER-fits any canvas (a 16:9 sweep fills a 9:16 frame) and carries its SFX via soundUrl. **Defaults to a `bundled:sound/mouse-click` SFX as the graphic appears** — pass `soundUrl: null` to make it silent, or any other `bundled:sound/<id>` to swap the sound.",
+			"Drop a motion-graphic MP4/WebM onto the timeline. PREFERRED: pass `fromJob` (the jobId from motion_render_html / motion_generate / motion_concat) — the server resolves the outputPath internally, so you never handle the path string at all. Fallback: pass `file` (an absolute path) only for external/uploaded files. Also accepts `file: 'bundled:transition/<id>'` (ids from asset_list_transitions) — the house-opener pattern: a bundled transition placed as an overlay auto-stamps transitionId so it COVER-fits any canvas (a 16:9 sweep fills a 9:16 frame) and carries its SFX via soundUrl. Image files (png/jpg/webp/gif/avif) are detected and render as image overlays; pair `file: <image>` with `layer: 'background'` for a timed BACKGROUND-IMAGE underlay (cover-fills the canvas behind the camera — with a background-effect remove region over the same span, the image replaces the speaker's real background for just that duration). **Defaults to a `bundled:sound/mouse-click` SFX as the graphic appears** — pass `soundUrl: null` to make it silent, or any other `bundled:sound/<id>` to swap the sound.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -1223,6 +1223,48 @@ const TOOLS = [
 		},
 		command: "project.add-spotlight",
 	},
+	{
+		name: "project_add_background_effect",
+		description:
+			"Add a BACKGROUND EFFECT region on the camera video: AI person segmentation runs between startMs and endMs and either BLURS the background behind the speaker (mode 'blur' — video-call style) or REMOVES it so the project wallpaper shows through behind them (mode 'remove'). Behaves exactly like a zoom region on the timeline: draggable, trimmable, source-anchored (pass anchorSourceMs when placing from a transcript word so it survives later trims). Camera / talking-head footage only. Preview and export render it identically. Find placed regions via project_read under editor.backgroundEffectRegions[]; retime/restyle with project_update_region (regionType 'background-effect'), delete with project_remove_region.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				atMs: { type: "number", description: "Edited-time start (ms). Or pass startMs." },
+				startMs: { type: "number", description: "Alias for atMs (edited-time start, ms)." },
+				endMs: { type: "number", description: "Edited-time end (ms). Alternative to durationMs." },
+				durationMs: {
+					type: "number",
+					description: "Duration in ms. Default 5000 when neither durationMs nor endMs given.",
+				},
+				mode: {
+					type: "string",
+					enum: ["blur", "remove"],
+					description:
+						'"blur" = person sharp, background gaussian-blurred. "remove" = background cut away; the project wallpaper/background shows through behind the person.',
+				},
+				strength: {
+					type: "number",
+					description:
+						"Blur strength in px sigma at 1080p (mode='blur' only; ignored for 'remove'). 1-120, default 18.",
+				},
+				anchorSourceMs: {
+					type: "number",
+					description:
+						"Anchor to a SOURCE-time moment (transcript word startMs). The region then re-anchors automatically on subsequent trim/speed edits.",
+				},
+				anchorSourceEndMs: {
+					type: "number",
+					description: "Optional anchor end (source ms) for ranged anchoring.",
+				},
+				expectedRevision: { type: "number" },
+			},
+			required: ["mode"],
+		},
+		command: "project.add-background-effect",
+	},
 	{
 		name: "project_update_spotlight",
 		description:
@@ -1624,7 +1666,7 @@ const TOOLS = [
 	{
 		name: "project_remove_region",
 		description:
-			"Delete an existing region (zoom, trim, speed, annotation, fx, overlay, clip-transform, audio-overlay) by its id. Use project_read to find region ids — visual regions live under editor.*Regions; audio overlays live under audioOverlays[]. If the region belongs to a link group (designed-segment pair: a clip-transform parking the camera into one half + the panel motion-graphic on the other half), deleting either half also removes its peer so the pair stays coherent. Returns the updated project.",
+			"Delete an existing region (zoom, trim, speed, annotation, fx, overlay, clip-transform, background-effect, audio-overlay) by its id. Use project_read to find region ids — visual regions live under editor.*Regions; audio overlays live under audioOverlays[]. If the region belongs to a link group (designed-segment pair: a clip-transform parking the camera into one half + the panel motion-graphic on the other half), deleting either half also removes its peer so the pair stays coherent. Returns the updated project.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -1633,7 +1675,7 @@ const TOOLS = [
 				regionType: {
 					type: "string",
 					description:
-						"zoom | trim | speed | annotation | fx | overlay | clip-transform | audio-overlay",
+						"zoom | trim | speed | annotation | fx | overlay | clip-transform | background-effect | audio-overlay",
 				},
 				regionId: { type: "string", description: "id of the region to delete" },
 				expectedRevision: { type: "number" },
@@ -1664,7 +1706,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. Overlay geometry (x/y/width/height) is PERCENT of canvas 0-100; values <= 1 are treated as 0-1 fractions and scaled. 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.",
+			"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. Overlay geometry (x/y/width/height) is PERCENT of canvas 0-100; values <= 1 are treated as 0-1 fractions and scaled. 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), background-effect (startMs, endMs, mode: 'blur'|'remove', strength), 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: {
@@ -1673,7 +1715,7 @@ const TOOLS = [
 				regionType: {
 					type: "string",
 					description:
-						"zoom | trim | speed | annotation | fx | overlay | clip-transform | audio-overlay",
+						"zoom | trim | speed | annotation | fx | overlay | clip-transform | background-effect | audio-overlay",
 				},
 				regionId: { type: "string", description: "id of the region to update" },
 				patch: {
@@ -3012,7 +3054,7 @@ const TOOLS = [
 const server = new Server(
 	{
 		name: "pandastudio",
-		version: "1.71.0",
+		version: "1.72.0",
 	},
 	{
 		capabilities: {

package/package.json

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