@writepanda/mcp 1.14.1 → 1.17.0

package/bin/server.mjs

@@ -242,8 +242,7 @@ const TOOLS = [
 				media: { type: "string", description: "Absolute path to video file" },
 				atIndex: {
 					type: "number",
-					description:
-						"Insert before this zero-based clip index. Omit to append at the end.",
+					description: "Insert before this zero-based clip index. Omit to append at the end.",
 				},
 				expectedRevision: { type: "number" },
 			},
@@ -305,7 +304,7 @@ const TOOLS = [
 				designType: {
 					type: "string",
 					description:
-						"name-bar | slash-reveal | center-stack | minimal-underline | box-reveal | corner-brackets | border-frame | split-horizontal",
+						"slash-reveal | center-stack | split-horizontal | name-bar | border-frame | minimal-underline | box-reveal | corner-brackets. Default: slash-reveal.",
 				},
 				accentColor: { type: "string", description: "Hex accent/background color" },
 				textColor: { type: "string", description: "Hex text color. Default #ffffff" },
@@ -605,8 +604,7 @@ const TOOLS = [
 				},
 				resolution: {
 					type: "string",
-					description:
-						"Output resolution: 4k | 1080p | 720p | 480p | source. Default source.",
+					description: "Output resolution: 4k | 1080p | 720p | 480p | source. Default source.",
 				},
 				gifFrameRate: {
 					type: "number",
@@ -614,8 +612,7 @@ const TOOLS = [
 				},
 				gifSize: {
 					type: "string",
-					description:
-						"GIF size preset: small | medium | large. Only used when format is gif.",
+					description: "GIF size preset: small | medium | large. Only used when format is gif.",
 				},
 				expectedRevision: { type: "number" },
 			},
@@ -731,6 +728,31 @@ const TOOLS = [
 		},
 		command: "project.remove-audio",
 	},
