@clipform/mcp-server 1.37.0 → 1.39.0

package/README.md

@@ -1,4 +1,4 @@
-# @clipform/mcp-server
+# @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.).
 
@@ -10,9 +10,9 @@ There are two ways to connect: **remote** (recommended, uses your Clipform accou
 
 Use this if you have a Clipform account. Forms are created directly in your workspace and your plan tier applies (no 3-node cap on Pro).
 
-**Claude (claude.ai):** Settings → Connectors → Add custom connector → enter `https://mcp.clipform.io`
+**Claude (claude.ai):** Settings → Connectors → Add custom connector → enter `https://mcp.clipform.io`
 
-**ChatGPT:** Settings → Connectors → Advanced → enable Developer Mode → Create connector → enter `https://mcp.clipform.io` (requires Pro/Team/Enterprise)
+**ChatGPT:** Settings → Connectors → Advanced → enable Developer Mode → Create connector → enter `https://mcp.clipform.io` (requires Pro/Team/Enterprise)
 
 **Any MCP client with OAuth:** Point it at `https://mcp.clipform.io` - discovery, registration, and auth are handled automatically via OAuth 2.1 + Dynamic Client Registration (RFC 7591).
 
@@ -87,7 +87,7 @@ You can also pass the key as a CLI flag: `npx -y @clipform/mcp-server --api-key=
 | `clipform_render_composition` | Render a video composition to MP4 or PNG - flag reveals, emoji puzzles, grids, timelines, map motion and more. Pass `wait: false` to fire renders in parallel and poll for results |
 | `clipform_generate_tts` | Generate narration audio with word-level captions |
 | `clipform_generate_slideshow` | Create slideshow videos from images + audio (waits, returns URL) |
-| `clipform_generate_video` | Generate video from images, clips, or both synced to audio. Pass `wait: false` to fire renders in parallel and poll for results |
+| `clipform_generate_video` | Generate video from images, clips, or both synced to audio. Supports a looping background-audio bed (crowd noise, ambience) and print-style texture overlays. Pass `wait: false` to fire renders in parallel and poll for results |
 | `clipform_check_render` | Check status of a render started with `wait: false` |
 | `clipform_search_media` | Search royalty-free images and videos, with orientation filter and alt-text descriptions |
 | `clipform_search_music` | Search royalty-free music and ambient sounds |
@@ -113,3 +113,5 @@ Forms are created with a start node and end screen automatically - you just add
 
 - [Clipform](https://clipform.io) - Create interactive video forms
 - [Documentation](https://clipform.io/docs/guides/mcp) - Full guide with node types, scoring, and more
+
+> Craft guides (`clipform://guides/*`, `clipform_get_guide`) are fetched from the Clipform API at runtime, so the server needs a reachable `API_URL` and valid `CLIPFORM_API_KEY` to serve them.

package/dist/chunk-4DWK5GA5.js

@@ -0,0 +1,139 @@
+import {
+  ALL_VARIANTS,
+  FORM_TYPE_KEYS,
+  callApi,
+  getSessionContext
+} from "./chunk-MESJBHZL.js";
+
+// src/lib/guides.ts
+var guidesPromise = null;
+async function loadGuides() {
+  const result = await callApi("/internal/mcp/guides", { method: "GET" });
+  if (!result.ok) {
+    throw new Error(`Failed to load guides: ${result.error}`);
+  }
+  const guides = result.data.guides ?? [];
+  return new Map(guides.map((g) => [g.uri, g]));
+}
+async function fetchGuideText(uri) {
+  if (!guidesPromise) {
+    guidesPromise = loadGuides();
+  }
+  try {
+    const guides = await guidesPromise;
+    return guides.get(uri)?.text ?? null;
+  } catch (err) {
+    guidesPromise = null;
+    console.error(`[guides] Failed to fetch ${uri}: ${err instanceof Error ? err.message : String(err)}`);
+    return null;
+  }
+}
+function guideFallbackText(uri) {
+  return [
+    `# Guide unavailable`,
+    ``,
+    `The craft guide (${uri}) could not be loaded from the Clipform API.`,
+    `Guides are served at runtime and need a reachable API with a valid key -`,
+    `check API_URL and CLIPFORM_API_KEY, then try again.`,
+    ``,
+    `General principles in the meantime: write narration for the ear (short,`,
+    `conversational), never reveal answers in narration or media, and keep`,
+    `forms tight - every question must earn its place.`
+  ].join("\n");
+}
+
+// src/resources.ts
+var GUIDE_TYPES = FORM_TYPE_KEYS;
+var QUIZ_VARIANTS = ALL_VARIANTS;
+var GUIDE_DESCRIPTIONS = {
+  "quiz": "Craft knowledge for writing engaging quizzes - difficulty curves, question psychology, narration style, scoring",
+  "survey": "Craft knowledge for feedback surveys, NPS, and research forms - brevity, rating scales, respondent fatigue",
+  "interview": "Craft knowledge for building interview forms - warm-up pacing, open questions, consent, video responses",
+  "funnel": "Craft knowledge for lead qualification funnels - planned feature, conditional routing coming soon",
+  "testimonial": "Craft knowledge for collecting testimonials and customer stories on video - storytelling prompts, comfort techniques, consent",
+  "application": "Craft knowledge for application and evaluation forms - multi-section structure, video responses for behavioural questions, screening",
+  "booking": "Craft knowledge for event registration and booking forms - minimal friction, video welcome, confirmation flow"
+};
+var QUIZ_VARIANT_DESCRIPTIONS = {
+  "personality": "Addendum for personality quizzes - category design, option weighting, outcome writing, no right/wrong answers",
+  "comprehension": "Addendum for YouTube comprehension quizzes - extracting questions from transcripts, distractor design, audience adaptation",
+  "composition": "Addendum for composition quizzes - guess-and-reveal formats built from rendered compositions: mechanic selection, the clue/reveal node pair, difficulty design"
+};
+function getGuideUri(type, variant) {
+  if (type === "quiz" && variant) {
+    return `clipform://guides/quiz/${variant}`;
+  }
+  return `clipform://guides/${type}`;
+}
+async function readGuide(uri) {
+  return await fetchGuideText(uri) ?? guideFallbackText(uri);
+}
+function registerResources(server) {
+  for (const type of GUIDE_TYPES) {
+    server.registerResource(
+      `guide-${type}`,
+      getGuideUri(type),
+      {
+        description: GUIDE_DESCRIPTIONS[type],
+        mimeType: "text/markdown",
+        annotations: { audience: ["assistant"], priority: 0.8 }
+      },
+      async () => ({
+        contents: [{
+          uri: getGuideUri(type),
+          mimeType: "text/markdown",
+          text: await readGuide(getGuideUri(type))
+        }]
+      })
+    );
+  }
+  for (const variant of QUIZ_VARIANTS) {
+    server.registerResource(
+      `guide-quiz-${variant}`,
+      getGuideUri("quiz", variant),
+      {
+        description: QUIZ_VARIANT_DESCRIPTIONS[variant],
+        mimeType: "text/markdown",
+        annotations: { audience: ["assistant"], priority: 0.8 }
+      },
+      async () => ({
+        contents: [{
+          uri: getGuideUri("quiz", variant),
+          mimeType: "text/markdown",
+          text: await readGuide(getGuideUri("quiz", variant))
+        }]
+      })
+    );
+  }
+  server.registerResource(
+    "context-session",
+    "clipform://context/session",
+    {
+      description: "Current session info: auth mode, workspace, plan tier, node limits, feature flags. Read this before planning content to know your constraints.",
+      mimeType: "text/markdown",
+      annotations: { audience: ["assistant"], priority: 1 }
+    },
+    async () => {
+      const text = await getSessionContext();
+      return {
+        contents: [
+          {
+            uri: "clipform://context/session",
+            mimeType: "text/markdown",
+            text: text || "Session context unavailable - API may not be reachable."
+          }
+        ]
+      };
+    }
+  );
+}
+
+export {
+  fetchGuideText,
+  guideFallbackText,
+  GUIDE_TYPES,
+  QUIZ_VARIANTS,
+  getGuideUri,
+  registerResources
+};
+//# sourceMappingURL=chunk-4DWK5GA5.js.map

package/dist/chunk-4DWK5GA5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/guides.ts","../src/resources.ts"],"sourcesContent":["import { callApi } from \"./api-client.js\";\n\n/**\n * Craft guide bodies live server-side (#470) - the npm package is a shim\n * that fetches them at runtime instead of bundling them in the tarball.\n * One fetch per process (all ~30KB of guides in a single response), cached;\n * a failed fetch is NOT cached so the next read retries.\n */\n\nexport interface RemoteGuide {\n  type: string;\n  variant: string | null;\n  uri: string;\n  mimeType: string;\n  text: string;\n}\n\nlet guidesPromise: Promise<Map<string, RemoteGuide>> | null = null;\n\nasync function loadGuides(): Promise<Map<string, RemoteGuide>> {\n  const result = await callApi(\"/internal/mcp/guides\", { method: \"GET\" });\n  if (!result.ok) {\n    throw new Error(`Failed to load guides: ${result.error}`);\n  }\n  const guides = (result.data as { guides?: RemoteGuide[] }).guides ?? [];\n  return new Map(guides.map((g) => [g.uri, g]));\n}\n\n/** Fetch a guide body by its clipform:// URI. Returns null when unavailable. */\nexport async function fetchGuideText(uri: string): Promise<string | null> {\n  if (!guidesPromise) {\n    guidesPromise = loadGuides();\n  }\n  try {\n    const guides = await guidesPromise;\n    return guides.get(uri)?.text ?? null;\n  } catch (err) {\n    guidesPromise = null; // don't cache failures - retry on the next read\n    // Loud, not silent: a misconfigured API_URL/key otherwise degrades every\n    // guide to the stub with nothing in the logs.\n    console.error(`[guides] Failed to fetch ${uri}: ${err instanceof Error ? err.message : String(err)}`);\n    return null;\n  }\n}\n\n/** Shown in place of a guide when the API is unreachable or unauthenticated. */\nexport function guideFallbackText(uri: string): string {\n  return [\n    `# Guide unavailable`,\n    ``,\n    `The craft guide (${uri}) could not be loaded from the Clipform API.`,\n    `Guides are served at runtime and need a reachable API with a valid key -`,\n    `check API_URL and CLIPFORM_API_KEY, then try again.`,\n    ``,\n    `General principles in the meantime: write narration for the ear (short,`,\n    `conversational), never reveal answers in narration or media, and keep`,\n    `forms tight - every question must earn its place.`,\n  ].join(\"\\n\");\n}\n","import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { getSessionContext } from \"./lib/session-context.js\";\nimport { FORM_TYPE_KEYS, FORM_TYPES, ALL_VARIANTS } from \"@vid-master/config\";\n\nexport const GUIDE_TYPES = FORM_TYPE_KEYS as readonly string[] as readonly [string, ...string[]];\nexport type GuideType = (typeof FORM_TYPE_KEYS)[number];\n\nexport const QUIZ_VARIANTS = ALL_VARIANTS as readonly string[] as readonly [string, ...string[]];\nexport type QuizVariant = (typeof ALL_VARIANTS)[number];\n// Guide BODIES are not bundled here (#470): the npm tarball ships only this\n// registration metadata. Text is fetched from the API at runtime - see\n// lib/guides.ts (cached per process, stub fallback when unreachable).\nimport { fetchGuideText, guideFallbackText } from \"./lib/guides.js\";\n\nconst GUIDE_DESCRIPTIONS: Record<GuideType, string> = {\n  \"quiz\": \"Craft knowledge for writing engaging quizzes - difficulty curves, question psychology, narration style, scoring\",\n  \"survey\": \"Craft knowledge for feedback surveys, NPS, and research forms - brevity, rating scales, respondent fatigue\",\n  \"interview\": \"Craft knowledge for building interview forms - warm-up pacing, open questions, consent, video responses\",\n  \"funnel\": \"Craft knowledge for lead qualification funnels - planned feature, conditional routing coming soon\",\n  \"testimonial\": \"Craft knowledge for collecting testimonials and customer stories on video - storytelling prompts, comfort techniques, consent\",\n  \"application\": \"Craft knowledge for application and evaluation forms - multi-section structure, video responses for behavioural questions, screening\",\n  \"booking\": \"Craft knowledge for event registration and booking forms - minimal friction, video welcome, confirmation flow\",\n};\n\nconst QUIZ_VARIANT_DESCRIPTIONS: Record<QuizVariant, string> = {\n  \"personality\": \"Addendum for personality quizzes - category design, option weighting, outcome writing, no right/wrong answers\",\n  \"comprehension\": \"Addendum for YouTube comprehension quizzes - extracting questions from transcripts, distractor design, audience adaptation\",\n  \"composition\": \"Addendum for composition quizzes - guess-and-reveal formats built from rendered compositions: mechanic selection, the clue/reveal node pair, difficulty design\",\n};\n\nexport function getGuideUri(type: GuideType, variant?: QuizVariant): string {\n  if (type === \"quiz\" && variant) {\n    return `clipform://guides/quiz/${variant}`;\n  }\n  return `clipform://guides/${type}`;\n}\n\nasync function readGuide(uri: string): Promise<string> {\n  return (await fetchGuideText(uri)) ?? guideFallbackText(uri);\n}\n\nexport function registerResources(server: McpServer) {\n  for (const type of GUIDE_TYPES) {\n    server.registerResource(\n      `guide-${type}`,\n      getGuideUri(type),\n      {\n        description: GUIDE_DESCRIPTIONS[type],\n        mimeType: \"text/markdown\",\n        annotations: { audience: [\"assistant\" as const], priority: 0.8 },\n      },\n      async () => ({\n        contents: [{\n          uri: getGuideUri(type),\n          mimeType: \"text/markdown\",\n          text: await readGuide(getGuideUri(type)),\n        }],\n      }),\n    );\n  }\n\n  for (const variant of QUIZ_VARIANTS) {\n    server.registerResource(\n      `guide-quiz-${variant}`,\n      getGuideUri(\"quiz\", variant),\n      {\n        description: QUIZ_VARIANT_DESCRIPTIONS[variant],\n        mimeType: \"text/markdown\",\n        annotations: { audience: [\"assistant\" as const], priority: 0.8 },\n      },\n      async () => ({\n        contents: [{\n          uri: getGuideUri(\"quiz\", variant),\n          mimeType: \"text/markdown\",\n          text: await readGuide(getGuideUri(\"quiz\", variant)),\n        }],\n      }),\n    );\n  }\n\n  server.registerResource(\n    \"context-session\",\n    \"clipform://context/session\",\n    {\n      description:\n        \"Current session info: auth mode, workspace, plan tier, node limits, feature flags. Read this before planning content to know your constraints.\",\n      mimeType: \"text/markdown\",\n      annotations: { audience: [\"assistant\"], priority: 1.0 },\n    },\n    async () => {\n      const text = await getSessionContext();\n      return {\n        contents: [\n          {\n            uri: \"clipform://context/session\",\n            mimeType: \"text/markdown\",\n            text: text || \"Session context unavailable - API may not be reachable.\",\n          },\n        ],\n      };\n    }\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-5L2KPKOE.js → chunk-IBTTDNN6.js}

@@ -6,14 +6,15 @@ import {
   getWorkflowText,
   objectType,
   registerPrompts
-} from "./chunk-XOYZMNJD.js";
+} from "./chunk-IXQRUFZM.js";
 import {
   GUIDE_TYPES,
   QUIZ_VARIANTS,
-  getGuideContent,
+  fetchGuideText,
   getGuideUri,
+  guideFallbackText,
   registerResources
-} from "./chunk-AZ33QQ4H.js";
+} from "./chunk-4DWK5GA5.js";
 import {
   BUSINESS,
   CONTACT_FIELDS,
@@ -22,6 +23,7 @@ import {
   KEN_BURNS_EFFECTS,
   KEN_BURNS_FIT_MODES,
   KEN_BURNS_PRESETS,
+  MCP_TOOL_TIERS,
   NODE_TYPES,
   NON_COUNTABLE_TYPES,
   SLIDESHOW_TRANSITIONS,
@@ -29,7 +31,7 @@ import {
   errorResult,
   resolveFormType,
   textResult
-} from "./chunk-UA3MYEUA.js";
+} from "./chunk-MESJBHZL.js";
 import {
   __commonJS,
   __export,
@@ -16984,7 +16986,6 @@ var END_SCREEN_ICONS = _endScreen.icon.enum;
 var END_SCREEN_CTA_TYPES = _endScreen.cta_type.enum;
 var PUBLIC_COMPOSITIONS = [
   "Map",
-  "MapPin",
   "Grid",
   "GridList",
   "ObscuredReveal",
@@ -17005,9 +17006,21 @@ var PUBLIC_COMPOSITIONS = [
 ];
 var LABS_COMPOSITIONS = [
   "StatCounter",
-  "ListReveal"
+  "ListReveal",
+  "Scene",
+  "Spin3D"
+];
+var SOCIAL_COMPOSITIONS = [
+  "ShortFormQuiz",
+  "ScorecardQuiz",
+  "ScorecardGK",
+  "CountrySilhouetteQuiz"
+];
+var EXPOSED_COMPOSITIONS = [
+  ...PUBLIC_COMPOSITIONS,
+  ...process.env.CLIPFORM_LABS === "1" ? LABS_COMPOSITIONS : [],
+  ...process.env.CLIPFORM_SOCIAL === "1" ? SOCIAL_COMPOSITIONS : []
 ];
-var EXPOSED_COMPOSITIONS = process.env.CLIPFORM_LABS === "1" ? [...PUBLIC_COMPOSITIONS, ...LABS_COMPOSITIONS] : PUBLIC_COMPOSITIONS;
 
 // src/lib/schemas.ts
 var ACTIVE_NODE_TYPES = Object.entries(NODE_TYPES).filter(([, def]) => def.is_active && !def.is_system).map(([type]) => type);
@@ -18381,7 +18394,7 @@ For multi-render builds (e.g. composition quizzes with a clue + reveal clip per
       inputSchema: {
         compositionId: external_exports.string().describe(`The composition ID. Call clipform_list_compositions to see available options (e.g. ${EXPOSED_COMPOSITIONS.map((id) => `'${id}'`).join(", ")})`),
         outputFormat: external_exports.enum(["mp4", "png"]).default("mp4").describe("Output format (default: mp4)"),
-        inputProps: external_exports.record(external_exports.unknown()).optional().describe("Props object matching the composition's schema from clipform_list_compositions. Validated STRICTLY - unknown or missing props fail with the schema in the error, nothing renders silently with defaults. For map compositions (Map), round lat/lng to 1 decimal place (e.g. 48.9 instead of 48.8566) \u2014 this improves cache hit rates."),
+        inputProps: external_exports.record(external_exports.unknown()).optional().describe("Props object matching the composition's schema from clipform_list_compositions. Validated STRICTLY - unknown or missing props fail with the schema in the error, nothing renders silently with defaults. For map compositions (Map), wide shots (camera.zoom < 9) may round lat/lng to 1 decimal place to improve cache hit rates; close shots and pin drops should keep full precision \u2014 the pin lands exactly on `target`."),
         wait: external_exports.boolean().optional().default(true).describe("true (default) blocks until the render is ready and returns its URL. false returns a job ID immediately - fire all renders first, then poll clipform_check_render. Use false whenever rendering more than one clip.")
       },
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }
@@ -18594,6 +18607,8 @@ For multi-question builds, pass wait: false on every render: each call returns a
           })
         ).min(1).max(20).describe("Media items (images, video clips, or a mix)"),
         audio_url: external_exports.string().url().optional().describe("Audio track URL. Video duration matches audio duration."),
