@post-ripple/mcp 0.9.0 → 0.10.0

package/dist/index.js

@@ -352,18 +352,18 @@ const captionStyleSchema = z
     y: z.number().min(0).max(1).optional(),
 })
     .describe("Caption styling; defaults to white TikTok-bold text with a black outline");
-register("create_video", "Render a short-form (9:16) video from library ingredients. Two types: 'hook_demo' stitches a hook clip (list_hooks) in front of your demo/product video (a completed library video via demoVideoId, or a raw upload via demoFileId from get_video_upload_url), with optional background music (musicId from list_music). 'green_screen_meme' composites a green-screen clip (list_green_screens) over a background image (list_backgrounds). Both take an optional caption with styling. Rendering is asynchronous — poll get_creation with the returned creationId until 'completed', then publish resultVideoId with schedule_post. Uses one 'creations' credit from the plan.", {
+register("create_video", "Render a short-form (9:16) video from library ingredients. Two types: 'hook_demo' takes a hook clip (list_hooks) and either stitches it in front of your demo/product video (a completed library video via demoVideoId, or a raw upload via demoFileId from get_video_upload_url) or — when BOTH demo params are omitted — renders the hook clip ALONE with the caption burned onto it (caption required in that mode; useful for posting a library clip with on-video text). Optional background music via musicId from list_music. 'green_screen_meme' composites a green-screen clip (list_green_screens) over a background image (list_backgrounds). Both take an optional caption with styling. Rendering is asynchronous — poll get_creation with the returned creationId until 'completed', then publish resultVideoId with schedule_post. Uses one 'creations' credit from the plan.", {
     ...orgParam,
     type: z.enum(["hook_demo", "green_screen_meme"]),
     title: z.string().optional().describe("Library title for the finished video"),
-    caption: z.string().optional().describe("Text overlaid on the video (hook part only for hook_demo)"),
+    caption: z.string().optional().describe("Text overlaid on the video (over the hook part when a demo follows; over the whole clip in hook-only mode, where it is required)"),
     captionPosition: z.enum(["top", "middle", "bottom"]).optional(),
     captionStyle: captionStyleSchema.optional(),
     hookId: z.string().optional().describe("hook_demo: hook clip id from list_hooks (required)"),
     demoVideoId: z
         .string()
         .optional()
-        .describe("hook_demo: a COMPLETED library video id (list_videos) to play after the hook. Exactly one of demoVideoId/demoFileId."),
+        .describe("hook_demo: a COMPLETED library video id (list_videos) to play after the hook. At most one of demoVideoId/demoFileId; omit both for a hook-only caption-burn render."),
     demoFileId: z
         .string()
         .optional()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@post-ripple/mcp",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "MCP server that lets AI agents (Claude Code, Codex, opencode) manage a Post Ripple workspace: content, scheduling, publishing, and analytics.",
   "type": "module",
   "bin": {