@post-ripple/mcp 0.6.0 → 0.8.0

package/dist/index.js

@@ -45,7 +45,7 @@ function toEpochMs(value, field) {
     }
     return parsed;
 }
-const server = new McpServer({ name: "postripple", version: "0.6.0" });
+const server = new McpServer({ name: "postripple", version: "0.7.0" });
 function register(name, description, shape, transform) {
     server.tool(name, description, shape, async (args) => {
         try {
@@ -127,13 +127,13 @@ const slideTextStyleSchema = z
         .optional(),
     color: z.string().optional().describe("Text color (hex)"),
     treatment: z
-        .enum(["none", "shadow", "outline", "highlight"])
+        .enum(["none", "shadow", "outline", "highlight", "bar"])
         .optional()
-        .describe("'highlight' = solid box behind each line (classic TikTok caption)"),
+        .describe("'highlight' = solid box hugging each line (classic TikTok caption); 'bar' = full-width translucent band behind the text (subtitle look)"),
     accentColor: z
         .string()
         .optional()
-        .describe("Box color for 'highlight' / stroke color for 'outline' (hex)"),
+        .describe("Box color for 'highlight' / stroke color for 'outline' / band color for 'bar' (hex)"),
     fontScale: z.number().min(0.5).max(2.5).optional(),
     x: z.number().min(0).max(1).optional().describe("Anchor x (0..1 of canvas width)"),
     y: z.number().min(0).max(1).optional().describe("Top y (0..1 of canvas height)"),
@@ -200,6 +200,25 @@ register("list_images", "List or search the workspace's image library. Every ima
         .describe("Filter by origin (ignored when text is set)"),
     limit: z.number().min(1).max(200).optional().describe("Default 100, max 200"),
 });
+register("list_hooks", "List or search the shared HOOK VIDEO library — short vertical (9:16) clips (talking-head selfies, reactions, unboxings, B-roll) meant to open a short-form video. Each is auto-captioned + tagged by AI. Pass `text` for a keyword search over titles, tags, and AI captions (e.g. 'guy talking to camera', 'unboxing'); pass `tags` to require specific tags; omit both to list newest-first. Each result has a hookId, title, type ('ai' or 'human'), merged tags, aiCaption, and signed preview/video URLs (~1h). This library is shared platform-wide, not per-workspace.", {
+    text: z
+        .string()
+        .optional()
+        .describe("Keyword query over hook title, tags, description, and AI caption"),
+    tags: z
+        .array(z.string())
+        .optional()
+        .describe("Only hooks carrying ALL of these tags (human or AI tags)"),
+    type: z
+        .enum(["ai", "human"])
+        .optional()
+        .describe("Filter by origin: AI-generated or human-recorded"),
+    limit: z.number().min(1).max(200).optional().describe("Default 50, max 200"),
+});
+register("list_green_screens", "List the shared GREEN SCREEN clip library — talking/reacting people cut out on a green screen, composited over a background image by create_video (type 'green_screen_meme'). Each result has a greenScreenId, title, and signed preview/video URLs (~1h). Shared platform-wide, not per-workspace.", { limit: z.number().min(1).max(200).optional().describe("Default 50, max 200") });
+register("list_backgrounds", "List the shared BACKGROUND image library used behind green screen memes (create_video type 'green_screen_meme'). Each result has a backgroundId, title, and a signed image URL (~1h). Shared platform-wide, not per-workspace.", { limit: z.number().min(1).max(200).optional().describe("Default 50, max 200") });
+register("list_music", "List the platform MUSIC library — background tracks that can be laid over a hook+demo video (create_video type 'hook_demo', via musicId). Each result has a musicId, title, duration, and a signed audio URL (~1h). Shared platform-wide, not per-workspace.", { limit: z.number().min(1).max(200).optional().describe("Default 50, max 200") });
+register("get_creation", "Get the render status of a video created with create_video. Poll until status is 'completed' — the result then includes resultVideoId (publish it with schedule_post or add it to a group) plus signed video/preview URLs. status 'failed' includes the error.", { ...orgParam, creationId: z.string().describe("The creationId returned by create_video") });
 register("list_slideshows", "List photo-carousel slideshows with status ('draft' = still being composed, 'ready' = publishable) and a signed coverUrl thumbnail (first rendered slide, or a background for drafts).", { ...orgParam, limit: z.number().min(1).max(200).optional() });
 register("list_slideshow_templates", "List the slideshow layout templates: canvas size, each template's text slots with exact geometry (x/y anchor, maxWidth, fontSize, lineHeight — all normalized to the canvas) and defaults (font, color, treatment), the template's default overlay scrim, available fonts and text treatments, and the max slide count. Call before create_slideshow when composing template-based slides — use the slot geometry rather than inventing your own placement.", {});
 register("get_slideshow", "Get one slideshow in full detail: per-slide render state, each text field's text AND its style overrides (font, color, treatment, fontScale, x/y position, maxWidth, align, rotation — null style means the template slot defaults apply), the slide's overlay scrim, and signed image URLs (renderedUrl = the finished slide, backgroundUrl = the photo behind it; both expire in ~1h). Use it to study how existing slides are actually styled before composing new ones, or poll it after create_slideshow returns status 'rendering' — publish once status is 'ready'.", { ...orgParam, slideshowId: z.string() });
@@ -296,6 +315,55 @@ register("create_slideshow", "Create a photo slideshow (1-10 slides). Each slide
         .describe("Layout template id (see list_slideshow_templates). Default 'bold-bottom'; use 'blank' for custom-only text."),
     slides: z.array(slideSchema).min(1).max(10),
 });
+const captionStyleSchema = z
+    .object({
+    font: z
+        .enum(["classic", "impact", "serif", "typewriter", "handwriting"])
+        .optional(),
+    color: z.string().optional().describe("Text color, hex (default white)"),
+    treatment: z
+        .enum(["none", "shadow", "outline", "highlight", "bar"])
+        .optional()
+        .describe("'highlight' = box hugging each line; 'bar' = full-width translucent band behind the text (subtitle look)"),
+    accentColor: z
+        .string()
+        .optional()
+        .describe("Highlight box / outline stroke / 'bar' band color, hex"),
+    fontScale: z
+        .number()
+        .optional()
+        .describe("Multiplier on the base caption size (1 = default)"),
+    align: z.enum(["left", "center", "right"]).optional(),
+    x: z
+        .number()
+        .min(0)
+        .max(1)
+        .optional()
+        .describe("Free caption position: normalized center anchor (overrides captionPosition)"),
+    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.", {
+    ...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)"),
+    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."),
+    demoFileId: z
+        .string()
+        .optional()
+        .describe("hook_demo: raw uploaded file key from get_video_upload_url (alternative to demoVideoId)"),
+    musicId: z.string().optional().describe("hook_demo: optional background track from list_music"),
+    soundId: z.string().optional().describe("hook_demo: optional org-uploaded sound id (alternative to musicId)"),
+    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)"),
+});
 // ---- publish tools ----
 register("schedule_post", "Schedule a completed library video to publish on a connected account at a future time. This posts to a REAL social account when the time arrives. The platform is derived from the account. Uses one 'posts' credit (refunded if canceled). ALWAYS pass idempotencyKey (any unique string) so retries can't double-post. For TikTok, pass tiktokSettings to control privacy — omitting it publishes as private (SELF_ONLY). For YouTube, pass title.", {
     ...orgParam,

package/package.json

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