Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.waniwani.ai/llms.txt

Use this file to discover all available pages before exploring further.

This page shows you how to build an insurance quote MCP with @waniwani/sdk. The funnel collects what you need, validates it server-side, calls your pricing API, and shows the user a quote, all as one MCP tool inside ChatGPT, Claude, or any MCP client.

​
Production example

The most complete example in the docs is the Pet Insurance Quote flow. It demonstrates every pattern an insurance quote funnel needs:
  • Open-ended extraction. One question pulls 5+ fields out of free-form text.
  • Conversational follow-ups. Ask the rest 1-2 at a time, not as a form.
  • Async validation. Breed and location validated against your API before quoting.
  • Conditional branching. Different paths for mixed breeds, indoor cats, etc.
  • Confirmation widget. Show a summary card, let the user correct anything.
  • Correction loop. Corrections re-validate and re-display until the user confirms.
  • Pricing widget. Call the pricing API, render a grid of plan cards.
  • Adjustment loop. User tweaks deductible/copay, recalculate, re-render.
  • Compliance rules in the description. Embedded “no recommendation” guardrails.
Open the Pet Insurance Quote example for the full ~250-line code.

​
Why an MCP funnel beats a quote form

  • The AI asks naturally. Users say “I have a 2-year-old Golden Retriever named Max, he’s neutered” and the flow extracts 5 fields in one turn. A form would ask each separately.
  • No leaving the conversation. Users get quotes inside ChatGPT or Claude. No tab switch, no friction.
  • Compliance lives in the tool description. Insurance, finance, and healthcare can encode “no recommendation” rules where the model always reads them.
  • Branching is trivial. Mixed breed? Indoor cat? Conditional edges, not nested form fields.

​
Skeleton for any quote vertical

The pet insurance flow’s shape works for vehicle insurance, home insurance, business insurance, and any vertical with the same shape: collect details, validate, quote, adjust. 
import { createFlow, START, END } from "@waniwani/sdk/mcp";
import { z } from "zod";

export const quoteFunnel = createFlow({
  id: "vehicle_insurance_quote",
  title: "Vehicle Insurance Quote",
  description: "Use when a user wants a price quote for vehicle insurance.",
  state: {
    // Fields the user provides
    make: z.string().describe("Vehicle make"),
    model: z.string().describe("Vehicle model"),
    year: z.number().describe("Vehicle year"),
    postcode: z.string().describe("Owner postcode"),
    // Resolved by validation
    vehicleId: z.string().describe("Resolved vehicle ID from your DB"),
    // Confirmation state
    confirmed: z.boolean().describe("User confirmed the details"),
    // Quote state
    quoteId: z.string().describe("Quote ID returned by pricing API"),
    deductible: z.number().optional().describe("Chosen deductible"),
    pricingAction: z.enum(["adjust", "done"]).describe("Adjust loop control"),
  },
})
  .addNode({
    id: "ask_vehicle",
    label: "Ask about vehicle",
    run: ({ interrupt }) =>
      interrupt({
        make: {
          question: "Tell me about your vehicle: make, model, year, and your postcode.",
          context: "Extract make, model, year, and postcode from the user's response.",
        },
      }),
  })
  .addNode({
    id: "validate",
    label: "Validate vehicle + postcode",
    hideFromFunnel: true,
    run: async ({ state }) => {
      // your validation API call
      return { vehicleId: "..." };
    },
  })
  .addNode({
    id: "show_confirmation",
    label: "Confirm details",
    run: ({ state, showWidget }) => {
      // see Pet Insurance Quote example for the showWidget pattern
      return showWidget(/* ... */);
    },
  })
  .addNode({
    id: "show_pricing",
    label: "Show pricing",
    run: async ({ state, showWidget }) => {
      // call pricing API, render widget
      return { quoteId: "...", /* ... */ };
    },
  })
  // ... edges and adjustment loop
  .compile();
See the full Pet Insurance Quote code for working versions of show_confirmation, show_pricing, the correction loop, and the adjustment loop.

​
Add funnel analytics

Set WANIWANI_API_KEY to track step-by-step drop-off across your quote funnel: ask_vehicle → validate → show_confirmation → show_pricing. The dashboard shows you where users abandon, typically at confirmation or at the price reveal. See Tracking / Overview.

​
Next

Pet Insurance Quote (full example)

Widgets in flows

Build a booking MCP app

Build a sales funnel MCP