# Bugsby

> The MCP visualizer. Point Bugsby at any TypeScript/JavaScript package that registers MCP tools via `@modelcontextprotocol/sdk` and it turns each tool into an interactive flowchart — every function, branch, and I/O call — narrated in plain English, without opening a single file. Built for developers supervising AI coding agents who need ground truth of what's actually in their repo. Local-first: the engine runs on your machine, on your own model; your source never leaves your box.

## Install & run

```sh
npm i -g @bugsby/cli
bugsby activate <license-key>          # one-time; buy a license at https://bugsby.dev
bugsby start                           # draws a flowchart for every MCP tool in the current directory
bugsby start --target /path/to/pkg     # analyze a different package
# no global install: npx @bugsby/cli start
```

Bugsby boots a local server, opens your browser, and draws a flowchart for each MCP tool it finds. The left pane lists every tool; click one for its description, a plain-English narration of what an agent does by invoking it, and a structural call tree of every function reached.

## What it does

- Turns each MCP tool into an interactive, auto-laid-out node graph — the shape of what it does, at a glance.
- Drill into any node to expand the functions it calls, down to the leaves (call-tree depth capped at 3).
- Criticality & I/O map: accent-highlighted paths show which steps touch the network, disk, model, or your data.
- Branches & control flow (try/catch, if/else, loops) are drawn as the diagram, not buried in nested source.
- Plain-English narration behind every node, grounded in your actual code and cached per tool.
- Local-first & private: runs on your machine; source is never uploaded.

## Requirements

- Node.js 24+
- A TypeScript or JavaScript MCP package built on `@modelcontextprotocol/sdk` (registers tools via `setRequestHandler(CallToolRequestSchema, ...)`). Python and other languages are not supported yet.
- A model provider — one of: local Ollama (default fallback; pull `qwen2.5-coder:7b`), a `GROQ_API_KEY` (free tier), or `ANTHROPIC_API_KEY` / an existing Claude Code subscription.
- A Bugsby license (see pricing).

## Pricing

- One-time payment of $39 USD for a perpetual license (1 developer seat). No subscription, no expiry. The key is verified locally — no account, no phone-home.

## Links

- Website: https://bugsby.dev
- npm package: https://www.npmjs.com/package/@bugsby/cli
- Full docs (README mirror): https://bugsby.dev/llms-full.txt
- Contact / support: https://bugsby.dev/contact