Kairo

Kairo is an MCP server that closes the loop between code generation and test verification.

It autonomously analyzes a project → generates Playwright tests via OpenAI → runs them → classifies failures → recommends fixes — iterating up to 3 times.

How it works

analyze → generate tests → run → classify → fix → rerun (max 3x)

Exit conditions: all pass · iteration 3 reached · only flaky/env failures · app unresponsive

Related MCP server: Assert

Install

npm install -g @kairo/mcp

Or use via npx (no install needed):

{
  "mcpServers": {
    "kairo": {
      "command": "npx",
      "args": ["-y", "@kairo/mcp"],
      "env": {
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

MCP Tools

Dashboard

Start the API:

cd apps/api && pnpm dev

Start the dashboard:

cd apps/dashboard && pnpm dev
# → http://localhost:5173

Development

pnpm install
pnpm typecheck     # typecheck all packages
pnpm build         # build all packages
pnpm test          # run all tests

Environment Variables

Stack

• packages/analyzer — Project analysis (stack, routes, auth)

• packages/generator — OpenAI-powered test generation

• packages/runner — Playwright executor with double-run

• packages/classifier — Deterministic failure classification

• packages/fixer — OpenAI fix recommendations

• packages/mcp — MCP server + orchestration loop

• apps/api — Express REST API + SQLite

• apps/dashboard — React + Vite + HeroUI dashboard