@writepanda/mcp 1.17.0 → 1.18.0

package/bin/server.mjs

@@ -171,6 +171,13 @@ const TOOLS = [
 		inputSchema: { type: "object", properties: {} },
 		command: "project.list",
 	},
+	{
+		name: "project_current",
+		description:
+			"Return the project currently loaded in the editor window: { project: {id, path, name, revision, clipCount} | null }. Use this when the user says 'edit what I'm working on' / 'the project that's open' — no need to ask them for an id. Returns { project: null } when no editor window is open.",
+		inputSchema: { type: "object", properties: {} },
+		command: "project.current",
+	},
 	{
 		name: "project_show",
 		description:
@@ -253,7 +260,7 @@ const TOOLS = [
 	{
 		name: "project_add_motion_graphic",
 		description:
-			"Drop a motion-graphic MP4 (typically the output of motion_generate) onto the timeline.",
+			"Drop a motion-graphic MP4 (typically the output of motion_generate) onto the timeline. Optional SFX plays when it appears.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -262,6 +269,15 @@ const TOOLS = [
 				file: { type: "string", description: "Absolute path to MP4" },
 				durationMs: { type: "number" },
 				atMs: { type: "number", description: "Default: end of timeline" },
+				soundUrl: {
+					type: "string",
+					description:
+						"Optional SFX played when the motion graphic appears. Bundled id (bundled:sound/<id>) like bundled:sound/message-pop, bundled:sound/swoosh-fast, etc. — use asset_list_sounds to discover. No default.",
+				},
+				soundVolume: {
+					type: "number",
+					description: "Sound volume 0–1. Default 1 when soundUrl is set.",
+				},
 				expectedRevision: { type: "number" },
 			},
 			required: ["file", "durationMs"],
@@ -318,6 +334,15 @@ const TOOLS = [
 				},
 				fontSize: { type: "number", description: "Primary text font size in px. Default 28" },
 				fontFamily: { type: "string", description: "CSS font family name. Default Inter" },
+				soundUrl: {
+					type: "string",
+					description:
+						'SFX played when the lower third enters. Bundled id (bundled:sound/<id>). Default bundled:sound/mouse-click. Pass "none" for silent.',
+				},
+				soundVolume: {
+					type: "number",
+					description: "Sound volume 0–1. Default 0.8.",
+				},
 				expectedRevision: { type: "number" },
 			},
 			required: ["content", "atMs"],
@@ -329,7 +354,7 @@ const TOOLS = [
 	{
 		name: "project_add_zoom",
 		description:
-			"Add a zoom region — highlight a UI moment. Typical pattern: find 'click X' in transcript, drop zoom there.",
+			"Add a zoom region — highlight a UI moment. Typical pattern: find 'click X' in transcript, drop zoom there. Ships with a short swoosh SFX by default; pass soundUrl=\"none\" for silent.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -340,12 +365,51 @@ const TOOLS = [
 				depth: { type: "number", description: "1 (mild) - 6 (extreme). Default 3" },
 				focusX: { type: "number", description: "Normalised 0-1 horizontal center. Default 0.5" },
 				focusY: { type: "number", description: "Normalised 0-1 vertical center. Default 0.5" },
+				soundUrl: {
+					type: "string",
+					description:
+						'SFX played at the zoom\'s leading edge. Bundled id (bundled:sound/<id>). Default bundled:sound/swoosh-fast. Pass "none" for silent.',
+				},
+				soundVolume: {
+					type: "number",
+					description: "Sound volume 0–1. Default 1.",
+				},
 				expectedRevision: { type: "number" },
 			},
 			required: ["atMs", "durationMs"],
 		},
 		command: "project.add-zoom",
 	},
+	{
+		name: "project_set_region_sound",
+		description:
+			'Set or clear the sound effect on an existing region (zoom / motionGraphic / lowerThird / fx). Use to swap the default zoom swoosh, add a ding to a motion graphic, or mute a lower-third click. Pass soundUrl="none" to clear.',
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				regionId: { type: "string", description: "Target region id" },
+				regionType: {
+					type: "string",
+					enum: ["zoom", "motionGraphic", "lowerThird", "fx"],
+					description: "Region kind that owns the id",
+				},
+				soundUrl: {
+					type: "string",
+					description:
+						'Bundled id (bundled:sound/<id>), absolute path, or file:// URL. Pass "none" to clear.',
+				},
+				soundVolume: {
+					type: "number",
+					description: 'Sound volume 0–1. Ignored when soundUrl is "none". Default 1.',
+				},
+				expectedRevision: { type: "number" },
+			},
+			required: ["regionId", "regionType", "soundUrl"],
+		},
+		command: "project.set-region-sound",
+	},
 	{
 		name: "project_add_trim",
 		description: "Mark a span the exporter SKIPS. Use directly for manual cuts.",

package/package.json

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