# Tracebug

> Tracebug is an open-source MCP server for developer tools. Local MCP server that lets coding agents read TraceBug browser bug reports. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Chrome extension, firefox-extension, CLI
- **Website:** https://tracebug.dev
- **Repository:** https://github.com/prashantsinghmangat/tracebug-ai
- **MCP Registry name:** io.github.prashantsinghmangat/tracebug
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

A TraceBug report is a single offline .html file holding clicks and typing, console errors, network requests, annotated screenshots, navigation and environment details. This MCP server runs over stdio on your machine, finds exported reports in Downloads and lets Claude Code, Cursor, Windsurf or VS Code investigate from that evidence.

The workflow is: capture a bug in the browser extension, export the replay, add the server once with a single claude mcp add command, then ask your agent to debug it. Nothing is uploaded and there is no backend.

The same capture can also be copied as a GitHub issue, Jira markup, PDF or a Playwright test, or sent to GitHub, Linear and Slack with your own token after a prompt.

## Features

- **Offline report format:** One self-contained file with replay, console, network and screenshots.
- **Local stdio server:** Runs on your machine and uploads nothing.
- **Auto-discovery:** Finds exported reports in the Downloads folder.
- **Export options:** Issue Markdown, Jira markup, PDF and a Playwright test.
- **Browser capture:** Chrome and Firefox extension plus an npm SDK.

## Good for

- Hand an agent a reproducible browser bug
- Debug a failed request from captured network data
- Turn a bug into a GitHub or Linear issue
- Share a bug with someone who has no account

## Install

### Claude Code (Terminal)

```sh
claude mcp add tracebug -- npx -y tracebug
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "tracebug": {
      "command": "npx",
      "args": [
        "-y",
        "tracebug"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "tracebug": {
      "command": "npx",
      "args": [
        "-y",
        "tracebug"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "tracebug": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "tracebug"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "tracebug": {
      "command": "npx",
      "args": [
        "-y",
        "tracebug"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "tracebug": {
      "command": "npx",
      "args": [
        "-y",
        "tracebug"
      ]
    }
  }
}
```

## FAQ

### Is it free?

Yes. Local capture, exports and the MCP server are free and MIT licensed; optional cloud features may come later as paid add-ons.

### Does data leave my machine?

The MCP server runs locally and the pricing page says reports live on your machine.

### Which agents can read reports?

Claude Code, Cursor, Windsurf and VS Code.

### How do I add it?

Run claude mcp add -s user tracebug -- npx -y tracebug mcp.

### Is Tracebug free?

Yes. Tracebug is open source, so you can use and self-host it for free.

### How do I add Tracebug to Claude Code?

Run this command in your terminal: claude mcp add tracebug -- npx -y tracebug

### What are the best alternatives to Tracebug?

The closest alternatives to Tracebug are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/tracebug
