@clipform/mcp-server 1.30.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-Y3A5HHT6.js → chunk-46RSQK6L.js}

@@ -17167,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,
@@ -17250,6 +17257,7 @@ Example: A form that asks a question, collects contact info, then finishes:
           body: settingsBody
         });
       }
+      const createdNodes = [];
       for (const q of nodes) {
         applyNodeDefaults(q);
         const addResult = await callApi(`/forms/${formId}/nodes`, {
@@ -17259,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`, {
@@ -17266,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) {
@@ -17281,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) {
@@ -17300,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 } } : {}
+        }
+      };
     }
   );
 }
@@ -17678,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"));
     }
@@ -18838,4 +18867,4 @@ export {
   JSONRPCMessageSchema,
   createServer
 };
-//# sourceMappingURL=chunk-Y3A5HHT6.js.map
+//# sourceMappingURL=chunk-46RSQK6L.js.map