+        background_audio_url: external_exports.string().url().optional().describe("Ambience/music bed under the narration (crowd noise, room tone). Loops to fill the video. Find tracks with clipform_search_music."),
+        background_audio_volume: external_exports.number().min(0).max(1).optional().describe("Background bed volume 0-1 (default 0.15 - sits under speech)"),
         duration_seconds: external_exports.number().positive().optional().describe("Video duration in seconds (required if no audio_url)"),
         random_effects: external_exports.boolean().optional().default(true).describe("Shuffle Ken Burns effects across image items (default: true)"),
         transition: external_exports.object({
@@ -18601,23 +18616,40 @@ For multi-question builds, pass wait: false on every render: each call returns a
           duration: external_exports.number().optional().default(1).describe("Transition duration in seconds (default: 1)")
         }).optional(),
         style_preset: STYLE_PRESET_ENUM.optional(),
+        texture: external_exports.object({
+          type: external_exports.enum(["checker", "halftone", "scanlines"]).describe("checker = square dither mesh, halftone = dot grid, scanlines = horizontal lines"),
+          sizePx: external_exports.number().positive().optional().describe("Pattern cell size in px (default 4)"),
+          opacity: external_exports.number().min(0).max(1).optional().describe("Pattern darkness 0-1 (default 0.35)")
+        }).optional().describe("Print-style pattern overlay on image items - makes stock imagery read as designed (screen-print dither look)"),
+        duotone: external_exports.object({
+          shadow: external_exports.string().describe("Darker tone (maps to image shadows), e.g. '#1a1633'"),
+          highlight: external_exports.string().describe("Lighter tone (maps to image highlights), e.g. '#f5c542'"),
+          contrast: external_exports.number().positive().optional().describe("Contrast boost before mapping (default 1.1)")
+        }).optional().describe("Two-tone editorial recolour on image items - desaturates then maps to a shadow->highlight palette. Pair with a halftone texture for a screen-print poster look."),
         background_color: external_exports.string().optional().describe("Background color (default '#000')"),
         wait: external_exports.boolean().optional().default(true).describe("true (default) blocks until the video is ready and returns its URL. false returns a job ID immediately - fire all renders first, then poll clipform_check_render. Use false whenever rendering more than one video.")
       },
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
     },
