@clipform/mcp-server 1.3.1 → 1.4.0

package/README.md

@@ -29,7 +29,7 @@ Add to your `claude_desktop_config.json`:
 }
 ```
 
-## What you can do
+## Tools
 
 ### Form & question management
 
@@ -37,7 +37,7 @@ Add to your `claude_desktop_config.json`:
 |------|-------------|
 | `clipform_create_form` | Create a new form with questions in one call |
 | `clipform_get_form` | View a form and all its questions |
-| `clipform_update_form` | Change title, publish status, or settings (step counter, back nav, embed autoplay, theme) |
+| `clipform_update_form` | Change title, publish status, or settings |
 | `clipform_delete_form` | Delete an unclaimed form |
 | `clipform_add_question` | Add a question to an existing form |
 | `clipform_update_question` | Update question text, type, config, or options |
@@ -52,36 +52,20 @@ Add to your `claude_desktop_config.json`:
 | `clipform_delete_question_media` | Remove media from a question |
 | `clipform_attach_question_audio` | Attach audio to a still-image question |
 | `clipform_set_question_logic` | Set branching logic on a question |
-| `clipform_log_generation` | Save an audit trail for generated forms |
 
-### Content research
+### Creative
 
 | Tool | Description |
 |------|-------------|
-| `clipform_search_news` | **Fallback** structured news lookup (NewsAPI + The Guardian) for clients that do not have a native web search tool. Used only for post-cutoff or uncertain facts; prefer your client's own web search if it has one. Timeless topics should be written from model knowledge without calling any research tool. |
+| `clipform_render_composition` | Render a Remotion composition to MP4, PNG, or GIF |
+| `clipform_generate_tts` | Generate narration audio with word-level captions |
+| `clipform_generate_slideshow` | Create Ken Burns slideshow videos from images + audio |
+| `clipform_search_media` | Search royalty-free images and videos |
+| `clipform_search_music` | Search royalty-free music and ambient sounds |
+| `clipform_list_compositions` | List available Remotion compositions and prop schemas |
+| `clipform_list_assets` | List available sound effects, animations, and fonts |
 
-> **Note:** Creative tools (TTS, slideshow generation, media search, rendering) have moved to `@clipform/mcp-server-creative` - a separate domain-scoped MCP server for video/audio production.
-
-### Guided prompts
-
-| Prompt | Description |
-|--------|-------------|
-| `create-quiz` | Best practices for building scored quizzes with media (supports per-category scoring and knockouts) |
-| `create-form` | Best practices for standard forms and surveys |
-| `create-journo-request` | Turn a journalist's callout into a Clipform |
-
-## Question types
-
-- **choice** - Multiple choice with single or multiple selection
-- **open** - Free-form text, audio, or video responses
-- **contact** - Collect name, email, phone, company, and more
-- **button** - Simple button for acknowledgment or navigation
-- **binary** - Two-option choice (yes/no, true/false, this vs that)
-- **scale** - Rating scale
-- **external_link** - Redirect to an external URL
-- **end_screen** - Customizable completion screen with score-based content (supports `score_ranges` for cumulative scoring and `scoring_results` for per-category recommendation quizzes)
-
-## Example prompt
+## Example
 
 > Create a Clipform called "Customer Feedback" with a choice question asking "How would you rate our service?" with options Excellent, Good, Fair, Poor, then an open-ended question asking "Any additional comments?", and finish with an end screen saying "Thanks for your feedback!"
 
@@ -94,4 +78,4 @@ Forms are created with a start node and end screen automatically - you just add
 ## Links
 
 - [Clipform](https://clipform.io) - Create interactive video forms
-- [Documentation](https://clipform.io/docs)
+- [Documentation](https://docs.clipform.io) - Full guide with question types, scoring, and more

package/dist/server.js

@@ -18,12 +18,17 @@ import { registerAttachQuestionAudioTool } from "./tools/attach-question-audio.j
 import { registerLogGenerationTool } from "./tools/log-generation.js";
 // Content research tools
 import { registerSearchNewsTool } from "./tools/search-news.js";
+// Creative tools
+import { registerRenderCompositionTool } from "./tools/render-composition.js";
+import { registerSearchMusicTool } from "./tools/search-music.js";
+import { registerListCompositionsTool } from "./tools/list-compositions.js";
+import { registerListAssetsTool } from "./tools/list-assets.js";
 // Prompts
 import { registerPrompts } from "./prompts.js";
 export function createServer() {
     const server = new McpServer({
         name: "clipform-mcp-server",
-        version: "1.3.0",
+        version: "1.4.0",
     });
     // Form CRUD
     registerCreateFormTool(server);
@@ -44,6 +49,11 @@ export function createServer() {
     registerLogGenerationTool(server);
     // Content research
     registerSearchNewsTool(server);
+    // Creative tools
+    registerRenderCompositionTool(server);
+    registerSearchMusicTool(server);
+    registerListCompositionsTool(server);
+    registerListAssetsTool(server);
     // Prompts
     registerPrompts(server);
     return server;

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,kBAAkB;AAClB,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,sBAAsB;AACtB,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAExE,yBAAyB;AACzB,OAAO,EAAE,+BAA+B,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,+BAA+B,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,+BAA+B,EAAE,MAAM,kCAAkC,CAAC;AAEnF,gBAAgB;AAChB,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,yBAAyB;AACzB,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,UAAU;AACV,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,YAAY;IACZ,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAE/B,gBAAgB;IAChB,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAEnC,mBAAmB;IACnB,+BAA+B,CAAC,MAAM,CAAC,CAAC;IACxC,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACrC,+BAA+B,CAAC,MAAM,CAAC,CAAC;IACxC,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACrC,+BAA+B,CAAC,MAAM,CAAC,CAAC;IAExC,gBAAgB;IAChB,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAElC,mBAAmB;IACnB,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAE/B,UAAU;IACV,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,kBAAkB;AAClB,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,sBAAsB;AACtB,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAExE,yBAAyB;AACzB,OAAO,EAAE,+BAA+B,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,+BAA+B,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,+BAA+B,EAAE,MAAM,kCAAkC,CAAC;AAEnF,gBAAgB;AAChB,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,yBAAyB;AACzB,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,iBAAiB;AACjB,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,UAAU;AACV,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,YAAY;IACZ,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAE/B,gBAAgB;IAChB,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAEnC,mBAAmB;IACnB,+BAA+B,CAAC,MAAM,CAAC,CAAC;IACxC,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACrC,+BAA+B,CAAC,MAAM,CAAC,CAAC;IACxC,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACrC,+BAA+B,CAAC,MAAM,CAAC,CAAC;IAExC,gBAAgB;IAChB,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAElC,mBAAmB;IACnB,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAE/B,iBAAiB;IACjB,6BAA6B,CAAC,MAAM,CAAC,CAAC;IACtC,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACrC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAE/B,UAAU;IACV,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/list-assets.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerListAssetsTool(server: McpServer): void;

package/dist/tools/list-assets.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import { callInternalApi, errorResult, textResult } from "../lib/api-client.js";
+export function registerListAssetsTool(server) {
+    server.registerTool("clipform_list_assets", {
+        title: "List Assets",
+        description: `List available creative assets (sound effects, animations, fonts). Use this to discover what assets are available for use in compositions.`,
+        inputSchema: {
+            type: z.enum(["sfx", "animation", "font", "all"]).default("all").optional()
+                .describe("Asset type to list (default: all)"),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async ({ type }) => {
+        const result = await callInternalApi("/internal/creative/assets", {
+            method: "GET",
+            params: { type: type ?? "all" },
+        });
+        if (!result.ok)
+            return errorResult(result.error);
+        const data = result.data;
+        const lines = [];
+        if (data.sfx?.length) {
+            lines.push(`## Sound Effects (${data.sfx.length})\n`);
+            for (const sfx of data.sfx) {
+                lines.push(`- ${sfx.name}: ${sfx.description || sfx.path}`);
+            }
+            lines.push("");
+        }
+        if (data.animations?.length) {
+            lines.push(`## Animations (${data.animations.length})\n`);
+            for (const anim of data.animations) {
+                lines.push(`- ${anim.name}: ${anim.description || anim.path}`);
+            }
+            lines.push("");
+        }
+        if (data.fonts?.length) {
+            lines.push(`## Fonts (${data.fonts.length})\n`);
+            for (const font of data.fonts) {
+                lines.push(`- ${font.name}: weights ${font.weights?.join(", ") || "default"}`);
+            }
+            lines.push("");
+        }
+        return textResult(lines.length ? lines.join("\n") : "No assets found.");
+    });
+}
+//# sourceMappingURL=list-assets.js.map

