@clipform/mcp-server 1.29.0 → 1.31.0

package/README.md

@@ -55,7 +55,7 @@ You can also pass the key as a CLI flag: `npx -y @clipform/mcp-server --api-key=
 
 | Tool | Description |
 |------|-------------|
-| `clipform_create_form` | Create a new form with nodes, theming, and tags in one call |
+| `clipform_create_form` | Create a new form with nodes, theming, and tags in one call. Returns the created node IDs (structured output) so media steps need no follow-up lookup |
 | `clipform_list_forms` | List forms in your workspace with filtering and pagination |
 | `clipform_get_form` | View a form and all its nodes |
 | `clipform_update_form` | Change title, publish status, or settings |

package/dist/{chunk-5FG2V7B7.js → chunk-46RSQK6L.js}

@@ -6,14 +6,14 @@ import {
   getWorkflowText,
   objectType,
   registerPrompts
-} from "./chunk-6SFMF2AQ.js";
+} from "./chunk-ELO7KCMZ.js";
 import {
   GUIDE_TYPES,
   QUIZ_VARIANTS,
   getGuideContent,
   getGuideUri,
   registerResources
-} from "./chunk-B6ZWH3GD.js";
+} from "./chunk-J4KJN4C4.js";
 import {
   BUSINESS,
   CONTACT_FIELDS,
@@ -16988,6 +16988,8 @@ var PUBLIC_COMPOSITIONS = [
 ];
 var LABS_COMPOSITIONS = [
   "CountrySilhouetteClip",
+  "FourImageGrid",
+  "OddOneOutReveal",
   "FlagRevealGB",
   "FlagRevealJP",
   "FlagRevealBR",
@@ -17094,7 +17096,7 @@ var CONFIG_DESCRIPTION = (() => {
 var STYLE_PRESET_ENUM = external_exports.enum(KEN_BURNS_PRESETS).describe(`Ken Burns style preset: ${KEN_BURNS_PRESETS.join(", ")}`);
 var OptionSchema = external_exports.object({
   content: external_exports.string().describe("Option text"),
-  score: external_exports.number().optional().describe("Score value for this option (for scored quizzes). Use 1 for correct, 0 for wrong."),
+  score: external_exports.number().optional().describe("Score value for this option (for scored quizzes). Use 1 for correct, 0 for wrong. Scored options automatically enable correct-answer marking (record_scores) on the node."),
   scores: external_exports.record(external_exports.number()).optional().describe("Planned feature - category-based scores keyed by category name. Not yet editable in the dashboard.")
 });
 var OPTIONS_DESCRIPTION = (() => {
@@ -17118,6 +17120,21 @@ var NodeSchema = external_exports.object({
   config: external_exports.record(external_exports.unknown()).optional().describe(CONFIG_DESCRIPTION),
   options: external_exports.array(OptionSchema).optional().describe(OPTIONS_DESCRIPTION)
 });
+function applyNodeDefaults(node) {
+  const def = NODE_TYPES[node.type];
+  if (node.type === "button" && (!node.options || node.options.length === 0)) {
+    const buttonDefault = def?.config_schema?.properties?.button_text?.default || "Continue";
+    const label = node.config?.button_text || buttonDefault;
+    node.options = [{ content: label }];
+  }
+  const supportsRecordScores = def?.config_schema?.properties?.choice?.properties?.record_scores !== void 0;
+  const hasScoredOptions = node.options?.some((o) => o.score != null || o.scores != null);
+  if (supportsRecordScores && hasScoredOptions) {
+    const config2 = node.config ??= {};
+    const choice = config2.choice ??= {};
+    if (choice.record_scores === void 0) choice.record_scores = true;
+  }
+}
 
 // src/tools/create-form.ts
 function registerCreateFormTool(server) {
@@ -17150,6 +17167,13 @@ Example: A form that asks a question, collects contact info, then finishes:
         font_family: external_exports.string().optional().describe("AI-PROTECTED: Only set when the user explicitly requests a specific font."),
         tags: external_exports.array(external_exports.string()).optional().describe("Tags for indexing (e.g. ['quiz', 'trivia', 'arsenal']). Include format, genre, and topics.")
       },
+      outputSchema: {
+        form_id: external_exports.string().describe("Form UUID - pass to follow-up tools"),
+        viewer_url: external_exports.string().describe("Live form URL for respondents"),
+        dashboard_url: external_exports.string().optional().describe("Builder URL (sign in to edit)"),
+        nodes: external_exports.array(external_exports.object({ id: external_exports.string(), type: external_exports.string(), prompt: external_exports.string() })).describe("Created nodes in order - IDs for upload_node_media / update_node"),
+        plan: external_exports.object({ name: external_exports.string(), auth_mode: external_exports.string() }).optional().describe("Plan and auth context for this session")
+      },
       annotations: {
         readOnlyHint: false,
         destructiveHint: false,
@@ -17233,12 +17257,9 @@ Example: A form that asks a question, collects contact info, then finishes:
           body: settingsBody
         });
       }
+      const createdNodes = [];
       for (const q of nodes) {
-        if (q.type === "button" && (!q.options || q.options.length === 0)) {
-          const buttonDefault = NODE_TYPES.button?.config_schema?.properties?.button_text?.default || "Continue";
-          const label = q.config?.button_text || buttonDefault;
-          q.options = [{ content: label }];
-        }
+        applyNodeDefaults(q);
         const addResult = await callApi(`/forms/${formId}/nodes`, {
           method: "POST",
           body: { node: q }
@@ -17246,6 +17267,11 @@ Example: A form that asks a question, collects contact info, then finishes:
         if (!addResult.ok) {
           return errorResult(`Failed to add node "${q.prompt}": ${addResult.error}`);
         }
+        createdNodes.push({
+          id: addResult.data.node_id,
+          type: q.type,
+          prompt: q.prompt
+        });
       }
       if (tags && tags.length > 0) {
         await callApi(`/forms/${formId}/tags`, {
@@ -17253,13 +17279,16 @@ Example: A form that asks a question, collects contact info, then finishes:
           body: { tags }
         });
       }
+      const truncate = (s, n = 60) => s.length > n ? `${s.slice(0, n - 1)}\u2026` : s;
       const lines = [
         `Form created and live.`,
         ``,
         `Title: ${title}`,
-        `Nodes: ${nodes.length}`,
         `Form ID: ${formId}`,
         ``,
+        `Node IDs (use directly with upload_node_media / update_node - no get_form round-trip needed):`,
+        ...createdNodes.map((n) => `- [${n.type}] "${truncate(n.prompt)}": ${n.id}`),
+        ``,
         `FORM URL (live - share this with respondents): ${data.viewer_url}`
       ];
       if (formUrl) {
@@ -17268,7 +17297,7 @@ Example: A form that asks a question, collects contact info, then finishes:
       lines.push(
         ``,
         `The form is live and accessible at the FORM URL above. Continue with media/narration steps if needed - changes appear immediately.`,
-        `CRITICAL: Copy the URLs above character-for-character into your response. Do NOT construct, guess, or invent any URLs. Only use the exact FORM URL and DASHBOARD URL provided here.`,
+        `The URLs above are exact values; constructed or guessed URLs return 404. Use the FORM URL and DASHBOARD URL as shown.`,
         `Pass form_id on follow-up tools (get_form, add_node, upload_node_media, etc.).`
       );
       if (planContext) {
@@ -17287,7 +17316,16 @@ Example: A form that asks a question, collects contact info, then finishes:
           );
         }
       }
-      return textResult(lines.join("\n"));
+      return {
+        content: [{ type: "text", text: lines.join("\n") }],
+        structuredContent: {
+          form_id: formId,
+          viewer_url: data.viewer_url,
+          ...formUrl ? { dashboard_url: formUrl } : {},
+          nodes: createdNodes,
+          ...planContext ? { plan: { name: planContext.plan_name, auth_mode: planContext.auth_mode } } : {}
+        }
+      };
     }
   );
 }
@@ -17592,11 +17630,7 @@ function registerAddNodeTool(server) {
       }
     },
     async ({ form_id, node, after_node_id }) => {
-      if (node.type === "button" && (!node.options || node.options.length === 0)) {
-        const buttonDefault = NODE_TYPES.button?.config_schema?.properties?.button_text?.default || "Continue";
-        const label = node.config?.button_text || buttonDefault;
-        node.options = [{ content: label }];
-      }
+      applyNodeDefaults(node);
       const body = { node };
       if (after_node_id) body.after_node_id = after_node_id;
       const result = await callApi(`/forms/${form_id}/nodes`, {
@@ -17669,6 +17703,10 @@ function registerUpdateNodeTool(server) {
         if (options !== void 0)
           changes.push(`Options \u2192 ${options.map((o) => o.content).join(", ")}`);
         allLines.push(`Node ${node_id} updated: ${changes.join(", ")}`);
+        const warnings = result.data.warnings;
+        if (warnings?.length) {
+          for (const w of warnings) allLines.push(`Node ${node_id} warning: ${w}`);
+        }
       }
       return textResult(allLines.join("\n"));
     }
@@ -18829,4 +18867,4 @@ export {
   JSONRPCMessageSchema,
   createServer
 };
-//# sourceMappingURL=chunk-5FG2V7B7.js.map
+//# sourceMappingURL=chunk-46RSQK6L.js.map