@post-ripple/mcp 0.13.0 → 0.15.0

package/dist/index.js

@@ -255,7 +255,14 @@ register("get_account_metrics", "Get follower/profile growth history (daily snap
         .optional()
         .describe("Max series points per account, default 50"),
 });
-register("get_engagement_summary", "Get an org-wide engagement overview for the last N days: totals, per-platform breakdown, top 5 posts by views, and current follower counts per account. The best starting point for 'how is content performing?'", { ...orgParam, days: z.number().min(1).max(90).optional().describe("Window in days, default 30") });
+register("get_engagement_summary", "Get an engagement overview for the last N days: totals, per-platform breakdown, top 5 posts by views, and a per-account breakdown (follower count + posts/views/likes/comments/shares in the window). Pass accountId to scope the whole summary — totals and top posts included — to one connected account. The best starting point for 'how is content performing?' or 'how is this account doing?'", {
+    ...orgParam,
+    days: z.number().min(1).max(90).optional().describe("Window in days, default 30"),
+    accountId: z
+        .string()
+        .optional()
+        .describe("Scope the summary to one connected account (from list_social_accounts)"),
+});
 // ---- content:write tools ----
 register("import_video_from_url", "Import a video into the library from a public URL (e.g. a TikTok/Instagram/YouTube link or a direct file URL). Download happens asynchronously — poll list_videos until its status is 'completed' before scheduling it.", {
     ...orgParam,
@@ -364,13 +371,16 @@ const clipTrimSchema = z.object({
         .optional()
         .describe("Out-point, ms into the source clip (omit = clip end)"),
 });
-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 and/or hookTrim applied (at least one required in that mode; useful for posting a library clip with on-video text or a shortened cut). Both clips can be trimmed to a window of the source via hookTrim/demoTrim. 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.", {
+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 and/or hookTrim applied (at least one required in that mode; useful for posting a library clip with on-video text or a shortened cut). Both clips can be trimmed via hookTrim/demoTrim, and captionWindow selects exactly when text is visible on the final video (including the whole video). 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 (over the hook part when a demo follows; over the whole clip in hook-only mode, where it is required)"),
+    caption: z.string().optional().describe("Text overlaid on the video. For hook_demo, captionWindow controls when it is visible; omitting captionWindow preserves hook-only visibility."),
     captionPosition: z.enum(["top", "middle", "bottom"]).optional(),
     captionStyle: captionStyleSchema.optional(),
+    captionWindow: clipTrimSchema
+        .optional()
+        .describe("hook_demo: visibility window in ms on the FINAL stitched video timeline. Omit for legacy hook-only visibility; use {startMs: 0} for the whole video, or set both bounds for any interval."),
     hookId: z.string().optional().describe("hook_demo: hook clip id from list_hooks (required)"),
     demoVideoId: z
         .string()
@@ -393,6 +403,18 @@ register("create_video", "Render a short-form (9:16) video from library ingredie
         .min(0)
         .optional()
         .describe("hook_demo: start the background track this many ms in (default 0). The played length always equals the video's duration; clamped so the window fits the track."),
+    audioVolume: z
+        .number()
+        .min(0)
+        .max(1)
+        .optional()
+        .describe("hook_demo: mix level of the background track, 0..1 (default 0.3). Requires musicId/soundId."),
+    originalVolume: z
+        .number()
+        .min(0)
+        .max(1)
+        .optional()
+        .describe("hook_demo: mix level of the clips' own audio, 0..1 (default 1). Use 0 to replace the original sound with the background track entirely."),
     greenScreenId: z.string().optional().describe("green_screen_meme: clip id from list_green_screens (required)"),
     backgroundId: z.string().optional().describe("green_screen_meme: image id from list_backgrounds (required)"),
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@post-ripple/mcp",
-  "version": "0.13.0",
+  "version": "0.15.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": {