Skip to main content
@waniwani/sdk lets you build multi-step conversational funnels on top of any MCP server. A single MCP tool drives the conversation: it asks the next question, validates the answer, branches on state, and persists progress across calls. ChatGPT, Claude, and any other MCP-capable client become the front-end.

What people build with it

Sales funnels

Qualify intent, capture lead data, route to the right next step.

Lead generation

Collect email, role, and use case. Push to your CRM.

Booking flows

Pick a service, pick a slot, confirm. Branch on availability.

Insurance and pricing quotes

Collect details, validate, return a quote with widget cards.

How it works

You declare a flow as a typed state graph. The graph compiles to one MCP tool that the model can call. The engine runs the graph, pauses to ask questions, branches on state, and resumes on the next tool call. Nothing in the model has to carry state between turns. The flow engine is open source. Set WANIWANI_API_KEY to connect the Waniwani Platform, which adds hosted state, tracking, funnel analytics, knowledge base, and a chat widget on top. The SDK is a library: you supply the McpServer, the transport and the build. If you would rather own none of that and write only tools, widgets and flows into a folder, start with the Kit, which depends on the SDK and registers your flows unchanged.

Next

Head to the Quickstart to get a flow running in under 5 minutes, or jump straight into building a funnel.