@clipform/mcp-server 1.7.0 → 1.8.1

package/dist/prompts.js

@@ -27,7 +27,7 @@ export function registerPrompts(server) {
 3. **Create the form** with clipform_create_form:
    - show_step_counter: true
    - disable_back_navigation: true
-4. **Add questions** with clipform_add_question (type: "choice"):
+4. **Add questions** with clipform_add_node (type: "choice"):
    - config: { choice: { show_answer_feedback: true } }
    - randomise_options: true in config
    - score: 1 on correct option, score: 0 on wrong
@@ -36,10 +36,20 @@ export function registerPrompts(server) {
 6. **Build video** for each question:
    - clipform_search_media (kind: "image") - 3 images per question
    - clipform_generate_video - creates Ken Burns video synced to audio
-7. **Attach media** with clipform_upload_question_media. Include captions, set show_captions: true.
-8. **Update end screen** - set show_score: true, icon: "trophy", and score_ranges for personalised messages
+7. **Attach media** with clipform_upload_node_media. Include captions, set show_captions: true.
+8. **Update end screen** with clipform_update_node - EVERY quiz must have:
+   - show_score: true, icon: "trophy"
+   - show_share_button: true (drives virality)
+   - cta_type: "restart", cta_text: a short challenge like "Beat your score?" or "Try again?"
+   - score_ranges with personalised title + message per tier. Write these in the quiz's voice - short, punchy, and specific to the topic (not generic "Good job!"). Example for a geography quiz:
+     \`\`\`json
+     { "min": 0, "max": 2, "title": "Lost Tourist", "message": "You might need a map - and a compass." },
+     { "min": 3, "max": 5, "title": "Frequent Flyer", "message": "Not bad! You know your way around." },
+     { "min": 6, "max": 8, "title": "World Explorer", "message": "Impressive - you really know your stuff." }
+     \`\`\`
 9. **Publish** with clipform_update_form
-10. **Log** with clipform_log_generation (sources, images, attributions)
+10. **Tag the form** - pass tags: one format (quiz/survey/interview/feedback/lead-gen), one genre (trivia/personality/nps/poll/testimonial), and 2-3 topic words
+11. **Log** with clipform_log_generation (sources, images, attributions)
 
 ## Before building, ask
 
@@ -82,26 +92,34 @@ There are NO correct answers. Each option maps to one or more outcome categories
 3. **Create the form** with clipform_create_form:
    - show_step_counter: true
    - disable_back_navigation: true
-4. **Add questions** with clipform_add_question (type: "choice"):
+4. **Add questions** with clipform_add_node (type: "choice"):
    - config: { choice: { show_answer_feedback: false } } (no right/wrong!)
    - Do NOT set randomise_options (option order matters for personality quizzes - lead with the most appealing)
    - Each option gets \`scores: { "CategoryA": 2, "CategoryB": 1 }\` - weight towards relevant categories
    - Every option should score in at least one category (no dead options)
 5. **Generate narration** with clipform_generate_tts - conversational, reflective tone. "What does this say about you?" not "Do you know the answer?"
 6. **Build video** + **attach media** (same as knowledge quiz workflow)
-7. **Update end screen** with scoring_results (NOT score_ranges):
+7. **Update end screen** with clipform_update_node - EVERY personality quiz must have:
+   - show_score: false, icon: "star"
+   - show_share_button: true (personality results are inherently shareable - "I got X, what did you get?")
+   - cta_type: "restart", cta_text: "Find out again?" or "Take it again?"
+   - scoring_results (NOT score_ranges) with a result per category. Write the title as an identity reveal ("You're a Creative!") and the message as a short, flattering description that makes people want to share it. Be specific to the quiz theme, not generic. Example:
    \`\`\`json
    {
      "show_score": false,
      "icon": "star",
+     "show_share_button": true,
+     "cta_type": "restart",
+     "cta_text": "Retake quiz",
      "scoring_results": [
-       { "category": "Creative", "title": "You're a Creative!", "message": "You see the world differently..." },
-       { "category": "Analytical", "title": "You're an Analyst!", "message": "You love digging into the details..." }
+       { "category": "Creative", "title": "You're a Creative!", "message": "You see the world through colour and possibility. Where others see problems, you see raw material." },
+       { "category": "Analytical", "title": "You're an Analyst!", "message": "You don't guess - you figure it out. Your superpower is turning chaos into clarity." }
      ]
    }
    \`\`\`
 8. **Publish** with clipform_update_form
-9. **Log** with clipform_log_generation
+9. **Tag the form** - pass tags: one format (quiz/survey/interview/feedback/lead-gen), one genre (trivia/personality/nps/poll/testimonial), and 2-3 topic words
+10. **Log** with clipform_log_generation
 
 ## Before building, ask
 
@@ -146,6 +164,7 @@ There are NO correct answers. Each option maps to one or more outcome categories
 7. **Update end screen** - set expectations: "Thanks! We'll be in touch."
 8. **Optional: add narration** - warm, inviting tone. "We'd love to hear your story..."
 9. **Publish** with clipform_update_form
+10. **Tag the form** - pass tags: one format (quiz/survey/interview/feedback/lead-gen), one genre (trivia/personality/nps/poll/testimonial), and 2-3 topic words
 
 ## Before building, ask
 
@@ -189,6 +208,7 @@ There are NO correct answers. Each option maps to one or more outcome categories
 6. **Contact** (optional) - only if you need to follow up. Many surveys work better anonymous.
 7. **Update end screen** - "Thanks for your feedback!"
 8. **Publish** with clipform_update_form
+9. **Tag the form** - pass tags: one format (quiz/survey/interview/feedback/lead-gen), one genre (trivia/personality/nps/poll/testimonial), and 2-3 topic words
 
 ## Key rule: 5 questions max. Every extra question costs completions.
 
@@ -230,10 +250,11 @@ There are NO correct answers. Each option maps to one or more outcome categories
    - disable_back_navigation: true (prevents answer shopping that breaks scoring)
 3. **Add hook question** (type: "choice") - "What best describes you?" or "What are you looking for?" This segments the user.
 4. **Add qualifying questions** (type: "choice") - 2-3 questions that narrow down the need. Assign scores to each option.
-5. **Set branching logic** with clipform_set_question_logic - route based on answers
+5. **Set branching logic** with clipform_set_logic - route based on answers
 6. **Add contact capture** (type: "contact") - name, email, phone. Place AFTER qualifying questions.
 7. **Update end screen** with score_ranges for personalised outcomes: "Based on your answers, we recommend..."
 8. **Publish** with clipform_update_form
+9. **Tag the form** - pass tags: one format (quiz/survey/interview/feedback/lead-gen), one genre (trivia/personality/nps/poll/testimonial), and 2-3 topic words
 
 ## Key rule: 3-5 questions max. Every extra step loses leads.
 

package/dist/prompts.js.map

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

package/dist/resources.js

@@ -25,7 +25,7 @@ const MEDIA_WORKFLOW = `## Media Workflow
 1. **clipform_generate_tts** - narration audio (returns word-level captions)
 2. **clipform_search_media** (kind: "image") - find 3 images per question
 3. **clipform_generate_video** - Ken Burns video from images + audio
-4. **clipform_upload_question_media** - attach video with captions (set show_captions: true)
+4. **clipform_upload_node_media** - attach video with captions (set show_captions: true)
 
 **Image selection:**
 - ONLY use URLs from clipform_search_media results
@@ -287,7 +287,7 @@ Route people to the right outcome based on their answers. Lead qualification sco
 
 ## Branching Logic
 
-Use clipform_set_question_logic to route based on answers:
+Use clipform_set_logic to route based on answers:
 
 - **Segment early.** Q1 answer determines which Q2 they see.
 - **Converge at capture.** All branches should reach the contact collection step.
@@ -317,7 +317,7 @@ ${WRITING_PRINCIPLES}`,
         ],
     }));
     server.registerResource("context-session", "clipform://context/session", {
-        description: "Current session info: auth mode, workspace, plan tier, question limits, feature flags. Read this before planning content to know your constraints.",
+        description: "Current session info: auth mode, workspace, plan tier, node limits, feature flags. Read this before planning content to know your constraints.",
         mimeType: "text/markdown",
         annotations: { audience: ["assistant"], priority: 1.0 },
     }, async () => {

package/dist/resources.js.map

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

package/dist/server.js

@@ -1,19 +1,20 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 // Form CRUD tools
 import { registerCreateFormTool } from "./tools/create-form.js";
+import { registerListFormsTool } from "./tools/list-forms.js";
 import { registerGetFormTool } from "./tools/get-form.js";
 import { registerUpdateFormTool } from "./tools/update-form.js";
 import { registerDeleteFormTool } from "./tools/delete-form.js";
-// Question CRUD tools
-import { registerAddQuestionTool } from "./tools/add-question.js";
-import { registerUpdateQuestionTool } from "./tools/update-question.js";
-import { registerDeleteQuestionTool } from "./tools/delete-question.js";
-// Media management tools
-import { registerUploadQuestionMediaTool } from "./tools/upload-question-media.js";
-import { registerGetQuestionMediaTool } from "./tools/get-question-media.js";
-import { registerDeleteQuestionMediaTool } from "./tools/delete-question-media.js";
-import { registerSetQuestionLogicTool } from "./tools/set-question-logic.js";
-import { registerAttachQuestionAudioTool } from "./tools/attach-question-audio.js";
+// Node CRUD tools
+import { registerAddNodeTool } from "./tools/add-node.js";
+import { registerUpdateNodeTool } from "./tools/update-node.js";
+import { registerDeleteNodeTool } from "./tools/delete-node.js";
+// Node media & logic tools
+import { registerUploadNodeMediaTool } from "./tools/upload-node-media.js";
+import { registerGetNodeMediaTool } from "./tools/get-node-media.js";
+import { registerDeleteNodeMediaTool } from "./tools/delete-node-media.js";
+import { registerSetNodeLogicTool } from "./tools/set-node-logic.js";
+import { registerAttachNodeAudioTool } from "./tools/attach-node-audio.js";
 // Audit logging
 import { registerLogGenerationTool } from "./tools/log-generation.js";
 // Content research tools
@@ -27,29 +28,31 @@ import { registerSearchMusicTool } from "./tools/search-music.js";
 import { registerListCompositionsTool } from "./tools/list-compositions.js";
 import { registerListAssetsTool } from "./tools/list-assets.js";
 import { registerGenerateVideoTool } from "./tools/generate-video.js";
+import { registerCheckRenderTool } from "./tools/check-render.js";
 // Prompts & Resources
 import { registerPrompts } from "./prompts.js";
 import { registerResources } from "./resources.js";
 export function createServer() {
     const server = new McpServer({
         name: "clipform-mcp-server",
-        version: "1.5.1",
+        version: "1.8.0",
     });
     // Form CRUD
     registerCreateFormTool(server);
+    registerListFormsTool(server);
     registerGetFormTool(server);
     registerUpdateFormTool(server);
     registerDeleteFormTool(server);
-    // Question CRUD
-    registerAddQuestionTool(server);
-    registerUpdateQuestionTool(server);
-    registerDeleteQuestionTool(server);
-    // Media management
-    registerUploadQuestionMediaTool(server);
-    registerGetQuestionMediaTool(server);
-    registerDeleteQuestionMediaTool(server);
-    registerSetQuestionLogicTool(server);
-    registerAttachQuestionAudioTool(server);
+    // Node CRUD
+    registerAddNodeTool(server);
+    registerUpdateNodeTool(server);
+    registerDeleteNodeTool(server);
+    // Node media & logic
+    registerUploadNodeMediaTool(server);
+    registerGetNodeMediaTool(server);
+    registerDeleteNodeMediaTool(server);
+    registerSetNodeLogicTool(server);
+    registerAttachNodeAudioTool(server);
     // Audit logging
     registerLogGenerationTool(server);
     // Content research
@@ -63,6 +66,7 @@ export function createServer() {
     registerSearchMusicTool(server);
     registerListCompositionsTool(server);
     registerListAssetsTool(server);
+    registerCheckRenderTool(server);
     // Prompts & Resources
     registerPrompts(server);
     registerResources(server);

package/dist/server.js.map

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

package/dist/tools/add-node.d.ts

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

package/dist/tools/add-node.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import { NodeSchema, NODE_TYPES_DESCRIPTION } from "../lib/schemas.js";
+import { callApi, errorResult, textResult } from "../lib/api-client.js";
+import { fetchAndFormatFormState } from "../lib/format-form.js";
+export function registerAddNodeTool(server) {
+    server.registerTool("clipform_add_node", {
+        title: "Add Node",
+        description: `Add a new node to an existing form. By default, the node is inserted before the end screen (appended to the end of the flow). Use after_node_id to insert at a specific position.
+
+${NODE_TYPES_DESCRIPTION}
+
+All type definitions and config schemas are derived from @vid-master/config (answer-types).`,
+        inputSchema: {
+            form_id: z.string().uuid().describe("The form UUID (returned by clipform_create_form, not the short share_id from the URL)"),
+            question: NodeSchema.describe("The node to add"),
+            after_node_id: z
+                .string()
+                .optional()
+                .describe("Insert after this node ID. Omit to append before the end screen."),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ form_id, question, after_node_id }) => {
+        const body = { question };
+        if (after_node_id)
+            body.after_node_id = after_node_id;
+        const result = await callApi(`/forms/${form_id}/nodes`, {
+            method: "POST",
+            body,
+        });
+        if (!result.ok) {
+            return errorResult(result.error);
+        }
+        const confirmMsg = [
+            `Node added successfully!`,
+            `Node ID: ${result.data.node_id}`,
+            `Type: ${question.type}`,
+            `Prompt: ${question.prompt}`,
+        ].join("\n");
+        const formState = await fetchAndFormatFormState(form_id);
+        return textResult(formState ? `${confirmMsg}\n\n---\n\n${formState}` : confirmMsg);
+    });
+}
+//# sourceMappingURL=add-node.js.map

package/dist/tools/add-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-node.js","sourceRoot":"","sources":["../../src/tools/add-node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE;;EAEjB,sBAAsB;;4FAEoE;QACtF,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,uFAAuF,CAAC;YAC5H,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YAChD,aAAa,EAAE,CAAC;iBACb,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,kEAAkE,CACnE;SACJ;QACD,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE,EAAE;QAC7C,MAAM,IAAI,GAA4B,EAAE,QAAQ,EAAE,CAAC;QACnD,IAAI,aAAa;YAAE,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QAEtD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,OAAO,QAAQ,EAAE;YACtD,MAAM,EAAE,MAAM;YACd,IAAI;SACL,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,UAAU,GAAG;YACjB,0BAA0B;YAC1B,YAAY,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE;YACjC,SAAS,QAAQ,CAAC,IAAI,EAAE;YACxB,WAAW,QAAQ,CAAC,MAAM,EAAE;SAC7B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAAC,OAAO,CAAC,CAAC;QACzD,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,UAAU,cAAc,SAAS,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IACrF,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/attach-node-audio.d.ts

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

package/dist/tools/attach-node-audio.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { callApi, errorResult, textResult } from "../lib/api-client.js";
+export function registerAttachNodeAudioTool(server) {
+    server.registerTool("clipform_attach_audio", {
+        title: "Attach Audio to Node",
+        description: `Attach a sound effect or audio file to a node with existing media (stills only). The audio auto-plays once when a respondent reaches this node. Provide a public URL to the audio file (WAV, MP3, or OGG). The node must already have media uploaded (use clipform_upload_node_media first).`,
+        inputSchema: {
+            form_id: z.string().uuid().describe("The form UUID (returned by clipform_create_form, not the short share_id from the URL)"),
+            node_id: z
+                .string()
+                .describe("The node ID (must already have media attached)"),
+            url: z
+                .string()
+                .url()
+                .describe("Public URL to the audio file (WAV, MP3, or OGG)"),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ form_id, node_id, url }) => {
+        const result = await callApi(`/forms/${form_id}/nodes/${node_id}/audio`, {
+            method: "PUT",
+            body: { url },
+        });
+        if (!result.ok) {
+            return errorResult(result.error);
+        }
+        return textResult(`Audio attached to node ${node_id}.\n` +
+            `Audio path: ${result.data.audio_storage_path}`);
+    });
+}
+//# sourceMappingURL=attach-node-audio.js.map

package/dist/tools/attach-node-audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach-node-audio.js","sourceRoot":"","sources":["../../src/tools/attach-node-audio.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAExE,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IAC3D,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,8RAA8R;QAC3S,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,uFAAuF,CAAC;YAC5H,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,CAAC,gDAAgD,CAAC;YAC7D,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,CAAC,iDAAiD,CAAC;SAC/D;QACD,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE;QAClC,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,UAAU,OAAO,UAAU,OAAO,QAAQ,EAC1C;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,EAAE,GAAG,EAAE;SACd,CACF,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QAED,OAAO,UAAU,CACf,0BAA0B,OAAO,KAAK;YACpC,eAAe,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAClD,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/{add-question.d.ts → check-render.d.ts}

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

package/dist/tools/check-render.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import { errorResult, textResult } from "../lib/api-client.js";
+import { getJob, pruneJobs, RENDER_TIMING } from "../lib/render-jobs.js";
+export function registerCheckRenderTool(server) {
+    server.registerTool("clipform_check_render", {
+        title: "Check Render Status",
+        description: `Check the status of a render job started by clipform_generate_video, clipform_generate_slideshow, or clipform_render_composition.
+
+Returns the current status and, when complete, the output URL. If still rendering, wait ${RENDER_TIMING.pollDelay} before checking again.`,
+        inputSchema: {
+            job_id: z.string().uuid().describe("The job ID returned by the render tool"),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async ({ job_id }) => {
+        pruneJobs();
+        const job = getJob(job_id);
+        if (!job) {
+            return errorResult(`No render job found with ID ${job_id}. Jobs expire after 30 minutes.`);
+        }
+        if (job.status === "rendering") {
+            const elapsed = Math.round((Date.now() - job.createdAt) / 1000);
+            return textResult([
+                `Status: rendering (${elapsed}s elapsed)`,
+                `Tool: ${job.tool}`,
+                ``,
+                `Still in progress. Check again in ${RENDER_TIMING.pollDelay}.`,
+            ].join("\n"));
+        }
+        if (job.status === "failed") {
+            return errorResult(`Render failed: ${job.error}`);
+        }
+        const data = job.result;
+        return textResult([
+            `Status: complete`,
+            `Tool: ${job.tool}`,
+            ``,
+            ...(data.public_url ? [`Public URL: ${data.public_url}`] : []),
+            ...(data.storage_path ? [`Storage path: ${data.storage_path}`] : []),
+            ...(data.duration_seconds ? [`Duration: ${data.duration_seconds}s`] : []),
+            ...(data.outputPath ? [`Output: ${data.outputPath}`] : []),
+            ...(data.format ? [`Format: ${data.format}`] : []),
+            ``,
+            `Use clipform_upload_node_media with the public URL to attach this video to a node.`,
+        ].join("\n"));
+    });
+}
+//# sourceMappingURL=check-render.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"check-render.js","sourceRoot":"","sources":["../../src/tools/check-render.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEzE,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE;;0FAEuE,aAAa,CAAC,SAAS,yBAAyB;QACpI,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;SAC7E;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,MAAM,EAAE,EAAE,EAAE;QACnB,SAAS,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAE3B,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,WAAW,CAAC,+BAA+B,MAAM,iCAAiC,CAAC,CAAC;QAC7F,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;YAChE,OAAO,UAAU,CACf;gBACE,sBAAsB,OAAO,YAAY;gBACzC,SAAS,GAAG,CAAC,IAAI,EAAE;gBACnB,EAAE;gBACF,qCAAqC,aAAa,CAAC,SAAS,GAAG;aAChE,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;QACJ,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO,WAAW,CAAC,kBAAkB,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,IAAI,GAAG,GAAG,CAAC,MAAa,CAAC;QAC/B,OAAO,UAAU,CACf;YACE,kBAAkB;YAClB,SAAS,GAAG,CAAC,IAAI,EAAE;YACnB,EAAE;YACF,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,iBAAiB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACpE,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAClD,EAAE;YACF,oFAAoF;SACrF,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/create-form.js

@@ -1,13 +1,13 @@
 import { z } from "zod";
 import { BUSINESS } from "@vid-master/config";
-import { QuestionSchema, QUESTION_TYPES_DESCRIPTION, } from "../lib/schemas.js";
+import { NodeSchema, NODE_TYPES_DESCRIPTION, } from "../lib/schemas.js";
 import { callApi, errorResult, textResult } from "../lib/api-client.js";
 export function registerCreateFormTool(server) {
     server.registerTool("clipform_create_form", {
         title: "Create Clipform",
-        description: `Create a new Clipform (interactive video-style form). Returns a viewer URL plus, for anonymous (non-OAuth) sessions, an edit_token and claim URL. When connected via an authenticated MCP client (e.g. claude.ai), the form lands directly in the user's workspace and no edit_token is issued.
+        description: `Create a new Clipform (interactive video-style form). Returns a viewer URL and form ID. When connected via an authenticated MCP client (e.g. claude.ai), the form lands directly in the user's workspace. Anonymous sessions get a claim URL to transfer ownership later.
 
-${QUESTION_TYPES_DESCRIPTION}
+${NODE_TYPES_DESCRIPTION}
 
 All type definitions and config schemas are derived from @vid-master/config (answer-types). Refer to the config descriptions above for the correct keys and shapes.
 
@@ -23,7 +23,7 @@ Example: A form that asks a question, collects contact info, then finishes:
         inputSchema: {
             title: z.string().describe("Form title"),
             questions: z
-                .array(QuestionSchema)
+                .array(NodeSchema)
                 .min(1)
                 .describe("Ordered list of questions/steps"),
             show_step_counter: z
@@ -50,6 +50,10 @@ Example: A form that asks a question, collects contact info, then finishes:
                 .boolean()
                 .optional()
                 .describe("Auto-play video when embedded (default: false). When off, embeds show a thumbnail + play button."),
+            tags: z
+                .array(z.string())
+                .optional()
+                .describe("Tags for indexing (e.g. ['quiz', 'trivia', 'arsenal']). Include format, genre, and topics."),
         },
         annotations: {
             readOnlyHint: false,
@@ -57,7 +61,7 @@ Example: A form that asks a question, collects contact info, then finishes:
             idempotentHint: false,
             openWorldHint: true,
         },
-    }, async ({ title, questions, show_step_counter, disable_back_navigation, primary_color, background_color, font_family, embed_autoplay }) => {
+    }, async ({ title, questions, show_step_counter, disable_back_navigation, primary_color, background_color, font_family, embed_autoplay, tags }) => {
         // 0. Pre-flight: resolve the caller's plan and reject up-front if the
         // requested question count exceeds it. Without this we'd build a
         // scaffold + N-1 questions, then 403 on the Nth, leaving an orphan.
@@ -66,39 +70,41 @@ Example: A form that asks a question, collects contact info, then finishes:
         // thin and never duplicates limit numbers.
         let planContext = null;
         const meResult = await callApi("/me", { method: "GET" });
-        if (meResult.ok) {
-            const me = meResult.data;
-            planContext = {
-                auth_mode: me.auth_mode,
-                workspace_name: me.workspace?.name ?? null,
-                plan_name: me.plan?.name ?? "Free",
-                node_limit: me.plan?.node_limit ?? null,
-            };
-            // questions includes any end_screen the user supplied; the scaffold
-            // already has one so we count "real" content nodes only.
-            const contentCount = questions.filter((q) => q.type !== "end_screen").length;
-            if (planContext.node_limit !== null && contentCount > planContext.node_limit) {
-                const upgradeUrl = `${BUSINESS.urls.dashboard}/billing`;
-                const message = planContext.auth_mode === "oauth"
-                    ? `Your '${planContext.workspace_name}' workspace is on the ${planContext.plan_name} plan, capped at ${planContext.node_limit} questions per form. You asked for ${contentCount}. Either rerun with ${planContext.node_limit} questions or upgrade at ${upgradeUrl}.`
-                    : `Anonymous sessions are capped at ${planContext.node_limit} questions per form (${planContext.plan_name} plan). You asked for ${contentCount}. Either rerun with ${planContext.node_limit} questions, or connect your Clipform account in claude.ai → Settings → Connectors so forms land in your workspace with your real plan limits.`;
-                return errorResult(message);
-            }
+        if (!meResult.ok) {
+            return errorResult(`Unable to determine workspace: ${meResult.error}`);
+        }
+        const me = meResult.data;
+        const workspaceId = me.workspace?.id ?? null;
+        if (!workspaceId) {
+            return errorResult("No workspace available. Connect your Clipform account in claude.ai → Settings → Connectors, or ensure MCP_WORKSPACE_ID is configured for anonymous mode.");
+        }
+        planContext = {
+            auth_mode: me.auth_mode,
+            workspace_id: workspaceId,
+            workspace_name: me.workspace?.name ?? null,
+            plan_name: me.plan?.name ?? "Free",
+            node_limit: me.plan?.node_limit ?? null,
+        };
+        // questions includes any end_screen the user supplied; the scaffold
+        // already has one so we count "real" content nodes only.
+        const contentCount = questions.filter((q) => q.type !== "end_screen").length;
+        if (planContext.node_limit !== null && contentCount > planContext.node_limit) {
+            const upgradeUrl = `${BUSINESS.urls.dashboard}/billing`;
+            const message = planContext.auth_mode === "oauth"
+                ? `Your '${planContext.workspace_name}' workspace is on the ${planContext.plan_name} plan, capped at ${planContext.node_limit} questions per form. You asked for ${contentCount}. Either rerun with ${planContext.node_limit} questions or upgrade at ${upgradeUrl}.`
+                : `Anonymous sessions are capped at ${planContext.node_limit} questions per form (${planContext.plan_name} plan). You asked for ${contentCount}. Either rerun with ${planContext.node_limit} questions, or connect your Clipform account in claude.ai → Settings → Connectors so forms land in your workspace with your real plan limits.`;
+            return errorResult(message);
         }
         // 1. Create bare scaffold
         const createResult = await callApi("/forms", {
             method: "POST",
-            body: { title },
+            body: { title, workspace_id: workspaceId },
         });
         if (!createResult.ok) {
             return errorResult(createResult.error);
         }
         const { data } = createResult;
         const formId = data.form_id;
-        // edit_token is null when the request is OAuth-authenticated (the user
-        // owns the form via their workspace and no per-form secret is needed).
-        // For anonymous local sessions it carries the per-form capability token.
-        const editToken = data.edit_token ?? undefined;
         const claimUrl = data.claim_url ?? undefined;
         // 2. Apply form settings and theme if provided
         const settingsBody = {};
@@ -118,7 +124,6 @@ Example: A form that asks a question, collects contact info, then finishes:
             await callApi(`/forms/${formId}`, {
                 method: "PATCH",
                 body: settingsBody,
-                token: editToken,
             });
         }
         // 3. Add each question via the add-question endpoint
@@ -128,26 +133,23 @@ Example: A form that asks a question, collects contact info, then finishes:
                 // The scaffold already has an end_screen — find it and update its prompt
                 const getResult = await callApi(`/forms/${formId}`, {
                     method: "GET",
-                    token: editToken,
                 });
                 if (getResult.ok) {
                     const questions_list = getResult.data.questions;
                     const endScreen = questions_list?.find((qq) => qq.type === "end_screen");
                     if (endScreen) {
-                        await callApi(`/forms/${formId}/questions/${endScreen.id}`, {
+                        await callApi(`/forms/${formId}/nodes/${endScreen.id}`, {
                             method: "PATCH",
                             body: { prompt: q.prompt, ...(q.config ? { config: q.config } : {}) },
-                            token: editToken,
                         });
                         continue;
                     }
                 }
                 // Fallback: add it normally if we couldn't find the default
             }
-            const addResult = await callApi(`/forms/${formId}/questions`, {
+            const addResult = await callApi(`/forms/${formId}/nodes`, {
                 method: "POST",
                 body: { question: q },
-                token: editToken,
             });
             if (!addResult.ok) {
                 return errorResult(`Failed to add question "${q.prompt}": ${addResult.error}`);
@@ -157,29 +159,27 @@ Example: A form that asks a question, collects contact info, then finishes:
         await callApi(`/forms/${formId}`, {
             method: "PATCH",
             body: { is_published: true },
-            token: editToken,
         });
+        // 5. Tag the form (best-effort)
+        if (tags && tags.length > 0) {
+            await callApi(`/forms/${formId}/tags`, {
+                method: "PUT",
+                body: { tags },
+            });
+        }
         const lines = [
             `Form created successfully!`,
             ``,
             `Title: ${title}`,
             `Questions: ${questions.length}`,
             `Form ID: ${formId}`,
+            ``,
+            `FORM URL (share this with respondents): ${data.viewer_url}`,
         ];
-        if (editToken) {
-            lines.push(`Edit Token: ${editToken}`);
-        }
-        lines.push(``, `FORM URL (share this with respondents): ${data.viewer_url}`);
         if (claimUrl) {
             lines.push(`CLAIM URL (transfer ownership to your account): ${claimUrl}`);
         }
-        lines.push(``, `IMPORTANT: Always show the user the exact URLs above — do not rewrite or modify them.`);
-        if (editToken) {
-            lines.push(`Save the form_id and edit_token — you need both for all subsequent operations (get_form, add_question, upload_question_media, etc.).`, `The token expires when the user claims the form via the claim URL.`);
-        }
-        else {
-            lines.push(`The form is owned by your workspace - pass form_id alone on follow-up tools.`);
-        }
+        lines.push(``, `IMPORTANT: Always show the user the exact URLs above — do not rewrite or modify them.`, `Pass form_id on follow-up tools (get_form, add_node, upload_node_media, etc.).`);
         // One-line plan/auth summary so the model can mention it ONCE and not
         // re-prompt on every follow-up call.
         if (planContext) {