@clipform/mcp-server 1.33.0 → 1.34.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -4222,18 +4222,17 @@ function interviewWorkflow(args, sessionContext, authMode = "authenticated") {
4222
4222
  ## Workflow
4223
4223
 
4224
4224
  1. **Identify the ask** - what do you need from respondents? ${purpose}.
4225
- 2. **Create the form** with clipform_create_form:
4226
- - show_step_counter: true
4227
- - disable_back_navigation: false
4228
- 3. **Add a warm-up question** - something easy: "Tell us your name and role" (type: "open")
4229
- 4. **Add core questions** (type: "open") - 2-3 max, one topic per question.${format === "all" ? " Enable text + audio + video responses." : ` Enable ${format} responses.`}
4230
- 5. **Add contact collection** (type: "contact") - first name + email minimum${consent ? `
4231
- 6. **Add consent** - "I agree that my response may be used in [context]"` : ""}
4232
- 7. **Update end screen** - set expectations: "Thanks! We'll be in touch."
4233
- 8. **Optional - Rich Media:** Add TTS narration (clipform_generate_tts) with a warm, inviting tone - "We'd love to hear your story..." Video backgrounds (clipform_search_media \u2192 clipform_generate_video) on the intro question can set a professional tone.
4234
- 9. **Publish** with clipform_update_form
4235
- 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
4236
- 11. **Log** with clipform_log_generation`;
4225
+ 2. **Build the whole form in ONE clipform_create_form call** - pass nodes, settings, and tags together; do NOT create an empty form and add nodes one by one:
4226
+ - Settings: show_step_counter: true, disable_back_navigation: false
4227
+ - Warm-up question first (type: "open") - something easy: "Tell us your name and role"
4228
+ - 2-3 core questions (type: "open") - one topic per question.${format === "all" ? " Enable text + audio + video responses." : ` Enable ${format} responses.`}
4229
+ - Contact collection (type: "contact") - first name + email minimum${consent ? `
4230
+ - Consent node - "I agree that my response may be used in [context]"` : ""}
4231
+ - End screen that sets expectations: "Thanks! We'll be in touch."
4232
+ - tags: one format (quiz/survey/interview/feedback/lead-gen), one genre (trivia/personality/nps/poll/testimonial), and 2-3 topic words
4233
+ 3. **Optional - Rich Media:** Add TTS narration (clipform_generate_tts, batch all questions in one call) with a warm, inviting tone - "We'd love to hear your story..." Video backgrounds (clipform_search_media \u2192 clipform_generate_video) on the intro question can set a professional tone.
4234
+ 4. **Publish** with clipform_update_form
4235
+ 5. **Log** with clipform_log_generation`;
4237
4236
  }