-    async ({ items, audio_url, duration_seconds, random_effects, transition, style_preset, background_color, wait }) => {
+    async ({ items, audio_url, background_audio_url, background_audio_volume, duration_seconds, random_effects, transition, style_preset, texture, duotone, background_color, wait }) => {
       const workspace_id = getMcpAuth()?.workspace_id;
+      const default_style = style_preset || texture || duotone ? {
+        ...style_preset ? { preset: style_preset } : {},
+        ...texture ? { texture } : {},
+        ...duotone ? { duotone } : {}
+      } : void 0;
       const apiCall = () => callApi("/internal/generate-video", {
         timeoutMs: 3e5,
         // local renders pay a cold webpack bundle; Lambda is fast but bursty
         body: {
           items,
           audio_url,
+          background_audio_url,
+          background_audio_volume,
           duration_seconds,
           random_effects: random_effects ?? true,
           transition: transition ?? { type: "fade", duration: 1 },
-          default_style: style_preset ? { preset: style_preset } : void 0,
+          default_style,
           background_color,
           workspace_id
         }
@@ -18845,8 +18877,8 @@ Quiz variants (optional): ${QUIZ_VARIANTS.join(", ")} - appends variant-specific
       }
       const type = resolved;
       const validVariant = type === "quiz" ? variant : void 0;
-      const content = getGuideContent(type, validVariant);
       const uri = getGuideUri(type, validVariant);
+      const content = await fetchGuideText(uri) ?? guideFallbackText(uri);
       return {
         content: [{
           type: "resource",
@@ -18954,6 +18986,10 @@ function createServer(options) {
   );
   const _registerTool = server.registerTool.bind(server);
   server.registerTool = (name, config2, handler) => {
+    const requiredTier = MCP_TOOL_TIERS[name] ?? 0;
+    if (options?.planTier !== void 0 && requiredTier > options.planTier) {
+      return void 0;
+    }
     return _registerTool(
       name,
       config2,
@@ -19004,4 +19040,4 @@ export {
   JSONRPCMessageSchema,
   createServer
 };
-//# sourceMappingURL=chunk-5L2KPKOE.js.map
+//# sourceMappingURL=chunk-IBTTDNN6.js.map