@clipform/mcp-server 1.41.0 → 1.44.0

package/README.md

@@ -1,4 +1,11 @@
 <!-- GENERATED from README.template.md by scripts/sync-mcp-server-readme.mjs - do not edit directly. -->
+<!--
+  GENERATED FILE SOURCE TEMPLATE.
+  README.md is generated from this template by scripts/sync-mcp-server-readme.mjs.
+  Edit prose HERE, never in README.md. URLs/package come from @vid-master/config;
+  the tool list is generated from the live server (createServer()._registeredTools),
+  so adding/removing a tool updates the README automatically - never hand-list tools.
+-->
 # @clipform/mcp-server
 
 MCP server for [Clipform](https://clipform.io) - build and manage video-style forms from any MCP client (Claude, ChatGPT, Cursor, Windsurf, etc.).

package/dist/{chunk-WCC65GB5.js → chunk-5GITXD5V.js}

@@ -1802,30 +1802,30 @@ var SLIDESHOW_TRANSITIONS = [
 ];
 var COMPOSITION_REGISTRY = [
   // Beds (full-bleed backgrounds)
-  { id: "MediaSlideshow", tier: "public", kind: "bed" },
-  { id: "Map", tier: "public", kind: "bed" },
-  { id: "Grid", tier: "public", kind: "bed" },
+  { id: "MediaSlideshow", tier: "public", kind: "bed", scene_layer: true },
+  { id: "Map", tier: "public", kind: "bed", scene_layer: true },
+  { id: "Grid", tier: "public", kind: "bed", scene_layer: true },
   { id: "GridList", tier: "public", kind: "bed" },
   { id: "ObscuredReveal", tier: "public", kind: "bed" },
   { id: "Timeline", tier: "public", kind: "bed" },
   { id: "NumberLine", tier: "public", kind: "bed" },
   { id: "CountdownRing", tier: "public", kind: "bed" },
-  { id: "CountrySilhouetteClip", tier: "public", kind: "bed" },
+  { id: "CountrySilhouetteClip", tier: "public", kind: "bed", scene_layer: true },
   // TODO(consolidation): collapse to one FlagReveal { country } - these three
   // are the same component with hardcoded flag paths (a recipe, not a tool).
   { id: "FlagRevealGB", tier: "public", kind: "bed" },
   { id: "FlagRevealJP", tier: "public", kind: "bed" },
   { id: "FlagRevealBR", tier: "public", kind: "bed" },
-  { id: "ColorCards", tier: "public", kind: "bed" },
+  { id: "ColorCards", tier: "public", kind: "bed", scene_layer: true },
   { id: "TitleCard", tier: "public", kind: "bed" },
   { id: "ParallaxImage", tier: "public", kind: "bed" },
-  { id: "Spin3D", tier: "labs", kind: "bed" },
+  { id: "Spin3D", tier: "labs", kind: "bed", scene_layer: true },
   // Overlays (assets layered on a bed)
-  { id: "TextReveal", tier: "public", kind: "overlay" },
-  { id: "EmojiPuzzle", tier: "public", kind: "overlay" },
-  { id: "BeforeAfter", tier: "public", kind: "overlay" },
-  { id: "StatCounter", tier: "labs", kind: "overlay" },
-  { id: "ListReveal", tier: "labs", kind: "overlay" },
+  { id: "TextReveal", tier: "public", kind: "overlay", scene_layer: true },
+  { id: "EmojiPuzzle", tier: "public", kind: "overlay", scene_layer: true },
+  { id: "BeforeAfter", tier: "public", kind: "overlay", scene_layer: true },
+  { id: "StatCounter", tier: "labs", kind: "overlay", scene_layer: true },
+  { id: "ListReveal", tier: "labs", kind: "overlay", scene_layer: true },
   // Container
   { id: "Scene", tier: "labs", kind: "container" },
   // Social marketing templates (gated)
@@ -1838,6 +1838,7 @@ var compositionIdsByTier = (tier) => COMPOSITION_REGISTRY.filter((c) => c.tier =
 var PUBLIC_COMPOSITION_IDS = compositionIdsByTier("public");
 var LABS_COMPOSITION_IDS = compositionIdsByTier("labs");
 var SOCIAL_COMPOSITION_IDS = compositionIdsByTier("social");
+var SCENE_LAYER_COMPOSITION_IDS = COMPOSITION_REGISTRY.filter((c) => c.scene_layer).map((c) => c.id);
 var MCP_TOOL_TIERS = {};
 
 // src/lib/telemetry.ts
@@ -1941,7 +1942,9 @@ Error: ${message}`
   }
   const data = await response.json();
   if (!response.ok) {
-    const errorMsg = data.error || `API error (${response.status})`;
+    const hint = recoveryHint(response.status, path);
+    const apiMsg = data.error || `API error (${response.status})`;
+    const errorMsg = hint ? `${apiMsg} - ${hint}` : apiMsg;
     if (isServerFault(response.status)) {
       reportError({
         error_type: `http_${response.status}`,
@@ -1959,6 +1962,20 @@ Error: ${message}`
   }
   return { ok: true, data };
 }
+function recoveryHint(status, path) {
+  if (status === 401 || status === 403) {
+    return "Check credentials: the key comes from CLIPFORM_API_KEY or the OAuth session - read clipform://context/session for the active workspace and auth mode.";
+  }
+  if (status === 404) {
+    if (/^\/forms\/[^/]+\/nodes\//.test(path)) {
+      return "Call clipform_get_form to list this form's nodes and their IDs.";
+    }
+    if (/^\/forms\/[^/]+/.test(path)) {
+      return "Call clipform_list_forms to find valid form IDs (UUIDs, not the share_id from a form URL).";
+    }
+  }
+  return void 0;
+}
 function errorResult(message) {
   return {
     content: [{ type: "text", text: message }],
@@ -2051,4 +2068,4 @@ export {
   getSessionContextWithAuth,
   getSessionContext
 };
-//# sourceMappingURL=chunk-WCC65GB5.js.map
+//# sourceMappingURL=chunk-5GITXD5V.js.map