4238
4237
  function surveyWorkflow(args, sessionContext, authMode = "authenticated") {
4239
4238
  const topic = args.topic ? ` for ${args.topic}` : "";
@@ -4244,18 +4243,17 @@ function surveyWorkflow(args, sessionContext, authMode = "authenticated") {
4244
4243
  ## Workflow
4245
4244
 
4246
4245
  1. **Define the key metric** - what's the one number you care about? (NPS, satisfaction, likelihood to recommend)
4247
- 2. **Create the form** with clipform_create_form:
4248
- - show_step_counter: true
4249
- - disable_back_navigation: false
4250
- 3. **Add key metric question first** (type: "choice" or "rating") - put it first while attention is highest
4251
- 4. **Add one "why?" follow-up** (type: "open") - "What's the main reason for your score?"
4252
- 5. **Add 2-3 specific questions** (type: "choice") - only ask what you'll act on${!anonymous ? `
4253
- 6. **Contact** - collect name + email for follow-up` : ""}
4254
- 7. **Optional - Rich Media:** For a more engaging experience, add TTS narration (clipform_generate_tts) for the intro or key questions, video backgrounds (clipform_search_media \u2192 clipform_generate_video), or background music (clipform_search_music).
4255
- 8. **Update end screen** - "Thanks for your feedback!"
4256
- 9. **Publish** with clipform_update_form
4257
- 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
4258
- 11. **Log** with clipform_log_generation
4246
+ 2. **Build the whole form in ONE clipform_create_form call** - pass nodes, settings, and tags together; do NOT create an empty form and add nodes one by one:
4247
+ - Settings: show_step_counter: true, disable_back_navigation: false
4248
+ - Key metric question FIRST (type: "choice" or "rating") - while attention is highest
4249
+ - One "why?" follow-up (type: "open") - "What's the main reason for your score?"
4250
+ - 2-3 specific questions (type: "choice") - only ask what you'll act on${!anonymous ? `
4251
+ - Contact collection (type: "contact") - name + email for follow-up` : ""}
4252
+ - End screen: "Thanks for your feedback!"
4253
+ - tags: one format (quiz/survey/interview/feedback/lead-gen), one genre (trivia/personality/nps/poll/testimonial), and 2-3 topic words
4254
+ 3. **Optional - Rich Media:** For a more engaging experience, add TTS narration (clipform_generate_tts) for the intro or key questions, video backgrounds (clipform_search_media \u2192 clipform_generate_video), or background music (clipform_search_music).
4255
+ 4. **Publish** with clipform_update_form
4256
+ 5. **Log** with clipform_log_generation
4259
4257
 
4260
4258
  ## Key rule: 5 questions max. Every extra question costs completions.`;
4261
4259
  }
@@ -4272,25 +4270,22 @@ function testimonialWorkflow(args, sessionContext, authMode = "authenticated") {
4272
4270
  ## Workflow
4273
4271
 
4274
4272
  1. **Define the story arc** - what transformation or experience do you want to capture?
4275
- 2. **Create the form** with clipform_create_form:
4276
- - show_step_counter: true
4277
- - disable_back_navigation: false
4278
- 3. **Add warm-up question** (type: "open") - "Tell us your name and [role/relationship/context]". Enable video + audio + text responses.
4279
- 4. **Add 2-3 storytelling prompts** (type: "open") - follow the before \u2192 during \u2192 after arc. Enable video responses. Example prompts:
4280
- - "What was your biggest challenge before?"
4281
- - "What was the experience like working with us?"
4282
- - "What's different now? What would you tell someone considering it?"
4283
- 5. **Add consent node** - "I agree that my response may be used in marketing materials, on the website, and in sales presentations."
4284
- 6. **Generate narration** with clipform_generate_tts - batch all prompts in a single call. Warm, appreciative tone - "We'd love to hear your story..." Keep each narration 5-8 seconds.
4285
- 7. **Optional: build video** for the intro/warm-up question to set the tone.
4286
- 8. **Update end screen** - "Thank you for sharing your story! Your experience will help others."
4287
- - icon: "party"
4288
- - No score, no restart CTA
4289
- 9. **Publish** with clipform_update_form
4290
- 10. **Tag the form** - pass tags: format "testimonial", genre "story", and 2-3 topic words
4291
- 11. **Log** with clipform_log_generation
4273
+ 2. **Build the whole form in ONE clipform_create_form call** - pass nodes, settings, and tags together; do NOT create an empty form and add nodes one by one:
4274
+ - Settings: show_step_counter: true, disable_back_navigation: false
4275
+ - Warm-up question (type: "open") - "Tell us your name and [role/relationship/context]". Enable video + audio + text responses.
4276
+ - 2-3 storytelling prompts (type: "open") - follow the before \u2192 during \u2192 after arc. Enable video responses. Example prompts:
4277
+ - "What was your biggest challenge before?"
4278
+ - "What was the experience like working with us?"
4279
+ - "What's different now? What would you tell someone considering it?"
4280
+ - Consent node - "I agree that my response may be used in marketing materials, on the website, and in sales presentations."
4281
+ - End screen: "Thank you for sharing your story! Your experience will help others." icon: "party", no score, no restart CTA
4282
+ - tags: format "testimonial", genre "story", and 2-3 topic words
4283
+ 3. **Generate narration** with clipform_generate_tts - batch all prompts in a single call. Warm, appreciative tone - "We'd love to hear your story..." Keep each narration 5-8 seconds.
4284
+ 4. **Optional: build video** for the intro/warm-up question to set the tone.
4285
+ 5. **Publish** with clipform_update_form
4286
+ 6. **Log** with clipform_log_generation
4292
4287
 
4293
- > **Text-only override:** If the user explicitly asked for text-only (no video), skip steps 6-7 (narration and video production).`;
4288
+ > **Text-only override:** If the user explicitly asked for text-only (no video), skip steps 3-4 (narration and video production).`;
4294
4289
  }
4295
4290
  function applicationWorkflow(args, sessionContext, authMode = "authenticated") {
4296
4291
  const role = args.role ?? "an application";
@@ -4300,20 +4295,17 @@ function applicationWorkflow(args, sessionContext, authMode = "authenticated") {
4300
4295
  ## Workflow
4301
4296
 
4302
4297
  1. **Define what you're screening for** - what qualifications matter, and what questions reveal fit?
4303
- 2. **Create the form** with clipform_create_form:
4304
- - show_step_counter: true
4305
- - disable_back_navigation: false
4306
- 3. **Add contact collection** (type: "contact") - name, email, phone. Place it first while motivation is high.
4307
- 4. **Add 2-3 structured screening questions** (type: "choice") - experience level, availability, relevant qualifications. These help you filter quickly.
4308
- 5. **Add 1-2 open response questions** (type: "open") - "Tell us why you're interested" or "Walk us through a relevant experience." Enable video + audio + text responses.
4309
- 6. **Optional: add "Anything else?"** (type: "open") - catches things you didn't think to ask.
4310
- 7. **Optional - Rich Media:** Add TTS narration (clipform_generate_tts) - professional and welcoming: "Thanks for your interest - let's get to know you." Video backgrounds (clipform_search_media \u2192 clipform_generate_video) on the intro can make the application feel more personal.
4311
- 8. **Update end screen** - "Your application has been submitted. We'll review it and get back to you."
4312
- - icon: "tick"
4313
- - No score, no restart
4314
- 9. **Publish** with clipform_update_form
4315
- 10. **Tag the form** - pass tags: format "application", genre "screening", and 2-3 topic words
4316
- 11. **Log** with clipform_log_generation`;
4298
+ 2. **Build the whole form in ONE clipform_create_form call** - pass nodes, settings, and tags together; do NOT create an empty form and add nodes one by one:
4299
+ - Settings: show_step_counter: true, disable_back_navigation: false
4300
+ - Contact collection first (type: "contact") - name, email, phone - while motivation is high
4301
+ - 2-3 structured screening questions (type: "choice") - experience level, availability, relevant qualifications. These help you filter quickly.
4302
+ - 1-2 open response questions (type: "open") - "Tell us why you're interested" or "Walk us through a relevant experience." Enable video + audio + text responses.
4303
+ - Optional "Anything else?" (type: "open") - catches things you didn't think to ask.
4304
+ - End screen: "Your application has been submitted. We'll review it and get back to you." icon: "tick", no score, no restart
4305
+ - tags: format "application", genre "screening", and 2-3 topic words
4306
+ 3. **Optional - Rich Media:** Add TTS narration (clipform_generate_tts) - professional and welcoming: "Thanks for your interest - let's get to know you." Video backgrounds (clipform_search_media \u2192 clipform_generate_video) on the intro can make the application feel more personal.
4307
+ 4. **Publish** with clipform_update_form
4308
+ 5. **Log** with clipform_log_generation`;
4317
4309
  }
4318
4310
  function bookingWorkflow(args, sessionContext, authMode = "authenticated") {
4319
4311
  const eventName = args.event_name ?? "an event";
@@ -4324,19 +4316,15 @@ function bookingWorkflow(args, sessionContext, authMode = "authenticated") {
4324
4316
  ## Workflow
4325
4317
 
4326
4318
  1. **Define the essentials** - what info do you actually need from attendees? Keep the list short.
4327
- 2. **Create the form** with clipform_create_form:
4328
- - show_step_counter: false (it's so short, a counter adds unnecessary UI)
4329
- - disable_back_navigation: false
4319
+ 2. **Build the whole form in ONE clipform_create_form call** - pass nodes, settings, and tags together; do NOT create an empty form and add nodes one by one:
4320
+ - Settings: show_step_counter: false (it's so short, a counter adds unnecessary UI), disable_back_navigation: false
4321
+ - Contact collection (type: "contact") - name + email minimum. Add phone only if needed.
4322
+ - 1-3 event-specific questions (type: "choice") - session preferences, dietary requirements, experience level. Only ask what you'll use.
4323
+ - End screen: "You're registered! Here's what to expect." Include event details (date, time, location/link) in the message. icon: "tick", no score, no restart, cta_type: "external_link" with a URL to calendar invite or event page (if available)
4324
+ - tags: format "registration", genre "${eventType}", and 2-3 topic words
4330
4325
  3. **Optional: add welcome video** - a short intro from the host. Generate narration with clipform_generate_tts, then build a video with clipform_search_media + clipform_generate_video.
4331
- 4. **Add contact collection** (type: "contact") - name + email minimum. Add phone only if needed.
4332
- 5. **Add 1-3 event-specific questions** (type: "choice") - session preferences, dietary requirements, experience level. Only ask what you'll use.
4333
- 6. **Update end screen** - "You're registered! Here's what to expect." Include event details (date, time, location/link) in the message.
4334
- - icon: "tick"
4335
- - No score, no restart
4336
- - cta_type: "external_link" with a URL to calendar invite or event page (if available)
4337
- 7. **Publish** with clipform_update_form
4338
- 8. **Tag the form** - pass tags: format "registration", genre "${eventType}", and 2-3 topic words
4339
- 9. **Log** with clipform_log_generation
4326
+ 4. **Publish** with clipform_update_form
4327
+ 5. **Log** with clipform_log_generation
4340
4328
 
4341
4329
  ## Key rule: 3-5 fields max. Every extra field costs registrations.`;
4342
4330
  }
@@ -4659,4 +4647,4 @@ export {
4659
4647
  getWorkflowText,
4660
4648
  registerPrompts
4661
4649
  };
4662
- //# sourceMappingURL=chunk-SY7YZPSC.js.map
4650
+ //# sourceMappingURL=chunk-JOJJ2XFL.js.map