BugCapture MCP server

Give an AI coding agent (Claude Code, Cursor, …) direct access to your BugCapture bug reports over the Model Context Protocol. Paste a report link — or its id — and ask "fix this bug": the agent pulls the repro steps, console errors, failed network requests, and environment straight into its context.

Runs locally over stdio — no hosting, no cost. It talks to the BugCapture backend and authenticates with an API key you mint in the dashboard.

Tools

• list_bugs({ limit?, since? }) — your recent reports (id, title, severity, error counts).
• get_bug({ id }) — one report's full debug context, formatted for the agent. id also accepts a full report link — a dashboard URL (…/#/report/bug_…) or a share link (…/#/r/bug_…) — and the id is extracted for you.

Every call is scoped to the reports you captured — the API key carries your identity.

Setup

Requires Node.js 18+. Nothing to clone or install — npx fetches this server on first run.

1. Mint a key. In the BugCapture dashboard, open Settings → MCP / AI agents, create a key, and copy the bc_live_… value (shown once).

2. Register the server with your MCP client.

   Claude Code — one command:

   claude mcp add bugcapture --env BUGCAPTURE_API_KEY=bc_live_your_key -- npx -y bugcapture-mcp

   Or any client via .mcp.json:

   {
     "mcpServers": {
       "bugcapture": {
         "command": "npx",
         "args": ["-y", "bugcapture-mcp"],
         "env": { "BUGCAPTURE_API_KEY": "bc_live_your_key" }
       }
     }
   }

3. Use it. Paste a report link from the dashboard and ask "fix this bug" — or ask "list my BugCapture bugs", then "get bug bug_xxx and fix it".

Config

| Env var | Required | Default | |---|---|---| | BUGCAPTURE_API_KEY | yes | — | | BUGCAPTURE_API_BASE | no | prod mcpApi URL |

Point BUGCAPTURE_API_BASE at the Firebase emulator (http://localhost:5001/bugcapture-qa/asia-south1/mcpApi) to test locally.

Try it without an MCP client

macOS / Linux (bash):

BUGCAPTURE_API_KEY=bc_live_your_key npx @modelcontextprotocol/inspector npx -y bugcapture-mcp

Windows (PowerShell) — set the var first, then run:

$env:BUGCAPTURE_API_KEY = "bc_live_your_key"
npx @modelcontextprotocol/inspector npx -y bugcapture-mcp

The Inspector lists the tools and lets you call get_bug against a real report id.