package/dist/tools/list-assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-assets.js","sourceRoot":"","sources":["../../src/tools/list-assets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEhF,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,4IAA4I;QACzJ,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;iBACxE,QAAQ,CAAC,mCAAmC,CAAC;SACjD;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KACxG,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,2BAA2B,EAAE;YAChE,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,IAAI,KAAK,EAAE;SAChC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEjD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAW,CAAC;QAChC,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,IAAI,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,qBAAqB,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC;YACtD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9D,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC;YAC1D,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACnC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACjE,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;YAChD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,aAAa,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC;YACjF,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,OAAO,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAC1E,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/list-compositions.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerListCompositionsTool(server: McpServer): void;

package/dist/tools/list-compositions.js

@@ -0,0 +1,30 @@
+import { callInternalApi, errorResult, textResult } from "../lib/api-client.js";
+export function registerListCompositionsTool(server) {
+    server.registerTool("clipform_list_compositions", {
+        title: "List Compositions",
+        description: `List all available Remotion compositions and their expected props schemas. Use this to discover what compositions can be rendered with clipform_render_composition.`,
+        inputSchema: {},
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async () => {
+        const result = await callInternalApi("/internal/creative/compositions", {
+            method: "GET",
+        });
+        if (!result.ok)
+            return errorResult(result.error);
+        const compositions = result.data.compositions;
+        if (!compositions.length)
+            return textResult("No compositions found.");
+        const lines = [`Available compositions (${compositions.length}):\n`];
+        for (const comp of compositions) {
+            lines.push(`## ${comp.id}`);
+            lines.push(`  Duration: ${comp.durationInFrames} frames @ ${comp.fps}fps (${(comp.durationInFrames / comp.fps).toFixed(1)}s)`);
+            lines.push(`  Size: ${comp.width}x${comp.height}`);
+            if (comp.defaultProps) {
+                lines.push(`  Default props: ${JSON.stringify(comp.defaultProps, null, 2)}`);
+            }
+            lines.push("");
+        }
+        return textResult(lines.join("\n"));
+    });
+}
+//# sourceMappingURL=list-compositions.js.map

package/dist/tools/list-compositions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-compositions.js","sourceRoot":"","sources":["../../src/tools/list-compositions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEhF,MAAM,UAAU,4BAA4B,CAAC,MAAiB;IAC5D,MAAM,CAAC,YAAY,CACjB,4BAA4B,EAC5B;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,qKAAqK;QAClL,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KACxG,EACD,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,iCAAiC,EAAE;YACtE,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEjD,MAAM,YAAY,GAAI,MAAM,CAAC,IAAY,CAAC,YAAqB,CAAC;QAChE,IAAI,CAAC,YAAY,CAAC,MAAM;YAAE,OAAO,UAAU,CAAC,wBAAwB,CAAC,CAAC;QAEtE,MAAM,KAAK,GAAG,CAAC,2BAA2B,YAAY,CAAC,MAAM,MAAM,CAAC,CAAC;QACrE,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,gBAAgB,aAAa,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC/H,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YACnD,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtB,KAAK,CAAC,IAAI,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YAC/E,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QACD,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACtC,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/render-composition.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerRenderCompositionTool(server: McpServer): void;

package/dist/tools/render-composition.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+import { callInternalApi, errorResult, textResult } from "../lib/api-client.js";
+export function registerRenderCompositionTool(server) {
+    server.registerTool("clipform_render_composition", {
+        title: "Render Composition",
+        description: `Render a Remotion composition to MP4, PNG, or GIF. Pass the composition ID and its expected props. Use clipform_list_compositions to discover available compositions and their prop schemas.
+
+Output formats:
+- mp4: Video file (H.264 codec, best for social media)
+- png: Still image (single frame)
+- gif: Animated GIF (looping)
+
+The render runs server-side and returns the output file path.`,
+        inputSchema: {
+            compositionId: z.string().describe("The composition ID (e.g. 'ScorecardQuiz', 'ShortFormQuiz', 'PresenterDirected')"),
+            outputFormat: z.enum(["mp4", "png", "gif"]).default("mp4").describe("Output format (default: mp4)"),
+            inputProps: z.record(z.unknown()).optional().describe("Props object matching the composition's expected schema"),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+    }, async ({ compositionId, outputFormat, inputProps }) => {
+        const result = await callInternalApi("/internal/creative/render", {
+            body: {
+                compositionId,
+                outputFormat,
+                inputProps: inputProps ?? {},
+            },
+        });
+        if (!result.ok)
+            return errorResult(result.error);
+        const data = result.data;
+        return textResult([
+            `Render complete.`,
+            ``,
+            `Composition: ${compositionId}`,
+            `Format: ${data.format}`,
+            `Output: ${data.outputPath}`,
+            ...(data.publicUrl ? [`Public URL: ${data.publicUrl}`] : []),
+        ].join("\n"));
+    });
+}
+//# sourceMappingURL=render-composition.js.map

package/dist/tools/render-composition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-composition.js","sourceRoot":"","sources":["../../src/tools/render-composition.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEhF,MAAM,UAAU,6BAA6B,CAAC,MAAiB;IAC7D,MAAM,CAAC,YAAY,CACjB,6BAA6B,EAC7B;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE;;;;;;;8DAO2C;QACxD,WAAW,EAAE;YACX,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iFAAiF,CAAC;YACrH,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC;YACnG,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;SACjH;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE;KAC1G,EACD,KAAK,EAAE,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,EAAE,EAAE;QACpD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,2BAA2B,EAAE;YAChE,IAAI,EAAE;gBACJ,aAAa;gBACb,YAAY;gBACZ,UAAU,EAAE,UAAU,IAAI,EAAE;aAC7B;SACF,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEjD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAW,CAAC;QAChC,OAAO,UAAU,CACf;YACE,kBAAkB;YAClB,EAAE;YACF,gBAAgB,aAAa,EAAE;YAC/B,WAAW,IAAI,CAAC,MAAM,EAAE;YACxB,WAAW,IAAI,CAAC,UAAU,EAAE;YAC5B,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7D,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/search-music.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSearchMusicTool(server: McpServer): void;

package/dist/tools/search-music.js

@@ -0,0 +1,40 @@
+import { z } from "zod";
+import { callInternalApi, errorResult, textResult } from "../lib/api-client.js";
+export function registerSearchMusicTool(server) {
+    server.registerTool("clipform_search_music", {
+        title: "Search Music",
+        description: `Search for royalty-free music tracks and ambient sounds via Jamendo and Freesound. Returns download URLs for background music, quiz soundtracks, or ambient audio.`,
+        inputSchema: {
+            query: z.string().describe("What to search for (e.g. 'upbeat quiz background', 'calm ambient', 'playful pizzicato')"),
+            count: z.number().min(1).max(10).default(5).optional().describe("Max results (default: 5)"),
+            instrumentalOnly: z.boolean().optional().default(true).describe("Only instrumental tracks (default: true)"),
+            minDuration: z.number().optional().describe("Minimum duration in seconds"),
+            maxDuration: z.number().optional().describe("Maximum duration in seconds"),
+            tags: z.array(z.string()).optional().describe("Genre/mood tags to filter by"),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async ({ query, count, instrumentalOnly, minDuration, maxDuration, tags }) => {
+        const result = await callInternalApi("/internal/formgen/search-music", {
+            body: { query, count, instrumentalOnly, minDuration, maxDuration, tags },
+        });
+        if (!result.ok)
+            return errorResult(result.error);
+        const results = result.data.results;
+        if (!results.length)
+            return textResult(`No music found for "${query}".`);
+        const lines = [`Found ${results.length} tracks for "${query}":\n`];
+        for (const item of results) {
+            lines.push(`- ${item.title} by ${item.artist}`);
+            lines.push(`  URL: ${item.url}`);
+            if (item.duration)
+                lines.push(`  Duration: ${item.duration}s`);
+            if (item.source)
+                lines.push(`  Source: ${item.source}`);
+            if (item.license)
+                lines.push(`  License: ${item.license}`);
+            lines.push("");
+        }
+        return textResult(lines.join("\n"));
+    });
+}
+//# sourceMappingURL=search-music.js.map

package/dist/tools/search-music.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-music.js","sourceRoot":"","sources":["../../src/tools/search-music.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clipform/mcp-server",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "description": "MCP server for building and managing Clipform video forms",
   "license": "MIT",
   "homepage": "https://clipform.io",