@clipform/mcp-server 2.5.0 → 2.6.0

package/README.md

@@ -64,6 +64,7 @@ Your MCP client lists these automatically on connect (via `tools/list`). Full re
 | Tool | Description |
 |------|-------------|
 | `clipform_create_form` | Create a new Clipform (interactive video-style form). |
+| `clipform_import_form` | Convert a public Google Form, Typeform, or Tally form into a new Clipform. |
 | `clipform_list_forms` | List forms in your workspace with optional filtering. |
 | `clipform_whoami` | Show the current identity: auth mode (api key, session, or anonymous), active workspace, and plan limits. |
 | `clipform_get_form` | Retrieve a form's details including all nodes in sequential order and their routing. |

package/dist/{chunk-3OX54HSJ.js → chunk-44FHF2MF.js}

@@ -6,7 +6,7 @@ import {
   getWorkflowText,
   objectType,
   registerPrompts
-} from "./chunk-NYMC63ZK.js";
+} from "./chunk-WMLM53A3.js";
 import {
   GUIDE_TYPES,
   QUIZ_VARIANTS,
@@ -14,7 +14,7 @@ import {
   getGuideUri,
   guideFallbackText,
   registerResources
-} from "./chunk-6EHOUAPE.js";
+} from "./chunk-L3DIBX4G.js";
 import {
   ACTIVE_NODE_TYPES,
   CONTACT_FIELDS,
@@ -35,7 +35,7 @@ import {
   resolveFormType,
   structuredResult,
   textResult
-} from "./chunk-3BYQLPTT.js";
+} from "./chunk-YAI5LQPF.js";
 import {
   getMcpAuth,
   runWithMcpTool
@@ -17293,10 +17293,12 @@ Example: A form that asks a question, collects contact info, then finishes:
           isPreview ? `CLAIM URL (one-time - claim this account to publish): ${formUrl}` : `DASHBOARD URL (sign in to edit and manage): ${formUrl}`
         );
       }
+      const firstUrlLabel = isPreview ? "PREVIEW" : "FORM";
+      const secondUrlLabel = isPreview ? "CLAIM" : "DASHBOARD";
       lines.push(
         ``,
-        isPreview ? `This form is a preview - claim and publish to start collecting responses. Open the CLAIM URL to sign into the account this form already belongs to, then republish with clipform_update_form (is_live: true). The PREVIEW URL never becomes public on its own.` : `The form is live and accessible at the FORM URL above. Edits and media attached AFTER this point are NOT visible to respondents until you re-send is_live: true via clipform_update_form - republishing is the expected final step of a build, never skip it after attaching media/narration.`,
-        `The URLs above are exact values; constructed or guessed URLs return 404. Use the ${isPreview ? "PREVIEW" : "FORM"} URL and ${isPreview ? "CLAIM" : "DASHBOARD"} URL as shown.`,
+        isPreview ? `This form is a preview - claim and publish to start collecting responses.${formUrl ? " Open the CLAIM URL to sign into the account this form already belongs to, then republish" : " Sign in to the account this form already belongs to and republish"} with clipform_update_form (is_live: true). The PREVIEW URL never becomes public on its own.` : `The form is live and accessible at the FORM URL above. Edits and media attached AFTER this point are NOT visible to respondents until you re-send is_live: true via clipform_update_form - republishing is the expected final step of a build, never skip it after attaching media/narration.`,
+        formUrl ? `The URLs above are exact values; constructed or guessed URLs return 404. Use the ${firstUrlLabel} URL and ${secondUrlLabel} URL as shown.` : `The ${firstUrlLabel} URL above is an exact value; constructed or guessed URLs return 404.`,
         `Pass form_id on follow-up tools (get_form, add_node, attach_node_media, etc.).`
       );
       if (planContext) {
@@ -17333,6 +17335,130 @@ Example: A form that asks a question, collects contact info, then finishes:
   );
 }
 
