@clipform/mcp-server 1.16.1 → 1.18.0

package/dist/{chunk-MB6BZ2JN.js → chunk-GZH3JXEB.js}

@@ -2,8 +2,9 @@ import {
   __commonJS,
   __export,
   __toESM,
+  getMcpAuth,
   runWithMcpTool
-} from "./chunk-VWGIVJMQ.js";
+} from "./chunk-HCZI2UJ5.js";
 
 // ../../node_modules/@modelcontextprotocol/sdk/node_modules/ajv/dist/compile/codegen/code.js
 var require_code = __commonJS({
@@ -22278,24 +22279,13 @@ if (!API_BASE_URL) {
     "API_URL must be set (e.g. http://localhost:3003 or https://api.clipform.io)"
   );
 }
-var MCP_SERVICE_USER_ID = "00000000-0000-4000-8000-000000000001";
 function getAuthHeaders() {
-  const serviceSecret = process.env.INTERNAL_SERVICE_SECRET || process.env.CLIPFORM_INTERNAL_SERVICE_SECRET;
-  const workspaceId = process.env.MCP_WORKSPACE_ID;
-  if (serviceSecret && workspaceId) {
-    return {
-      "Authorization": `Bearer ${serviceSecret}`,
-      "X-Mcp-Workspace": workspaceId,
-      "X-Mcp-User": MCP_SERVICE_USER_ID
-    };
-  }
-  const apiKey = process.env.CLIPFORM_API_KEY;
-  if (apiKey) {
-    return { "Authorization": `Bearer ${apiKey}` };
+  const authCtx = getMcpAuth();
+  const apiKey = authCtx?.api_key || process.env.CLIPFORM_API_KEY;
+  if (!apiKey) {
+    throw new Error("CLIPFORM_API_KEY must be set.");
   }
-  throw new Error(
-    "No API authentication configured. Set INTERNAL_SERVICE_SECRET + MCP_WORKSPACE_ID, or CLIPFORM_API_KEY."
-  );
+  return { "Authorization": `Bearer ${apiKey}` };
 }
 async function callApi(path, options = {}) {
   const { body, params } = options;
@@ -22361,9 +22351,7 @@ function registerCreateFormTool(server) {
 
 ${NODE_TYPES_DESCRIPTION}
 
-All type definitions and config schemas are derived from @vid-master/config (answer-types). Refer to the config descriptions above for the correct keys and shapes.
-
-Fields marked AI-PROTECTED must only be set when the user explicitly requests them. Do not invent values for font, branding, or embed settings.
+All type definitions and config schemas are derived from @vid-master/config (answer-types). Refer to the config descriptions above for the correct keys and shapes. AI-PROTECTED parameters have restrictions noted in their descriptions.
 
 Example: A form that asks a question, collects contact info, then finishes:
 {
@@ -22402,7 +22390,7 @@ Example: A form that asks a question, collects contact info, then finishes:
       const workspaceId = me.workspace?.id ?? null;
       if (!workspaceId) {
         return errorResult(
-          "No workspace available. Connect your Clipform account in claude.ai \u2192 Settings \u2192 Connectors, or ensure MCP_WORKSPACE_ID is configured for anonymous mode."
+          "No workspace available. This usually means authentication is misconfigured - check your API key or OAuth connection."
         );
       }
       planContext = {
@@ -22416,7 +22404,7 @@ Example: A form that asks a question, collects contact info, then finishes:
       const contentCount = nodes.filter((q) => !NON_COUNTABLE_TYPES.includes(q.type)).length;
       if (planContext.node_limit !== null && contentCount > planContext.node_limit) {
         const upgradeUrl = `${BUSINESS.urls.dashboard}/billing`;
-        const message = planContext.auth_mode === "oauth" ? `Your '${planContext.workspace_name}' workspace is on the ${planContext.plan_name} plan, capped at ${planContext.node_limit} nodes per form. You asked for ${contentCount}. Either rerun with ${planContext.node_limit} nodes or upgrade at ${upgradeUrl}.` : `Anonymous sessions are capped at ${planContext.node_limit} nodes per form (${planContext.plan_name} plan). You asked for ${contentCount}. Either rerun with ${planContext.node_limit} nodes, or connect your Clipform account in claude.ai \u2192 Settings \u2192 Connectors so forms land in your workspace with your real plan limits.`;
+        const message = planContext.auth_mode === "oauth" ? `Your '${planContext.workspace_name}' workspace is on the ${planContext.plan_name} plan, capped at ${planContext.node_limit} nodes per form. You asked for ${contentCount}. Either rerun with ${planContext.node_limit} nodes or upgrade at ${upgradeUrl}.` : `Anonymous sessions are capped at ${planContext.node_limit} nodes per form (${planContext.plan_name} plan). You asked for ${contentCount}. Either rerun with ${planContext.node_limit} nodes, or sign in to your Clipform account so forms land in your workspace with your real plan limits.`;
         return errorResult(message);
       }
       if (planContext.form_limit !== null) {
@@ -22440,7 +22428,7 @@ Example: A form that asks a question, collects contact info, then finishes:
       }
       const { data } = createResult;
       const formId = data.form_id;
-      const claimUrl = data.claim_url ?? void 0;
+      const formUrl = data.form_url ?? void 0;
       const settingsBody = {};
       if (show_step_counter !== void 0) settingsBody.show_step_counter = show_step_counter;
       if (disable_back_navigation !== void 0) settingsBody.disable_back_navigation = disable_back_navigation;
@@ -22473,7 +22461,8 @@ Example: A form that asks a question, collects contact info, then finishes:
         body: { is_live: true }
       });
       if (!publishResult.ok) {
-        return errorResult(`Form created but failed to publish: ${publishResult.error}. Form ID: ${formId}`);
+        return errorResult(`Form created but failed to publish: ${publishResult.error}. Form ID: ${formId}
+FORM URL: ${data.viewer_url}`);
       }
       if (tags && tags.length > 0) {
         await callApi(`/forms/${formId}/tags`, {
@@ -22490,12 +22479,12 @@ Example: A form that asks a question, collects contact info, then finishes:
         ``,
         `FORM URL (share this with respondents): ${data.viewer_url}`
       ];
-      if (claimUrl) {
-        lines.push(`CLAIM URL (transfer ownership to your account): ${claimUrl}`);
+      if (formUrl) {
+        lines.push(`DASHBOARD URL (sign in to edit and manage): ${formUrl}`);
       }
       lines.push(
         ``,
-        `IMPORTANT: Always show the user the exact URLs above \u2014 do not rewrite or modify them.`,
+        `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.`,
         `Pass form_id on follow-up tools (get_form, add_node, upload_node_media, etc.).`
       );
       if (planContext) {
@@ -22510,7 +22499,7 @@ Example: A form that asks a question, collects contact info, then finishes:
         } else {
           lines.push(
             ``,
-            `Plan: anonymous ${planContext.plan_name} (${limitNote}). Mention this once: the user can connect their Clipform account in claude.ai \u2192 Settings \u2192 Connectors \u2192 ${BUSINESS.urls.mcp} so future forms land directly in their workspace - do not repeat on follow-up calls.`
+            `Plan: anonymous ${planContext.plan_name} (${limitNote}). Mention this once: the user can sign in to their Clipform account so future forms land directly in their workspace - do not repeat on follow-up calls.`
           );
         }
       }
@@ -23316,7 +23305,7 @@ Returns audio URL and word-level captions per item.`,
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
     },
     async ({ items }) => {
-      const workspace_id = process.env.MCP_WORKSPACE_ID;
+      const workspace_id = getMcpAuth()?.workspace_id;
       const results = await Promise.allSettled(
         items.map(
           (item) => callApi("/internal/tts", {
@@ -23425,7 +23414,7 @@ Style presets via default_style.preset: cinematic (default), dramatic, calm, doc
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
     },
     async ({ images, audio_url, random_effects, transition, default_style, background_color }) => {
-      const workspace_id = process.env.MCP_WORKSPACE_ID;
+      const workspace_id = getMcpAuth()?.workspace_id;
       const result = await callApi("/internal/slideshow", {
         body: {
           images,
@@ -23721,7 +23710,7 @@ Items: type "image" (Ken Burns motion) or "video" (cover-cropped, muted by defau
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
     },
     async ({ items, audio_url, duration_seconds, random_effects, transition, default_style, background_color }) => {
-      const workspace_id = process.env.MCP_WORKSPACE_ID;
+      const workspace_id = getMcpAuth()?.workspace_id;
       const result = await callApi("/internal/generate-video", {
         body: {
           items,
@@ -23898,40 +23887,62 @@ async function getSessionContext() {
   }
   if (me.auth_mode !== "oauth") {
     lines.push(`
-To unlock your full plan: connect your Clipform account in Settings > Connectors > ${BUSINESS.urls.mcp}`);
+To unlock your full plan: sign in to your Clipform account.`);
   }
   return lines.join("\n");
 }
 
 // src/prompts.ts
+var MEDIA_STYLE_ENUM = ["text", "images", "video"];
+function resourceLink(name, uri, title) {
+  return {
+    role: "assistant",
+    content: {
+      type: "resource_link",
+      uri,
+      name,
+      title,
+      mimeType: "text/markdown"
+    }
+  };
+}
 function registerPrompts(server) {
   server.registerPrompt(
     "create-quiz",
     {
       title: "Create a Quiz",
-      description: "Build a scored knowledge quiz with narrated video questions"
+      description: "Build a scored knowledge quiz with narrated video questions",
+      argsSchema: {
+        topic: external_exports.string().optional().describe("Quiz topic (e.g. 'Space exploration', 'Premier League')"),
+        question_count: external_exports.number().optional().default(8).describe("Number of questions (default: 8)"),
+        media_style: external_exports.enum(MEDIA_STYLE_ENUM).optional().default("video").describe("Media style: text only, still images, or slideshow video with narration (default: video)")
+      }
     },
-    async () => {
+    async (args) => {
       const sessionContext = await getSessionContext();
+      const topic = args.topic ? ` about "${args.topic}"` : "";
+      const count = args.question_count ?? 8;
+      const media = args.media_style ?? "video";
       return {
         messages: [
           {
             role: "user",
             content: {
               type: "text",
-              text: "I want to create a quiz. What's the best approach?"
+              text: `I want to create a quiz${topic}. ${count} questions, ${media} style.`
             }
           },
+          resourceLink("guide-quiz", "clipform://guides/quiz", "Quiz Writing Guide"),
           {
             role: "assistant",
             content: {
               type: "text",
-              text: `${sessionContext ? sessionContext + "\n\n" : ""}Here's how to build a great quiz with Clipform. Read the quiz writing guide (clipform://guides/quiz) for detailed craft knowledge on question design, difficulty curves, and narration style.
+              text: `${sessionContext ? sessionContext + "\n\n" : ""}Here's how to build a great ${count}-question ${media} quiz${topic} with Clipform. Read the attached quiz guide for craft knowledge on question design, difficulty curves, and narration style.
 
 ## Workflow
 
 1. **Research** the topic - find surprising facts, common misconceptions, myth-busters
-2. **Write questions** - follow the difficulty curve (easy start, hard middle, satisfying end). Target 5-8 questions.
+2. **Write questions** - follow the difficulty curve (easy start, hard middle, satisfying end). Target ${count} questions.
 3. **Create the form** with clipform_create_form:
    - show_step_counter: true
    - disable_back_navigation: true
@@ -23940,12 +23951,12 @@ function registerPrompts(server) {
    - randomise_options: true in config
    - score: 1 on correct option, score: 0 on wrong
    - 3-4 wrong answers per question
-5. **Generate narration** with clipform_generate_tts for each question. Tease the question - do NOT reveal the answer or read options aloud. Keep each narration 5-15 seconds.
+5. **Generate narration** with clipform_generate_tts for each question. Tease the question - do NOT reveal the answer or read options aloud. Keep each narration 5-15 seconds.${media !== "text" ? `
 6. **Build video** for each question:
    - clipform_search_media (kind: "image") - 3 images per question
    - clipform_generate_video - creates Ken Burns video synced to audio
-7. **Attach media** with clipform_upload_node_media. Include captions, set show_captions: true.
-8. **Update end screen** with clipform_update_node - EVERY quiz must have:
+7. **Attach media** with clipform_upload_node_media. Include captions, set show_captions: true.` : ""}
+${media !== "text" ? "8" : "6"}. **Update end screen** with clipform_update_node - EVERY quiz must have:
    - show_score: true, icon: "trophy"
    - show_share_button: true (drives virality)
    - cta_type: "restart", cta_text: a short challenge like "Beat your score?" or "Try again?"
@@ -23955,15 +23966,9 @@ function registerPrompts(server) {
      { "min": 3, "max": 5, "title": "Frequent Flyer", "message": "Not bad! You know your way around." },
      { "min": 6, "max": 8, "title": "World Explorer", "message": "Impressive - you really know your stuff." }
      \`\`\`
-9. **Publish** with clipform_update_form
-10. **Tag the form** - pass tags: one format (quiz/survey/interview/feedback/lead-gen), one genre (trivia/personality/nps/poll/testimonial), and 2-3 topic words
-11. **Log** with clipform_log_generation (sources, images, attributions)
-
-## Before building, ask
-
-1. How many questions?
-2. Media style: text only, still images, or slideshow video with narration?
-3. Any topic or style preferences?`
+${media !== "text" ? "9" : "7"}. **Publish** with clipform_update_form
+${media !== "text" ? "10" : "8"}. **Tag the form** - pass tags: one format (quiz/survey/interview/feedback/lead-gen), one genre (trivia/personality/nps/poll/testimonial), and 2-3 topic words
+${media !== "text" ? "11" : "9"}. **Log** with clipform_log_generation (sources, images, attributions)`
             }
           }
         ]
@@ -23974,24 +23979,37 @@ function registerPrompts(server) {
     "create-personality-quiz",
     {
       title: "Create a Personality Quiz",
-      description: "Build a 'Which X are you?' personality quiz with category-based scoring and outcome screens"
+      description: "Build a 'Which X are you?' personality quiz with category-based scoring and outcome screens",
+      argsSchema: {
+        topic: external_exports.string().optional().describe("Quiz theme (e.g. 'Which city are you?', 'What's your work style?')"),
+        categories: external_exports.string().optional().describe("Comma-separated outcome categories (e.g. 'Creative, Analytical, Leader, Collaborator')"),
+        question_count: external_exports.number().optional().default(8).describe("Number of questions (default: 8)"),
+        media_style: external_exports.enum(MEDIA_STYLE_ENUM).optional().default("video").describe("Media style (default: video)")
+      }
     },
-    async () => {
+    async (args) => {
       const sessionContext = await getSessionContext();
+      const topic = args.topic ? ` - "${args.topic}"` : "";
+      const count = args.question_count ?? 8;
+      const media = args.media_style ?? "video";
+      const categoriesNote = args.categories ? `
+
+Outcome categories: ${args.categories}` : "";
       return {
         messages: [
           {
             role: "user",
             content: {
               type: "text",
-              text: "I want to create a personality quiz. What's the best approach?"
+              text: `I want to create a personality quiz${topic}. ${count} questions, ${media} style.${categoriesNote}`
             }
           },
+          resourceLink("guide-personality-quiz", "clipform://guides/personality-quiz", "Personality Quiz Guide"),
           {
             role: "assistant",
             content: {
               type: "text",
-              text: `${sessionContext ? sessionContext + "\n\n" : ""}Here's how to build a personality quiz with Clipform. Read the personality quiz guide (clipform://guides/personality-quiz) for craft knowledge on category design, option weighting, and outcome writing.
+              text: `${sessionContext ? sessionContext + "\n\n" : ""}Here's how to build a ${count}-question personality quiz${topic} with Clipform. Read the attached personality quiz guide for craft knowledge on category design, option weighting, and outcome writing.
 
 ## How it differs from a knowledge quiz
 
@@ -24000,7 +24018,7 @@ There are NO correct answers. Each option maps to one or more outcome categories
 ## Workflow
 
 1. **Define 3-5 outcome categories** - these are the "personalities" (e.g. "Creative", "Analytical", "Leader", "Collaborator"). More than 5 gets muddy.
-2. **Write questions** - each question should feel revealing but fun. Target 5-8 questions.
+2. **Write questions** - each question should feel revealing but fun. Target ${count} questions.
 3. **Create the form** with clipform_create_form:
    - show_step_counter: true
    - disable_back_navigation: true
@@ -24031,13 +24049,7 @@ There are NO correct answers. Each option maps to one or more outcome categories
    \`\`\`
 8. **Publish** with clipform_update_form
 9. **Tag the form** - pass tags: one format (quiz/survey/interview/feedback/lead-gen), one genre (trivia/personality/nps/poll/testimonial), and 2-3 topic words
-10. **Log** with clipform_log_generation
-
-## Before building, ask
-
-1. What are the possible outcomes/personalities? (3-5 categories)
-2. What's the theme? ("Which city are you?", "What's your work style?", "Which character are you?")
-3. Media style: text only, still images, or slideshow video with narration?`
+10. **Log** with clipform_log_generation`
             }
           }
         ]
@@ -24048,45 +24060,49 @@ There are NO correct answers. Each option maps to one or more outcome categories
     "create-interview",
     {
       title: "Create an Interview",
-      description: "Build a form to collect testimonials, case studies, async video interviews, or journalist responses"
+      description: "Build a form to collect testimonials, case studies, async video interviews, or journalist responses",
+      argsSchema: {
+        purpose: external_exports.string().optional().describe("What you're collecting (e.g. 'testimonial', 'case study', 'job application')"),
+        response_format: external_exports.enum(["video", "audio", "text", "all"]).optional().default("all").describe("How respondents reply (default: all - video, audio, and text)"),
+        needs_consent: external_exports.boolean().optional().default(true).describe("Include a consent statement (default: true)")
+      }
     },
-    async () => {
+    async (args) => {
       const sessionContext = await getSessionContext();
+      const purpose = args.purpose ?? "responses";
+      const format = args.response_format ?? "all";
+      const consent = args.needs_consent ?? true;
       return {
         messages: [
           {
             role: "user",
             content: {
               type: "text",
-              text: "I want to collect responses or testimonials from people. What's the best approach?"
+              text: `I want to collect ${purpose} from people. Responses via ${format}.${consent ? " Include consent." : ""}`
             }
           },
+          resourceLink("guide-interview", "clipform://guides/interview", "Interview & Testimonial Guide"),
           {
             role: "assistant",
             content: {
               type: "text",
-              text: `${sessionContext ? sessionContext + "\n\n" : ""}Here's how to build an interview or testimonial form with Clipform. Read the interview guide (clipform://guides/interview) for detailed craft knowledge on question design and pacing.
+              text: `${sessionContext ? sessionContext + "\n\n" : ""}Here's how to build an interview form for collecting ${purpose} with Clipform. Read the attached interview guide for craft knowledge on question design and pacing.
 
 ## Workflow
 
-1. **Identify the ask** - what do you need from respondents? Testimonial, case study, expert comment, job application?
+1. **Identify the ask** - what do you need from respondents? ${purpose}.
 2. **Create the form** with clipform_create_form:
    - show_step_counter: true
    - disable_back_navigation: false
 3. **Add a warm-up question** - something easy: "Tell us your name and role" (type: "open")
-4. **Add core questions** (type: "open") - 2-3 max, one topic per question. Enable text + audio + video responses.
-5. **Add contact collection** (type: "contact") - first name + email minimum
-6. **Add consent** if needed - "I agree that my response may be used in [context]"
+4. **Add core questions** (type: "open") - 2-3 max, one topic per question.${format === "all" ? " Enable text + audio + video responses." : ` Enable ${format} responses.`}
+5. **Add contact collection** (type: "contact") - first name + email minimum${consent ? `
+6. **Add consent** - "I agree that my response may be used in [context]"` : ""}
 7. **Update end screen** - set expectations: "Thanks! We'll be in touch."
 8. **Optional: add narration** - warm, inviting tone. "We'd love to hear your story..."
 9. **Publish** with clipform_update_form
 10. **Tag the form** - pass tags: one format (quiz/survey/interview/feedback/lead-gen), one genre (trivia/personality/nps/poll/testimonial), and 2-3 topic words
-
-## Before building, ask
-
-1. What are you collecting? (testimonial, case study, interview, application)
-2. Should respondents reply with video, audio, text, or all three?
-3. Do you need a consent statement?`
+11. **Log** with clipform_log_generation`
             }
           }
         ]
@@ -24097,24 +24113,31 @@ There are NO correct answers. Each option maps to one or more outcome categories
     "create-survey",
     {
       title: "Create a Survey",
-      description: "Build a feedback survey, NPS form, or research questionnaire"
+      description: "Build a feedback survey, NPS form, or research questionnaire",
+      argsSchema: {
+        topic: external_exports.string().optional().describe("What feedback you're collecting (e.g. 'NPS', 'event feedback', 'product satisfaction')"),
+        anonymous: external_exports.boolean().optional().default(true).describe("Whether the survey is anonymous (default: true)")
+      }
     },
-    async () => {
+    async (args) => {
       const sessionContext = await getSessionContext();
+      const topic = args.topic ? ` for ${args.topic}` : "";
+      const anonymous = args.anonymous ?? true;
       return {
         messages: [
           {
             role: "user",
             content: {
               type: "text",
-              text: "I want to collect feedback or run a survey. What's the best approach?"
+              text: `I want to create a survey${topic}. ${anonymous ? "Anonymous" : "Identified"} respondents.`
             }
           },
+          resourceLink("guide-survey", "clipform://guides/survey", "Survey & Feedback Guide"),
           {
             role: "assistant",
             content: {
               type: "text",
-              text: `${sessionContext ? sessionContext + "\n\n" : ""}Here's how to build a survey with Clipform. Read the survey guide (clipform://guides/survey) for craft knowledge on question design and reducing respondent fatigue.
+              text: `${sessionContext ? sessionContext + "\n\n" : ""}Here's how to build a survey${topic} with Clipform. Read the attached survey guide for craft knowledge on question design and reducing respondent fatigue.
 
 ## Workflow
 
@@ -24124,19 +24147,14 @@ There are NO correct answers. Each option maps to one or more outcome categories
    - disable_back_navigation: false
 3. **Add key metric question first** (type: "choice" or "rating") - put it first while attention is highest
 4. **Add one "why?" follow-up** (type: "open") - "What's the main reason for your score?"
-5. **Add 2-3 specific questions** (type: "choice") - only ask what you'll act on
-6. **Contact** (optional) - only if you need to follow up. Many surveys work better anonymous.
+5. **Add 2-3 specific questions** (type: "choice") - only ask what you'll act on${!anonymous ? `
+6. **Contact** - collect name + email for follow-up` : ""}
 7. **Update end screen** - "Thanks for your feedback!"
 8. **Publish** with clipform_update_form
 9. **Tag the form** - pass tags: one format (quiz/survey/interview/feedback/lead-gen), one genre (trivia/personality/nps/poll/testimonial), and 2-3 topic words
+10. **Log** with clipform_log_generation
 
-## Key rule: 5 questions max. Every extra question costs completions.
-
-## Before building, ask
-
-1. What feedback are you collecting? (NPS, satisfaction, event feedback, product research)
-2. Anonymous or identified?
-3. Any specific areas you want to ask about?`
+## Key rule: 5 questions max. Every extra question costs completions.`
             }
           }
         ]
@@ -24147,24 +24165,36 @@ There are NO correct answers. Each option maps to one or more outcome categories
     "create-comprehension-quiz",
     {
       title: "Create a YouTube Comprehension Quiz",
-      description: "Build a comprehension quiz from a YouTube video - tests whether the viewer actually watched and understood the content"
+      description: "Build a comprehension quiz from a YouTube video - tests whether the viewer actually watched and understood the content",
+      argsSchema: {
+        youtube_url: external_exports.string().optional().describe("YouTube video URL to create the quiz from"),
+        question_count: external_exports.number().optional().default(8).describe("Number of questions (default: 8)"),
+        audience: external_exports.string().optional().describe("Target audience (e.g. 'children aged 5-8', 'university students', 'general')"),
+        media_style: external_exports.enum(MEDIA_STYLE_ENUM).optional().default("video").describe("Media style (default: video)")
+      }
     },
-    async () => {
+    async (args) => {
       const sessionContext = await getSessionContext();
+      const count = args.question_count ?? 8;
+      const media = args.media_style ?? "video";
+      const urlNote = args.youtube_url ? ` Start by extracting the transcript from: ${args.youtube_url}` : "";
+      const audienceNote = args.audience ? ` Target audience: ${args.audience}.` : "";
       return {
         messages: [
           {
             role: "user",
             content: {
               type: "text",
-              text: "I want to create a comprehension quiz based on a YouTube video. What's the best approach?"
+              text: `I want to create a comprehension quiz based on a YouTube video. ${count} questions, ${media} style.${urlNote}${audienceNote}`
             }
           },
+          resourceLink("guide-quiz", "clipform://guides/quiz", "Quiz Writing Guide"),
+          resourceLink("guide-comprehension-quiz", "clipform://guides/comprehension-quiz", "Comprehension Quiz Guide"),
           {
             role: "assistant",
             content: {
               type: "text",
-              text: `${sessionContext ? sessionContext + "\n\n" : ""}Here's how to build a comprehension quiz from a YouTube video. Read the quiz guide (clipform://guides/quiz) for general craft, and the comprehension guide (clipform://guides/comprehension-quiz) for video-specific techniques.
+              text: `${sessionContext ? sessionContext + "\n\n" : ""}Here's how to build a ${count}-question comprehension quiz from a YouTube video. Read the attached quiz and comprehension guides for craft knowledge on question design and distractor techniques.
 
 ## Comprehension Quiz Workflow
 
@@ -24179,7 +24209,7 @@ There are NO correct answers. Each option maps to one or more outcome categories
    - "What example does the video use to illustrate...?"
    - Include 1-2 inference questions: "Based on the video, why does the presenter believe...?"
    - Avoid questions answerable without watching (e.g., common knowledge about the topic)
-4. **Adapt to the audience** - if specified (e.g., "for a 5-year-old"), simplify language, reduce option count, focus on concrete/visual details rather than abstract arguments
+4. **Adapt to the audience**${args.audience ? ` (${args.audience})` : ""} - simplify language for younger audiences, focus on concrete/visual details rather than abstract arguments
 5. **Create the form** with clipform_create_form:
    - show_step_counter: true
    - disable_back_navigation: true
@@ -24188,12 +24218,12 @@ There are NO correct answers. Each option maps to one or more outcome categories
    - randomise_options: true in config
    - score: 1 on correct option, score: 0 on wrong
    - 3-4 wrong answers per question - make distractors plausible (things someone might guess without watching)
-7. **Generate narration** with clipform_generate_tts - reference the video naturally: "If you watched closely, you'll know this one..." Keep each narration 5-10 seconds.
+7. **Generate narration** with clipform_generate_tts - reference the video naturally: "If you watched closely, you'll know this one..." Keep each narration 5-10 seconds.${media !== "text" ? `
 8. **Build video** for each question:
    - clipform_search_media (kind: "image") - 3 images per question
    - clipform_generate_video - Ken Burns video synced to audio
-9. **Attach media** with clipform_upload_node_media. Include captions, set show_captions: true.
-10. **Update end screen** with clipform_update_node:
+9. **Attach media** with clipform_upload_node_media. Include captions, set show_captions: true.` : ""}
+${media !== "text" ? "10" : "8"}. **Update end screen** with clipform_update_node:
     - show_score: true, icon: "trophy"
     - show_share_button: true
     - cta_type: "restart", cta_text: "Rewatch and try again?"
@@ -24203,9 +24233,9 @@ There are NO correct answers. Each option maps to one or more outcome categories
       { "min": 3, "max": 5, "title": "Casual Viewer", "message": "You caught the highlights but missed some details." },
       { "min": 6, "max": 8, "title": "Focused Student", "message": "You were paying attention - impressive." }
       \`\`\`
-11. **Publish** with clipform_update_form
-12. **Tag** - tags: ["quiz", "comprehension", "youtube"] + 2-3 topic words from the video
-13. **Log** with clipform_log_generation - include the YouTube URL, video title, and channel as sources
+${media !== "text" ? "11" : "9"}. **Publish** with clipform_update_form
+${media !== "text" ? "12" : "10"}. **Tag** - tags: ["quiz", "comprehension", "youtube"] + 2-3 topic words from the video
+${media !== "text" ? "13" : "11"}. **Log** with clipform_log_generation - include the YouTube URL, video title, and channel as sources
 
 ## Question Types for Comprehension
 
@@ -24217,14 +24247,7 @@ There are NO correct answers. Each option maps to one or more outcome categories
 | Contrast | "The video compares X and Y. What was the key difference?" | Comprehension depth |
 | Conclusion | "What was the presenter's final point?" | Watched to the end |
 
-Wrong answers should sound right to someone who didn't watch but googled the topic. The quiz should be unfair to non-watchers and fair to watchers.
-
-## Before building, ask
-
-1. What's the YouTube URL?
-2. How many questions? (default: 8)
-3. Who's the audience? (age, knowledge level)
-4. Media style: text only, still images, or slideshow video with narration?`
+Wrong answers should sound right to someone who didn't watch but googled the topic. The quiz should be unfair to non-watchers and fair to watchers.`
             }
           }
         ]
@@ -24235,46 +24258,50 @@ Wrong answers should sound right to someone who didn't watch but googled the top
     "create-funnel",
     {
       title: "Create a Funnel",
-      description: "Build a lead qualification funnel or product recommendation quiz with branching logic"
+      description: "Build a lead qualification funnel or product recommendation quiz with branching logic",
+      argsSchema: {
+        outcomes: external_exports.string().optional().describe("What segments or recommendations exist (e.g. 'Basic/Pro/Enterprise', or product names)"),
+        criteria: external_exports.string().optional().describe("What criteria determine routing (e.g. 'budget, team size, use case')"),
+        needs_contact: external_exports.boolean().optional().default(true).describe("Include contact capture (default: true)")
+      }
     },
-    async () => {
+    async (args) => {
       const sessionContext = await getSessionContext();
+      const outcomes = args.outcomes ?? "different outcomes";
+      const contact = args.needs_contact ?? true;
+      const criteriaNote = args.criteria ? ` Routing criteria: ${args.criteria}.` : "";
       return {
         messages: [
           {
             role: "user",
             content: {
               type: "text",
-              text: "I want to qualify leads or recommend products based on answers. What's the best approach?"
+              text: `I want to qualify leads or recommend products based on answers. Outcomes: ${outcomes}.${criteriaNote}`
             }
           },
+          resourceLink("guide-funnel", "clipform://guides/funnel", "Lead Qualification & Funnel Guide"),
           {
             role: "assistant",
             content: {
               type: "text",
-              text: `${sessionContext ? sessionContext + "\n\n" : ""}Here's how to build a qualification funnel with Clipform. Read the funnel guide (clipform://guides/funnel) for craft knowledge on branching logic and conversion.
+              text: `${sessionContext ? sessionContext + "\n\n" : ""}Here's how to build a qualification funnel with Clipform. Read the attached funnel guide for craft knowledge on branching logic and conversion.
 
 ## Workflow
 
-1. **Define outcomes** - what segments or recommendations exist? (e.g., Basic/Pro/Enterprise, or product categories)
+1. **Define outcomes** - what segments or recommendations exist? (${outcomes})
 2. **Create the form** with clipform_create_form:
    - show_step_counter: false (funnels feel shorter without it)
    - disable_back_navigation: true (prevents answer shopping that breaks scoring)
 3. **Add hook question** (type: "choice") - "What best describes you?" or "What are you looking for?" This segments the user.
 4. **Add qualifying questions** (type: "choice") - 2-3 questions that narrow down the need. Assign scores to each option.
-5. **Set branching logic** with clipform_set_logic - route based on answers
-6. **Add contact capture** (type: "contact") - name, email, phone. Place AFTER qualifying questions.
+5. **Set branching logic** with clipform_set_logic - route based on answers${contact ? `
+6. **Add contact capture** (type: "contact") - name, email, phone. Place AFTER qualifying questions.` : ""}
 7. **Update end screen** with score_ranges for personalised outcomes: "Based on your answers, we recommend..."
 8. **Publish** with clipform_update_form
 9. **Tag the form** - pass tags: one format (quiz/survey/interview/feedback/lead-gen), one genre (trivia/personality/nps/poll/testimonial), and 2-3 topic words
+10. **Log** with clipform_log_generation
 
-## Key rule: 3-5 questions max. Every extra step loses leads.
-
-## Before building, ask
-
-1. What outcomes are you routing to? (products, plans, team members, messages)
-2. What criteria determine the routing?
-3. Do you need contact capture?`
+## Key rule: 3-5 questions max. Every extra step loses leads.`
             }
           }
         ]
@@ -24328,7 +24355,8 @@ function registerResources(server) {
     "clipform://guides/quiz",
     {
       description: "Craft knowledge for writing engaging quizzes - difficulty curves, question psychology, narration style, scoring",
-      mimeType: "text/markdown"
+      mimeType: "text/markdown",
+      annotations: { audience: ["assistant"], priority: 0.8 }
     },
     async () => ({
       contents: [
@@ -24388,6 +24416,11 @@ Inspired by the Color Brain board game - every answer is identified by its colou
 - If two answer options would produce identical swatches, don't use that question.
 - Pair with a reveal composition (FlagReveal, image, or text) for the answer.
 
+## Settings
+
+- show_step_counter: true
+- disable_back_navigation: true (prevent going back to change answers after seeing feedback)
+
 ## Narration Style
 
 You're a quiz master, not a question reader. Each question's narration should:
@@ -24413,7 +24446,8 @@ ${MEDIA_WORKFLOW}`
     "clipform://guides/personality-quiz",
     {
       description: "Craft knowledge for building personality quizzes - category design, option weighting, outcome writing, no right/wrong answers",
-      mimeType: "text/markdown"
+      mimeType: "text/markdown",
+      annotations: { audience: ["assistant"], priority: 0.8 }
     },
     async () => ({
       contents: [
@@ -24463,6 +24497,11 @@ Each category needs a \`scoring_results\` entry on the end screen:
 - **Message**: 2-3 sentences that feel like a personalised insight. Reference specific traits the quiz measured.
 - **Optional CTA**: link to relevant content, product, or next step
 
+## Settings
+
+- show_step_counter: true
+- disable_back_navigation: true (prevent re-answering which skews category scores)
+
 ## Narration Style
 
 Reflective and curious, not quizmaster-y:
@@ -24484,7 +24523,8 @@ ${MEDIA_WORKFLOW}`
     "clipform://guides/comprehension-quiz",
     {
       description: "Craft knowledge for YouTube comprehension quizzes - extracting questions from transcripts, distractor design, audience adaptation",
-      mimeType: "text/markdown"
+      mimeType: "text/markdown",
+      annotations: { audience: ["assistant"], priority: 0.8 }
     },
     async () => ({
       contents: [
@@ -24535,6 +24575,11 @@ Make wrong answers plausible to someone who **didn't watch**:
 
 For young children: focus on "What did you SEE?" and "Who did what?" rather than abstract arguments.
 
+## Settings
+
+- show_step_counter: true
+- disable_back_navigation: true
+
 ## Narration style
 
 Reference the video naturally but don't spoil:
@@ -24555,7 +24600,8 @@ ${MEDIA_WORKFLOW}`
     "clipform://guides/interview",
     {
       description: "Craft knowledge for building interview and testimonial collection forms - warm-up pacing, open questions, consent, video responses",
-      mimeType: "text/markdown"
+      mimeType: "text/markdown",
+      annotations: { audience: ["assistant"], priority: 0.8 }
     },
     async () => ({
       contents: [
@@ -24609,7 +24655,8 @@ ${MEDIA_WORKFLOW}`
     "clipform://guides/survey",
     {
       description: "Craft knowledge for feedback surveys, NPS, and research forms - brevity, rating scales, respondent fatigue",
-      mimeType: "text/markdown"
+      mimeType: "text/markdown",
+      annotations: { audience: ["assistant"], priority: 0.8 }
     },
     async () => ({
       contents: [
@@ -24662,7 +24709,8 @@ ${WRITING_PRINCIPLES}`
     "clipform://guides/funnel",
     {
       description: "Craft knowledge for lead qualification funnels and product recommendation quizzes - branching logic, progressive profiling, conversion",
-      mimeType: "text/markdown"
+      mimeType: "text/markdown",
+      annotations: { audience: ["assistant"], priority: 0.8 }
     },
     async () => ({
       contents: [
@@ -24794,4 +24842,4 @@ export {
   JSONRPCMessageSchema,
   createServer
 };
-//# sourceMappingURL=chunk-MB6BZ2JN.js.map
+//# sourceMappingURL=chunk-GZH3JXEB.js.map