@clipform/mcp-server 1.13.1 → 1.15.0

package/dist/auth-context.d.ts

@@ -12,8 +12,10 @@ interface McpAuthContext {
     user_id: string;
     workspace_id: string;
     scopes: string[];
+    tool_name?: string;
 }
 declare function runWithMcpAuth<T>(ctx: McpAuthContext, fn: () => Promise<T> | T): Promise<T> | T;
 declare function getMcpAuth(): McpAuthContext | undefined;
+declare function runWithMcpTool<T>(toolName: string, fn: () => Promise<T> | T): Promise<T> | T;
 
-export { type McpAuthContext, getMcpAuth, runWithMcpAuth };
+export { type McpAuthContext, getMcpAuth, runWithMcpAuth, runWithMcpTool };

package/dist/auth-context.js

@@ -1,9 +1,11 @@
 import {
   getMcpAuth,
-  runWithMcpAuth
-} from "./chunk-YEDU3G7I.js";
+  runWithMcpAuth,
+  runWithMcpTool
+} from "./chunk-VWGIVJMQ.js";
 export {
   getMcpAuth,
-  runWithMcpAuth
+  runWithMcpAuth,
+  runWithMcpTool
 };
 //# sourceMappingURL=auth-context.js.map

package/dist/{chunk-NW2BYSDR.js → chunk-2SPXROLZ.js}

@@ -2,8 +2,9 @@ import {
   __commonJS,
   __export,
   __toESM,
-  getMcpAuth
-} from "./chunk-YEDU3G7I.js";
+  getMcpAuth,
+  runWithMcpTool
+} from "./chunk-VWGIVJMQ.js";
 
 // ../../node_modules/@modelcontextprotocol/sdk/node_modules/ajv/dist/compile/codegen/code.js
 var require_code = __commonJS({
@@ -20906,7 +20907,7 @@ var NODE_TYPES = {
     shorthand: "Start",
     icon: "ArrowRight",
     color: "#D1FAE5",
-    description: "Entry point for the form - connects to the first question",
+    description: "Entry point for the form - connects to the first node",
     category: "start",
     sort_order: 0,
     has_options: false,
@@ -20927,11 +20928,12 @@ var NODE_TYPES = {
     shorthand: "Multi",
     icon: "CheckSquare",
     color: "#DBEAFE",
-    description: "Single or multiple choice questions with predefined options",
-    category: "question",
+    description: "Single or multiple choice node with predefined options",
+    category: "input",
     sort_order: 1,
     has_options: true,
     min_options: 1,
+    max_options: 6,
     max_option_length: 36,
     is_terminal: false,
     show_nav_bar: true,
@@ -21005,7 +21007,7 @@ var NODE_TYPES = {
           enum: ["upload", "recorded"],
           type: "string",
           label: "Content media type",
-          description: "How the question media was provided"
+          description: "How the node media was provided"
         }
       }
     },
@@ -21029,7 +21031,7 @@ var NODE_TYPES = {
     icon: "Type",
     color: "#DBEAFE",
     description: "Free-form text responses from users",
-    category: "question",
+    category: "input",
     sort_order: 2,
     has_options: false,
     is_terminal: false,
@@ -21065,7 +21067,7 @@ var NODE_TYPES = {
           enum: ["upload", "recorded"],
           type: "string",
           label: "Content media type",
-          description: "How the question media was provided"
+          description: "How the node media was provided"
         }
       }
     },
@@ -21129,8 +21131,8 @@ var NODE_TYPES = {
     shorthand: "Scale",
     icon: "BarChart3",
     color: "#DBEAFE",
-    description: "Numerical rating or scale questions (1-10, etc.)",
-    category: "question",
+    description: "Numerical rating or scale node (1-10, etc.)",
+    category: "input",
     sort_order: 3,
     has_options: false,
     is_terminal: false,
@@ -21205,7 +21207,7 @@ var NODE_TYPES = {
           }
         }
       ],
-      description: "Booking provider configuration (one provider per question)"
+      description: "Booking provider configuration (one provider per node)"
     },
     response_schema: {
       type: "object",
@@ -21399,7 +21401,7 @@ var NODE_TYPES = {
               size: { type: "integer", minimum: 1, description: "File size in bytes" },
               mime_type: { type: "string", description: "File MIME type" },
               uploaded_at: { type: "string", format: "date-time", description: "ISO timestamp of upload completion" },
-              storage_path: { type: "string", description: "Full storage path: workspace_id/form_id/question_id/uuid.ext" }
+              storage_path: { type: "string", description: "Full storage path: workspace_id/form_id/node_id/uuid.ext" }
             }
           },
           minItems: 1,
