@writepanda/mcp 1.30.0 → 1.31.0

package/bin/server.mjs

@@ -489,7 +489,7 @@ const TOOLS = [
 	{
 		name: "project_add_motion_graphic",
 		description:
-			"Drop a motion-graphic MP4 (typically the output of motion_generate) onto the timeline. Optional SFX plays when it appears.",
+			"Drop a motion-graphic MP4 (typically the output of motion_render_html) onto the timeline. Optional SFX plays when it appears.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -520,7 +520,7 @@ const TOOLS = [
 				backdropBlurStrength: {
 					type: "number",
 					description:
-						"Frosted-glass backdrop blur sigma in 1080p-px. The compositor blurs the camera through the overlay's alpha shape — blur follows the visible content, not the bounding box. Editor's 'Glass' default is 24; 12 is subtle, 36+ is heavy. Pair with a transparent / glassMode render (motion_generate --transparent --glassMode OR motion_render_html --transparent) so the overlay has alpha for the mask to read. Omit or pass 0 to disable.",
+						"Frosted-glass backdrop blur sigma in 1080p-px. The compositor blurs the camera through the overlay's alpha shape — blur follows the visible content, not the bounding box. Editor's 'Glass' default is 24; 12 is subtle, 36+ is heavy. Pair with a transparent render (motion_render_html --transparent) so the overlay has alpha for the mask to read. Omit or pass 0 to disable.",
 				},
 				backdropBlurTint: {
 					type: "string",
@@ -1416,20 +1416,18 @@ const TOOLS = [
 	},
 
 	// ── motion graphics ─────────────────────────────────────────────
-	{
-		name: "motion_list",
-		description:
-			"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",
-	},
-	{
-		name: "motion_themes",
-		description:
-			"List every style-pack theme (color overrides). default, mr-beast, mkbhd, kurzgesagt, veritasium.",
-		inputSchema: { type: "object", properties: {} },
-		command: "motion.themes",
-	},
+	// `motion_list`, `motion_themes`, and `motion_generate` were
+	// removed in v1.31.0. Those bundled-template tools are for the
+	// in-app Gemma E2B local model (which can't author HTML); they
+	// were never on the agent's surface from a product standpoint
+	// but the MCP schema previously exposed them, and the mere
+	// presence of `motion_generate` in the tool list lured agents
+	// into picking it over the architecturally-correct
+	// `motion_render_html`. The bundled templates use flat
+	// solid-color backgrounds and CSS keyframes — they don't meet
+	// the aesthetic baseline (the Hyperframes example gallery)
+	// that agents are expected to clear. Removing the tools
+	// eliminates the temptation. Agents now author HTML directly.
 	{
 		name: "media_generate_image",
 		description:
@@ -1464,32 +1462,8 @@ const TOOLS = [
 		},
 		command: "media.generate-image",
 	},
-	{
-		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 — OR a transparent WebM when `transparent` / `glassMode` is set. Use templateId=youtube-lower-third (slots: channelName, handle, accentColor) for YouTube-style name plates with avatar + Subscribe button. Set glassMode=true to render the template as a frosted-glass card on a transparent canvas — pair with backdropBlurStrength on project_add_motion_graphic for the full Apple/Premiere-grade glass look.",
-		inputSchema: {
-			type: "object",
-			properties: {
-				templateId: { type: "string", description: "From motion_list" },
-				slots: { type: "object", description: "Slot values (theme already resolved)" },
-				aspectRatio: { type: "string", description: "16:9 | 9:16 | 1:1" },
-				outputName: { type: "string", description: "Optional filename stem" },
-				transparent: {
-					type: "boolean",
-					description:
-						"Render with a transparent background (alpha WebM via VP9/yuva420p). Required when you intend to attach backdropBlurStrength on the resulting region — frosted-glass blur only reads through an alpha-shape mask. Output extension is .webm, not .mp4.",
-				},
-				glassMode: {
-					type: "boolean",
-					description:
-						"Apply the shared glass-mode CSS pass before rendering — hides the template's solid-bg decorations (vignette, perspective grid, film-grain) and wraps content in a translucent rounded glass card. Implies transparent=true (alpha WebM output). Pair with backdropBlurStrength=24 + backdropBlurTint='rgba(10,10,10,0.18)' on project_add_motion_graphic to deliver the full frosted-glass look the in-app 'Glass' background mode produces. The motion graphic's content (text, accents, items) renders crisp on top of the camera-blurred glass card.",
-				},
-			},
-			required: ["templateId", "slots"],
-		},
-		command: "motion.generate",
-	},
+	// `motion_generate` removed in v1.31.0 — see comment above the
+	// motion-graphics section. Authoring path is `motion_render_html`.
 	{
 		name: "motion_render_html",
 		description:
@@ -1578,7 +1552,7 @@ const TOOLS = [
 	{
 		name: "motion_concat",
 		description:
-			"Concatenate multiple MP4s into one final video using a lossless stream copy (no re-encode — fast). All clips must share the same resolution and codec; all motion_render_html / motion_generate outputs qualify automatically. Use this after rendering individual scenes to assemble the final promo. Returns { outputPath, clipCount } directly.",
+			"Concatenate multiple MP4s into one final video using a lossless stream copy (no re-encode — fast). All clips must share the same resolution and codec; all motion_render_html outputs qualify automatically. Use this after rendering individual scenes to assemble the final promo. Returns { outputPath, clipCount } directly.",
 		inputSchema: {
 			type: "object",
 			required: ["clips"],
@@ -1852,7 +1826,7 @@ const TOOLS = [
 	{
 		name: "job_wait",
 		description:
-			"Block server-side until an async job (transcribe, audio_clean, motion_generate, export_start) reaches a terminal state. Default timeout 60s, max 5 min. Always call this after kicking off async work.",
+			"Block server-side until an async job (transcribe, audio_clean, motion_render_html, export_start) reaches a terminal state. Default timeout 60s, max 5 min. Always call this after kicking off async work.",
 		inputSchema: {
 			type: "object",
 			properties: {

package/package.json

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