+	{
+		name: "project_set_clip_lut",
+		description:
+			"Apply a color-grade LUT preset to a specific clip. Use asset_list_luts to browse available presets. The grade is applied in preview (CSS filter) and export (FFmpeg eq/hue chain). Pass 'none' to clear. Returns { clipId, lutPreset, lutIntensity }.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				clipId: { type: "string", description: "Clip id from project_read mainTrack.clips[n].id" },
+				lutPreset: {
+					type: "string",
+					description:
+						"Preset id. none | cinematicTealOrange | cinematicShadowBlue | filmNoir | vintageKodak | modernVibrant | moodyDark | warmSunset | coolNordic | bleachBypass | vintagePolaroid | naturalEnhanced",
+				},
+				lutIntensity: {
+					type: "number",
+					description: "Blend strength 0–1. Defaults to 1 (full effect).",
+				},
+				expectedRevision: { type: "number" },
+			},
+			required: ["clipId", "lutPreset"],
+		},
+		command: "project.set-clip-lut",
+	},
 
 	// ── transcript-based editing ────────────────────────────────────
 	{
@@ -932,7 +954,7 @@ const TOOLS = [
 	{
 		name: "motion_list",
 		description:
-			"List every motion-graphic template (id, name, slots, defaults, aspectRatios). 19 templates ship today.",
+			"List every motion-graphic template (id, name, slots, defaults, aspectRatios). 20 templates ship today, including youtube-lower-third for YouTube-style name plates.",
 		inputSchema: { type: "object", properties: {} },
 		command: "motion.list",
 	},
@@ -946,7 +968,7 @@ const TOOLS = [
 	{
 		name: "motion_generate",
 		description:
-			"Render a motion graphic asynchronously. Returns { jobId, outputPath }; call job_wait. Output is an MP4 you can pass to project_add_motion_graphic.",
+			"Render a motion graphic asynchronously. Returns { jobId, outputPath }; call job_wait. Output is an MP4 you can pass to project_add_motion_graphic. Use templateId=youtube-lower-third (slots: channelName, handle, accentColor) for YouTube-style name plates with avatar + Subscribe button.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -962,7 +984,7 @@ const TOOLS = [
 	{
 		name: "motion_render_html",
 		description:
-			"Render arbitrary HTML/CSS/JS to an MP4. Use this when the bundled motion-graphic templates don't fit the brief. Pass either inline `html` or a `htmlPath`. Animations should auto-start on DOMContentLoaded. IMPORTANT: renders are sequential — call job_wait to completion before starting another render, or you'll get a RENDER_BUSY error. Async — returns { jobId, outputPath }; poll job_wait for the final MP4.",
+			"Render arbitrary HTML/CSS/JS to video. Use this when the bundled motion-graphic templates don't fit the brief — you write the HTML, the Chromium → capturePage → FFmpeg pipeline does the rest. Pass either inline `html` or a `htmlPath`. Animations should auto-start on DOMContentLoaded. Set `transparent: true` to get a WebM with alpha channel for overlays (lower thirds, watermarks, name plates) that composite over existing video. IMPORTANT: renders are sequential — call job_wait to completion before starting another render, or you'll get a RENDER_BUSY error. Async — returns { jobId, outputPath }; poll job_wait for the final file.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -986,7 +1008,7 @@ const TOOLS = [
 				audioPath: {
 					type: "string",
 					description:
-						"Absolute path to an audio file (mp3, wav, aac, m4a) to mux into the MP4. Without this the output is silent.",
+						"Absolute path to an audio file (mp3, wav, aac, m4a) to mux into the MP4. Without this the output is silent. Ignored when transparent: true.",
 				},
 				audioVolume: {
 					type: "number",
@@ -996,7 +1018,12 @@ const TOOLS = [
 					type: "array",
 					items: { type: "string" },
 					description:
-						"Absolute paths to local files to stage alongside inline HTML. Reference them by basename: pass [\"/path/logo.png\"] and use <img src=\"logo.png\"> in the HTML. Avoids base64-encoding large images.",
+						'Absolute paths to local files to stage alongside inline HTML. Reference them by basename: pass ["/path/logo.png"] and use <img src="logo.png"> in the HTML. Avoids base64-encoding large images.',
+				},
+				transparent: {
+					type: "boolean",
+					description:
+						"Render with a transparent background (VP9/yuva420p WebM instead of H.264 MP4). Use for overlays — lower thirds, watermarks, bug logos, name plates — anything that composites on top of existing video without a white/black fill. The returned outputPath will have a .webm extension. Note: audioPath is ignored in transparent mode.",
 				},
 			},
 		},
@@ -1073,6 +1100,20 @@ const TOOLS = [
 		inputSchema: { type: "object", properties: {} },
 		command: "asset.list-fx",
 	},
+	{
+		name: "asset_list_music",
+		description:
+			"List every bundled background music track (id, title, category, mood, durationMs, absolutePath). Use absolutePath with project_add_audio to attach a track to a project.",
+		inputSchema: { type: "object", properties: {} },
+		command: "asset.list-music",
+	},
+	{
+		name: "asset_list_luts",
+		description:
+			"List all available LUT color-grade presets (id, label, category). Pass the id to project_set_clip_lut. Categories: natural | cinematic | dramatic | vintage | modern.",
+		inputSchema: { type: "object", properties: {} },
+		command: "asset.list-luts",
+	},
 
 	// ── project-aware LLM ──────────────────────────────────────────
 	{
@@ -1120,7 +1161,7 @@ const TOOLS = [
 	{
 		name: "export_start",
 		description:
-			"Render the project to MP4 via the same Skia native render-helper the editor's Export button uses. ASYNC — returns { jobId, outputPath }; call job_wait. Honours every region/style/caption/FX/lower-third/motion-graphic.",
+			"Render the project to MP4 via the same Skia native render-helper the editor's Export button uses. ASYNC — returns { jobId, outputPath }; call job_wait. Honours every region/style/caption/FX/lower-third/motion-graphic. Video overlays (motion graphics added via project_add_motion_graphic) are automatically composited in a post-process FFmpeg pass — both opaque MP4 and transparent WebM/VP9+alpha overlays are supported; no extra call needed.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -1226,7 +1267,7 @@ const TOOLS = [
 const server = new Server(
 	{
 		name: "pandastudio",
-		version: "1.14.0",
+		version: "1.15.0",
 	},
 	{
 		capabilities: {

package/package.json

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