@@ -21496,7 +21498,7 @@ var NODE_TYPES = {
     icon: "CircleCheck",
     color: "#D1FAE5",
     description: "Two-option choice - yes/no, true/false, or this vs that",
-    category: "question",
+    category: "input",
     sort_order: 1.5,
     has_options: true,
     min_options: 2,
@@ -21534,7 +21536,7 @@ var NODE_TYPES = {
           enum: ["upload", "recorded"],
           type: "string",
           label: "Content media type",
-          description: "How the question media was provided"
+          description: "How the node media was provided"
         }
       }
     },
@@ -21558,7 +21560,7 @@ var NODE_TYPES = {
     icon: "RectangleHorizontal",
     color: "#DBEAFE",
     description: "Simple button for acknowledgment or navigation",
-    category: "question",
+    category: "input",
     sort_order: 3,
     has_options: true,
     min_options: 1,
@@ -21795,7 +21797,7 @@ var NODE_TYPES = {
     output_schema: null
   },
   end_screen: {
-    label: "End Screen",
+    label: "Ending",
     shorthand: "End",
     icon: "Flag",
     color: "#FEE2E2",
@@ -21807,7 +21809,7 @@ var NODE_TYPES = {
     show_nav_bar: false,
     loading: "eager",
     supports_prompt: false,
-    supports_media: true,
+    supports_media: false,
     is_system: false,
     is_active: true,
     default_config: null,
@@ -22235,6 +22237,7 @@ async function callApi(path, options = {}) {
     headers["Authorization"] = `Bearer ${INTERNAL_SECRET}`;
     headers["X-Mcp-User"] = mcpAuth.user_id;
     headers["X-Mcp-Workspace"] = mcpAuth.workspace_id;
+    if (mcpAuth.tool_name) headers["X-Mcp-Tool"] = mcpAuth.tool_name;
   } else if (_apiKey) {
     headers["Authorization"] = `Bearer ${_apiKey}`;
   }
@@ -22282,6 +22285,7 @@ async function callInternalApi(path, options = {}) {
     headers["Authorization"] = `Bearer ${INTERNAL_SECRET}`;
     headers["X-Mcp-User"] = mcpAuth.user_id;
     headers["X-Mcp-Workspace"] = mcpAuth.workspace_id;
+    if (mcpAuth.tool_name) headers["X-Mcp-Tool"] = mcpAuth.tool_name;
   } else if (_apiKey) {
     headers["Authorization"] = `Bearer ${_apiKey}`;
   } else if (INTERNAL_SECRET) {
@@ -22343,7 +22347,7 @@ All type definitions and config schemas are derived from @vid-master/config (ans
 Example: A form that asks a question, collects contact info, then finishes:
 {
   title: "Quick Survey",
-  questions: [
+  nodes: [
     { type: "open", prompt: "What's your biggest challenge?" },
     { type: "contact", prompt: "Leave your details", config: { fields: [{ id: "first_name", required: true }, { id: "email", required: true }] } },
     { type: "end_screen", prompt: "Thanks for your response!" }
@@ -22351,11 +22355,11 @@ Example: A form that asks a question, collects contact info, then finishes:
 }`,
       inputSchema: {
         title: external_exports.string().describe("Form title"),
-        questions: external_exports.array(NodeSchema).min(1).describe("Ordered list of questions/steps"),
+        nodes: external_exports.array(NodeSchema).min(1).describe("Ordered list of nodes/steps for the form"),
         show_step_counter: external_exports.boolean().optional().describe("Show step counter (e.g. '1/5'). Set true for quizzes."),
         disable_back_navigation: external_exports.boolean().optional().describe("Prevent going back. Set true for quizzes."),
-        primary_color: external_exports.string().optional().describe("Primary/brand color (hex or CSS color). Used for buttons and accents."),
-        background_color: external_exports.string().optional().describe("Background color (hex, rgba, or CSS color)."),
+        primary_color: external_exports.string().regex(/^#[0-9A-Fa-f]{6}$/).optional().describe("Primary/brand color as 6-digit hex (e.g. '#FF5500'). Used for buttons and accents."),
+        background_color: external_exports.string().regex(/^#[0-9A-Fa-f]{6}$/).optional().describe("Background color as 6-digit hex (e.g. '#1A1A2E')."),
         font_family: external_exports.string().optional().describe("Font family name (e.g. 'Inter', 'Roboto', 'Playfair Display')."),
         embed_autoplay: external_exports.boolean().optional().describe("Auto-play video when embedded (default: false). When off, embeds show a thumbnail + play button."),
         tags: external_exports.array(external_exports.string()).optional().describe("Tags for indexing (e.g. ['quiz', 'trivia', 'arsenal']). Include format, genre, and topics.")
@@ -22367,7 +22371,7 @@ Example: A form that asks a question, collects contact info, then finishes:
         openWorldHint: true
       }
     },
-    async ({ title, questions, show_step_counter, disable_back_navigation, primary_color, background_color, font_family, embed_autoplay, tags }) => {
+    async ({ title, nodes, show_step_counter, disable_back_navigation, primary_color, background_color, font_family, embed_autoplay, tags }) => {
       let planContext = null;
       const meResult = await callApi("/me", { method: "GET" });
       if (!meResult.ok) {
@@ -22387,10 +22391,10 @@ Example: A form that asks a question, collects contact info, then finishes:
         plan_name: me.plan?.name ?? "Free",
         node_limit: me.plan?.node_limit ?? null
       };
-      const contentCount = questions.filter((q) => q.type !== "end_screen").length;
+      const contentCount = nodes.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 \u2192 Settings \u2192 Connectors so forms land in your workspace with your real plan limits.`;
+        const message = planContext.auth_mode === "oauth" ? `Your '${planContext.workspace_name}' workspace is on the ${planContext.plan_name} plan, capped at ${planContext.node_limit} nodes per form. You asked for ${contentCount}. Either rerun with ${planContext.node_limit} nodes or upgrade at ${upgradeUrl}.` : `Anonymous sessions are capped at ${planContext.node_limit} nodes per form (${planContext.plan_name} plan). You asked for ${contentCount}. Either rerun with ${planContext.node_limit} nodes, or connect your Clipform account in claude.ai \u2192 Settings \u2192 Connectors so forms land in your workspace with your real plan limits.`;
         return errorResult(message);
       }
       const createResult = await callApi("/forms", {
@@ -22416,29 +22420,13 @@ Example: A form that asks a question, collects contact info, then finishes:
           body: settingsBody
         });
       }
-      for (const q of questions) {
-        if (q.type === "end_screen") {
-          const getResult = await callApi(`/forms/${formId}`, {
-            method: "GET"
-          });
-          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}/nodes/${endScreen.id}`, {
-                method: "PATCH",
-                body: { prompt: q.prompt, ...q.config ? { config: q.config } : {} }
-              });
-              continue;
-            }
-          }
-        }
+      for (const q of nodes) {
         const addResult = await callApi(`/forms/${formId}/nodes`, {
           method: "POST",
-          body: { question: q }
+          body: { node: q }
         });
         if (!addResult.ok) {
-          return errorResult(`Failed to add question "${q.prompt}": ${addResult.error}`);
+          return errorResult(`Failed to add node "${q.prompt}": ${addResult.error}`);
         }
       }
       await callApi(`/forms/${formId}`, {
@@ -22455,7 +22443,7 @@ Example: A form that asks a question, collects contact info, then finishes:
         `Form created successfully!`,
         ``,
         `Title: ${title}`,
-        `Questions: ${questions.length}`,
+        `Nodes: ${nodes.length}`,
         `Form ID: ${formId}`,
         ``,
         `FORM URL (share this with respondents): ${data.viewer_url}`
@@ -22469,7 +22457,7 @@ Example: A form that asks a question, collects contact info, then finishes:
         `Pass form_id on follow-up tools (get_form, add_node, upload_node_media, etc.).`
       );
       if (planContext) {
-        const limitNote = planContext.node_limit === null ? "unlimited questions" : `up to ${planContext.node_limit} questions per form`;
+        const limitNote = planContext.node_limit === null ? "unlimited nodes" : `up to ${planContext.node_limit} nodes per form`;
         if (planContext.auth_mode === "oauth") {
           lines.push(
             ``,
@@ -22554,7 +22542,7 @@ function registerListFormsTool(server) {
 
 // src/lib/format-form.ts
 function formatFormState(data) {
-  const questions = data.questions;
+  const nodes = data.nodes;
   const lines = [
     `Form: ${data.title}`,
     `Form ID: ${data.form_id}`,
@@ -22562,8 +22550,8 @@ function formatFormState(data) {
     ``,
     `Nodes (in order):`
   ];
-  for (let i = 0; i < questions.length; i++) {
-    const q = questions[i];
+  for (let i = 0; i < nodes.length; i++) {
+    const q = nodes[i];
     lines.push(`  ${i + 1}. [${q.type}] ${q.prompt || "(no prompt)"}`);
     lines.push(`     Node ID: ${q.id}`);
     if (q.required) lines.push(`     Required: yes`);
@@ -22590,7 +22578,7 @@ function registerGetFormTool(server) {
     "clipform_get_form",
     {
       title: "Get Clipform",
-      description: `Retrieve a form's details including all questions in sequential order. Use this to see the current state of a form before making changes.`,
+      description: `Retrieve a form's details including all nodes in sequential order. Use this to see the current state of a form before making changes.`,
       inputSchema: {
         form_id: external_exports.string().uuid().describe("The form UUID (returned by clipform_create_form, not the short share_id from the URL)")
       },
@@ -22625,8 +22613,8 @@ function registerUpdateFormTool(server) {
         show_step_counter: external_exports.boolean().optional().describe("Show step counter (e.g. '1/5'). Recommended for quizzes."),
         disable_back_navigation: external_exports.boolean().optional().describe("Prevent respondents from going back. Recommended for quizzes."),
         total_steps: external_exports.number().nullable().optional().describe("Override the total step count shown in the step counter. Set null to auto-calculate."),
-        primary_color: external_exports.string().optional().describe("Primary/brand color (hex or CSS color). Used for buttons and accents."),
-        background_color: external_exports.string().optional().describe("Background color (hex, rgba, or CSS color)."),
+        primary_color: external_exports.string().regex(/^#[0-9A-Fa-f]{6}$/).optional().describe("Primary/brand color as 6-digit hex (e.g. '#FF5500'). Used for buttons and accents."),
+        background_color: external_exports.string().regex(/^#[0-9A-Fa-f]{6}$/).optional().describe("Background color as 6-digit hex (e.g. '#1A1A2E')."),
         font_family: external_exports.string().optional().describe("Font family name (e.g. 'Inter', 'Roboto', 'Playfair Display')."),
         embed_autoplay: external_exports.boolean().optional().describe("Auto-play video when embedded (default: false). When off, embeds show a thumbnail + play button."),
         description: external_exports.string().nullable().optional().describe("SEO description (meta description, og:description). Set null to clear."),
@@ -22721,7 +22709,7 @@ function registerDeleteFormTool(server) {
     "clipform_delete_form",
     {
       title: "Delete Clipform",
-      description: `Permanently delete an unclaimed form and all its questions. This cannot be undone. Only works on forms that haven't been claimed yet.`,
+      description: `Permanently delete an unclaimed form and all its nodes. This cannot be undone. Only works on forms that haven't been claimed yet.`,
       inputSchema: {
         form_id: external_exports.string().uuid().describe("The form UUID to delete (returned by clipform_create_form, not the short share_id from the URL)")
       },
@@ -22757,7 +22745,7 @@ ${NODE_TYPES_DESCRIPTION}
 All type definitions and config schemas are derived from @vid-master/config (answer-types).`,
       inputSchema: {
         form_id: external_exports.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"),
+        node: NodeSchema.describe("The node to add"),
         after_node_id: external_exports.string().optional().describe(
           "Insert after this node ID. Omit to append before the end screen."
         )
@@ -22769,8 +22757,8 @@ All type definitions and config schemas are derived from @vid-master/config (ans
         openWorldHint: true
       }
     },
-    async ({ form_id, question, after_node_id }) => {
-      const body = { question };
+    async ({ form_id, node, after_node_id }) => {
+      const body = { node };
       if (after_node_id) body.after_node_id = after_node_id;
       const result = await callApi(`/forms/${form_id}/nodes`, {
         method: "POST",
@@ -22782,8 +22770,8 @@ All type definitions and config schemas are derived from @vid-master/config (ans
       const confirmMsg = [
         `Node added successfully!`,
         `Node ID: ${result.data.node_id}`,
-        `Type: ${question.type}`,
-        `Prompt: ${question.prompt}`
+        `Type: ${node.type}`,
+        `Prompt: ${node.prompt}`
       ].join("\n");
       const formState = await fetchAndFormatFormState(form_id);
       return textResult(formState ? `${confirmMsg}
@@ -22805,13 +22793,13 @@ function registerUpdateNodeTool(server) {
       inputSchema: {
         form_id: external_exports.string().uuid().describe("The form UUID (returned by clipform_create_form, not the short share_id from the URL)"),
         node_id: external_exports.string().describe("The node ID to update"),
-        prompt: external_exports.string().optional().describe("New question text"),
-        label: external_exports.string().optional().describe("Short label for the question (used in logic builder)"),
-        type: external_exports.enum(ACTIVE_NODE_TYPES).optional().describe("Change the question type"),
+        prompt: external_exports.string().optional().describe("New node prompt text"),
+        label: external_exports.string().optional().describe("Short label for the node (used in logic builder)"),
+        type: external_exports.enum(ACTIVE_NODE_TYPES).optional().describe("Change the node type"),
         required: external_exports.boolean().optional().describe("Whether an answer is required"),
         config: external_exports.record(external_exports.unknown()).optional().describe(CONFIG_DESCRIPTION),
         options: external_exports.array(OptionSchema).optional().describe(
-          "Replace all options (for choice questions). Omit to keep existing options."
+          "Replace all options (for choice nodes). Omit to keep existing options."
         )
       },
       annotations: {
@@ -22922,7 +22910,7 @@ var MediaItemSchema = external_exports.object({
       ).optional().describe("Per-word timestamps within the segment")
     })
   ).optional().describe("Word-level captions from clipform_generate_tts. Always include when uploading narrated video - pass the full objects including 'words' so per-word highlighting works."),
-  show_captions: external_exports.boolean().optional().default(true).describe("Display captions/subtitles on the question")
+  show_captions: external_exports.boolean().optional().default(true).describe("Display captions/subtitles on the node")
 });
 function registerUploadNodeMediaTool(server) {
   server.registerTool(
@@ -23421,8 +23409,8 @@ var v4_default = v4;
 var jobs = /* @__PURE__ */ new Map();
 var MAX_AGE_MS = 30 * 60 * 1e3;
 var RENDER_TIMING = {
-  expectedRange: "15-45 seconds",
-  pollDelay: "~10 seconds"
+  expectedRange: "15-120 seconds",
+  pollDelay: "~15 seconds"
 };
 function createJob(tool) {
   const job = {
@@ -23508,7 +23496,7 @@ You are the director. Every stylistic choice below is yours - defaults exist for
 1. Source images (use clipform_search_media with kind: "image"). Prefer portrait sources for 9:16 output; landscape works too via blur-pad fallback.
 2. Produce narration audio (clipform_generate_tts).
 3. Call this tool with images + audio_url + your creative direction.
-4. Attach the returned public URL to a question via clipform_upload_media with media_type "video".
+4. Attach the returned public URL to a node via clipform_upload_media with media_type "video".
 
 ## Image framing (per-image)
 
@@ -24620,9 +24608,9 @@ Each question is a micro variable-reward event - the same dopamine loop that kee
 
 For numeric questions (population, speed, weight), scale the real answer by random multipliers (0.3x to 3x) rounded to the same magnitude. Makes wrong answers plausible but clearly different.
 
-## Color Brain Questions (ColorSwatch composition)
+## Color Brain Questions (ColorCards composition)
 
-Inspired by the Color Brain board game - every answer is identified by its colours. Show flat colour chips, ask "what has these colours?". Use the \`ColorSwatch\` composition for the question card.
+Inspired by the Color Brain board game - every answer is identified by its colours. Show flat colour chips, ask "what has these colours?". Use the \`ColorCards\` composition for the question card.
 
 **Colour palette constraint:** Swatches are solid flat chips. Only use clearly distinguishable basic colours: red, blue, green, yellow, white, black, orange, purple, pink, brown, grey. No navy vs blue, no teal vs cyan - they look the same as flat chips. The skill is picking subjects where a combo of basic colours is unique enough to identify.
 
@@ -25008,6 +24996,14 @@ function createServer() {
     name: "clipform-mcp-server",
     version: MCP_VERSION
   });
+  const _registerTool = server.registerTool.bind(server);
+  server.registerTool = (name, config2, handler) => {
+    return _registerTool(
+      name,
+      config2,
+      (...args) => runWithMcpTool(name, () => handler(...args))
+    );
+  };
   registerCreateFormTool(server);
   registerListFormsTool(server);
   registerGetFormTool(server);
@@ -25044,4 +25040,4 @@ export {
   setApiKey,
   createServer
 };
-//# sourceMappingURL=chunk-NW2BYSDR.js.map
+//# sourceMappingURL=chunk-2SPXROLZ.js.map