Developers

Waniwani for developers

Waniwani is the AI distribution platform: an MCP app that represents your product inside ChatGPT, Claude, Gemini, and Perplexity, plus the analytics and compliance layer around it. Everything a developer or a coding agent needs is listed below, at URLs that do not move.

Waniwani API documentation

The developer portal covers the Waniwani platform API, the SDK, and the hosted MCP server. It is public, needs no login, and ships an agent-readable index.

  • Waniwani developer documentation

    Full documentation site: SDK guides, MCP server reference, platform configuration, deployment.

    https://docs.waniwani.ai

  • Waniwani docs llms.txt

    Agent-readable index of every documentation page, with a one-line summary per link.

    https://docs.waniwani.ai/llms.txt

  • Waniwani docs llms-full.txt

    The entire documentation set concatenated as plain markdown, for agents that want one fetch.

    https://docs.waniwani.ai/llms-full.txt

  • Waniwani SDK quickstart

    Get a flow running in under five minutes, in OSS, free-tier, or self-hosted mode.

    https://docs.waniwani.ai/sdk/quickstart

Waniwani OpenAPI specification

Machine-readable descriptions of the HTTP surfaces. Point a code generator or a function-calling agent at either file.

  • Waniwani website API OpenAPI spec

    OpenAPI 3.1 description of the public endpoints on waniwani.ai, including the shared JSON error model.

    https://waniwani.ai/openapi.json

  • Waniwani platform API reference

    OpenAPI document behind the API reference section of the developer portal.

    https://docs.waniwani.ai/api-reference/openapi.json

  • Waniwani website API index

    JSON service index listing every endpoint on this domain, the error envelope, and links back to the specs.

    https://waniwani.ai/api

Waniwani MCP server

Waniwani runs a hosted Model Context Protocol server over Streamable HTTP. Connect Claude, Cursor, or ChatGPT and operate the platform conversationally: environments, API keys, analytics, session breakdowns.

  • Waniwani MCP server (US)

    Streamable HTTP endpoint, OAuth 2.1 with PKCE, four tools: whoami, set_active_org, search, execute.

    https://mcp.waniwani.ai/mcp

  • Waniwani MCP server (EU)

    Same server, EU data residency. Use the region your organization's data lives in.

    https://eu.mcp.waniwani.ai/mcp

  • Waniwani MCP server card

    Discovery manifest for the MCP server: endpoints, transport, auth, and the advertised tool list.

    https://waniwani.ai/.well-known/mcp/server-card.json

  • Waniwani MCP server documentation

    What the server does, example prompts, and the capability categories it exposes.

    https://docs.waniwani.ai/mcp-server/overview

  • Connect an AI client to Waniwani MCP

    Client-by-client setup for claude.ai, Claude Code, Cursor, and ChatGPT, plus troubleshooting.

    https://docs.waniwani.ai/mcp-server/connect

Waniwani authentication

The MCP server is an OAuth 2.1 protected resource. It advertises its authorization server through RFC 9728 metadata and returns a WWW-Authenticate challenge on unauthenticated calls, so an agent can discover the flow without reading any prose.

  • Waniwani OAuth protected resource metadata

    RFC 9728 document naming the authorization server (app.waniwani.ai) and the supported scopes.

    https://mcp.waniwani.ai/.well-known/oauth-protected-resource

  • Waniwani MCP scopes and consent

    How the four tools work, how scopes are checked, and what the sandboxed execute tool can reach.

    https://docs.waniwani.ai/mcp-server/how-it-works

  • Waniwani API key setup

    Create a WANIWANI_API_KEY on the free tier for SDK tracking, KV state, and the knowledge base.

    https://docs.waniwani.ai/sdk/configuration/api-key

  • Waniwani security and key management

    Encryption at rest, key management, and rotation.

    https://docs.waniwani.ai/sdk/configuration/security

Waniwani SDK and CLI

@waniwani/sdk is MIT licensed. A typed state graph compiles to a single MCP tool, so a multi-step funnel survives being driven by a model.

  • @waniwani/sdk on npm

    TypeScript SDK for building MCP funnels: createFlow, StateGraph, KvStore adapters.

    https://www.npmjs.com/package/@waniwani/sdk

  • @waniwani/cli on npm

    Wire a local repo to a Waniwani agent: login, connect, dev, playground bridge.

    https://www.npmjs.com/package/@waniwani/cli

  • Waniwani SDK on GitHub

    Source, issues, and the AGENTS.md rules for coding agents.

    https://github.com/WaniWani-AI/sdk

  • Waniwani MCP distribution template

    Starter repo for a production distribution MCP.

    https://github.com/WaniWani-AI/mcp-distribution-template

  • Waniwani agent skills

    Published skills for coding agents. Install with npx skills add WaniWani-AI/sdk -s waniwani-sdk.

    https://skills.sh/waniwani-ai

Waniwani agent-readable files

Predictable URLs on this domain, for agents that would rather fetch a file than parse a page.

Connect the Waniwani MCP server

Add the endpoint to any MCP client. The server speaks Streamable HTTP and authenticates with OAuth 2.1, so there is no API key to paste and no secret to rotate.

{
  "mcpServers": {
    "waniwani": {
      "type": "http",
      "url": "https://mcp.waniwani.ai/mcp"
    }
  }
}

Step-by-step setup for claude.ai, Claude Code, Cursor, and ChatGPT is in the connect guide.

Reading this as an agent

This page is also served as plain markdown at waniwani.ai/developers.md, and the same list is mirrored in waniwani.ai/llms.txt. The markdown twin is generated from the same source as this page, so the two cannot drift apart.