Documentation
Quick Start
1 · Run the full stack
# PostgreSQL fixture + collector + store + api + mcp
git clone https://github.com/breakingthecloud/bonito
cd bonito && docker compose -f deploy/docker-compose.yml up -d
2 · Query the deep view
# Top slow queries (API is private — X-API-Key required)
curl -H "X-API-Key: change-me" localhost:8100/queries/top?limit=5
curl -H "X-API-Key: change-me" localhost:8100/baseline/-6842865755026457642
3 · Give an AI agent the tools
# 8 MCP tools: slow queries, locks, blocking tree, plans, waits, baselines, remediation
claude mcp add bonito -- bonito-mcp
# Ask it:
"who is blocking whom, and what should I do?"
Components
bonito-collector — read-only PostgreSQL collector (top queries, locks, waits, bloat, EXPLAIN)
bonito-store — SQLite event store + 7-day baselines + retention
bonito-api — FastAPI query layer (private deploy, public OpenAPI contract)
bonito-mcp — MCP server, 8 tools for Claude/Bedrock/Strands
Full reference docs live in the repo: github.com/breakingthecloud/bonito → docs/
Endpoints, env vars, event schema, MCP tools, retention, security model.