WaniWani SDK

What it does

WaniWani SDK is a TypeScript toolkit for developers building MCP-enabled applications on the WaniWani platform (app.waniwani.ai). It provides three main capabilities: batched MCP event tracking with retry/backoff logic, an embeddable chat widget for React and Next.js apps, and a declarative HTML data-attribute API for conversion and funnel tracking — no JavaScript required for basic analytics.

The SDK is pre-alpha (APIs change without notice) but actively developed, with v0.7.0 shipping typed exports for MCP, chat, knowledge base, and evaluation modules.

Key features

• Buffered event tracking — Batches MCP lifecycle events (tool.called, session.started, purchase.completed, etc.) to a V2 endpoint with automatic retry and backoff
• Embeddable chat UI — React and Next.js components for adding a chat interface to any app, with streaming support via @ai-sdk/react
• Declarative conversions — data-ww-conversion and data-ww-step HTML attributes fire analytics events on click without writing JS
• Knowledge base module — @waniwani/sdk/kb export for integrating retrieval into MCP servers
• Evals module — Built-in evaluation harness with Braintrust/autoevals integration for testing MCP tool quality

Installation

Claude Desktop — Not applicable (this is a developer SDK, not a standalone MCP server).

In your project:

npm install @waniwani/sdk

Then import the modules you need:

import { waniwani } from "@waniwani/sdk";
import { WaniWaniChat } from "@waniwani/sdk/chat";

VS Code Copilot / Cursor — No MCP server config needed; this is a client-side library.

Supported hosts

No specific MCP client hosts are confirmed in the README. The SDK is used by developers building MCP server/app integrations, not end-users configuring a client.