+// src/tools/import-form.ts
+function detectImportPlatform(url) {
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    return null;
+  }
+  const hostname2 = parsed.hostname.toLowerCase();
+  if (hostname2 === "docs.google.com" || hostname2 === "forms.gle") {
+    return "google";
+  }
+  if (hostname2.includes("typeform.com") && parsed.pathname.includes("/to/")) {
+    return "typeform";
+  }
+  if (hostname2.includes("tally.so")) {
+    return "tally";
+  }
+  return null;
+}
+function pluralQuestions(n) {
+  return `${n} question${n === 1 ? "" : "s"}`;
+}
+function registerImportFormTool(server) {
+  server.registerTool(
+    "clipform_import_form",
+    {
+      title: "Import Form",
+      description: `Convert a public Google Form, Typeform, or Tally form into a new Clipform. Supported URLs: Google Forms (docs.google.com or forms.gle - must be shared as "Anyone with the link"), Typeform (form.typeform.com/to/...), and Tally (tally.so - must be public). The source form must be publicly accessible; a private form's questions cannot be read. The new Clipform is created as a DRAFT - review it, then republish with clipform_update_form (is_live: true) once it's ready. Some question types don't map cleanly to a Clipform node and are skipped rather than guessed at; the result always reports exactly what was imported vs skipped, and why.`,
+      inputSchema: {
+        url: external_exports.string().url().describe("Public URL of the Google Form, Typeform, or Tally form to import")
+      },
+      outputSchema: {
+        form_id: external_exports.string().nullable().describe("New form's UUID - pass to follow-up tools. Null when no importable questions were found (nothing was created)."),
+        viewer_url: external_exports.string().nullable().describe("The address this form WILL be live at once published (clipform_update_form with is_live: true) - it is a draft and is NOT viewable by anyone yet; opening it now shows a maintenance screen, not the form. Null when no importable questions were found."),
+        import_summary: external_exports.object({
+          title: external_exports.string().describe("Title of the source form"),
+          total_questions: external_exports.number().describe("Total questions found in the source form"),
+          imported: external_exports.number().describe("Questions successfully converted into Clipform nodes"),
+          skipped: external_exports.number().describe("Questions that could not be converted"),
+          skipped_details: external_exports.array(external_exports.record(external_exports.string(), external_exports.string())).describe("Per-skipped-question title, reason, and source question type"),
+          warnings: external_exports.array(external_exports.string()).describe("Non-fatal issues surfaced during the import")
+        })
+      },
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        // Creates a new, publicly-reachable-once-published form (same
+        // reasoning as clipform_create_form's own annotation).
+        openWorldHint: true
+      }
+    },
+    async ({ url }) => {
+      const platform = detectImportPlatform(url);
+      if (!platform) {
+        return errorResult(
+          "Unsupported URL. clipform_import_form only supports Google Forms (docs.google.com or forms.gle), Typeform (form.typeform.com/to/...), and Tally (tally.so) links."
+        );
+      }
+      const meResult = await callApi("/me", { method: "GET" });
+      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. This usually means authentication is misconfigured - check your API key or OAuth connection."
+        );
+      }
+      const importResult = platform === "google" ? await callApi("/forms/import/google", { method: "POST", body: { url, workspace_id: workspaceId } }) : platform === "typeform" ? await callApi("/forms/import/typeform", { method: "POST", body: { url, workspace_id: workspaceId } }) : await callApi("/forms/import/tally", { method: "POST", body: { url, workspace_id: workspaceId } });
+      if (!importResult.ok) {
+        return errorResult(importResult.error);
+      }
+      const data = importResult.data;
+      const summary = data.import_summary;
+      const formId = data.form_id;
+      const viewerUrl = data.url;
+      const lines = [];
+      if (!formId) {
+        lines.push(
+          `No importable questions were found in "${summary.title}" (${pluralQuestions(summary.total_questions)} total) - nothing was created.`
+        );
+      } else {
+        lines.push(
+          `Imported "${summary.title}": ${summary.imported} of ${pluralQuestions(summary.total_questions)} converted, ${summary.skipped} skipped.`
+        );
+      }
+      if (summary.skipped_details.length > 0) {
+        lines.push(
+          ``,
+          `Skipped:`,
+          ...summary.skipped_details.map((s) => `- "${s.title}": ${s.reason}`)
+        );
+      }
+      if (summary.warnings.length > 0) {
+        lines.push(``, `Warnings:`, ...summary.warnings.map((w) => `- ${w}`));
+      }
+      if (formId) {
+        lines.push(
+          ``,
+          `Form ID: ${formId}`,
+          `FUTURE LIVE URL (not viewable yet - the form is a draft; opening this now shows a maintenance screen): ${viewerUrl}`,
+          `This form was created as a DRAFT. Review it, then publish with clipform_update_form (is_live: true) - only then does the URL above start serving the form to respondents.`,
+          `Pass form_id (the UUID above, not a share_id) to follow-up tools (get_form, add_node, update_node, etc.).`
+        );
+      }
+      return structuredResult(lines.join("\n"), {
+        form_id: formId,
+        viewer_url: viewerUrl,
+        import_summary: {
+          title: summary.title,
+          total_questions: summary.total_questions,
+          imported: summary.imported,
+          skipped: summary.skipped,
+          skipped_details: summary.skipped_details,
+          warnings: summary.warnings
+        }
+      });
+    }
+  );
+}
+
 // src/tools/list-forms.ts
 function registerListFormsTool(server) {
   server.registerTool(
@@ -20279,6 +20405,7 @@ function createServer(options) {
     );
   };
   registerCreateFormTool(server);
+  registerImportFormTool(server);
   registerListFormsTool(server);
   registerWhoamiTool(server);
   registerGetFormTool(server);
@@ -20319,4 +20446,4 @@ export {
   RENDER_TIMING,
   createServer
 };
-//# sourceMappingURL=chunk-3OX54HSJ.js.map
+//# sourceMappingURL=chunk-44FHF2MF.js.map