bugcatcher-mcp

bugcatcher-mcp

MCP (Model Context Protocol) server for BugCatcher, exposes bug reports, AI diagnosis, and status management to AI coding tools like Cursor, Claude, and Windsurf.

Installation

npx -y bugcatcher-mcp

Or add to your MCP config (e.g. ~/.cursor/mcp.json):

{
  "mcpServers": {
    "bugcatcher": {
      "command": "npx",
      "args": ["-y", "bugcatcher-mcp"],
      "env": {
        "BUGCATCHER_API_KEY": "your_api_key_here",
        "BUGCATCHER_URL": "https://bugcatcher.app"
      }
    }
  }
}

Important: Use https://bugcatcher.app (without www). The www subdomain redirects and can strip the Authorization header, causing "Missing API key" errors.

Setup

1. Get your API key

Go to your BugCatcher dashboard, open your project settings, and copy the API key (starts with bc_).

2. Configure

• Cursor: ~/.cursor/mcp.json
• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
• Windsurf: MCP settings in the IDE

For local development, set BUGCATCHER_URL to http://localhost:3000.

Note: MCP access requires a paid plan (BUILDER+). In development mode, access is unrestricted.

Available Tools

Tool	Description
list_bugs	List bug reports with filters (status, severity, limit)
get_bug_detail	Full bug report with AI diagnosis, click trail, telemetry
get_suggested_fix	Fix context optimized for AI coding
mark_fixed	Mark a bug as fixed after applying the code change

Usage Examples

In Cursor, Claude, or Windsurf:

• "Show me all open bugs from BugCatcher"
• "Get details for bug cmxyz123"
• "What's the suggested fix for the latest critical bug?"
• "Mark bug cmxyz123 as fixed"

Environment Variables

Variable	Required	Description
BUGCATCHER_API_KEY	Yes	Your project API key (starts with bc_)
BUGCATCHER_URL	No	API base URL (default: https://bugcatcher.app). Use without www to avoid redirect stripping auth.

Troubleshooting

Error	Cause	Fix
Missing API key	BUGCATCHER_URL uses www.bugcatcher.app; redirect strips Authorization header	Use https://bugcatcher.app (no www)
Invalid API key	Wrong or revoked key	Copy the key from dashboard → project settings
MCP access requires a paid plan	Free plan	Upgrade at bugcatcher.app/dashboard/upgrade

Requirements

• Paid plan required (BUILDER or higher). Free plan users will see a 403 error with upgrade instructions.
• In development mode (NODE_ENV=development), MCP access is available regardless of plan.

Links

• npm: bugcatcher-mcp
• MCP Registry: io.github.fDiosc/bugcatcher-mcp
• Source: github.com/fDiosc/bugcatcher

License

MIT