MCP

BetterBugs MCP (Model Context Protocol) enables you to put your BetterBugs report links directly in AI Agents for AI-assisted RCA and super fast debugging sessions.

BetterBugs MCP: Quick Overview

The BetterBugs MCP (Model Context Protocol) enables you to load BetterBugs bug reports (via report links) directly to your preferred AI Agents and developer environments with MCP Client capabilities (such as Cursor, VS Code, and Windsurf).

Once you configure BetterBugs with your MCP Client, all you need is to paste the BetterBugs bug report link(s) along with your prompt and context to debug it.

The AI Agent then accesses the complete bug report (that comes bundled with the details and technical info, including screenshot, console logs, network requests, events, summary, steps to reproduce, and other info).

The result? You get instant root cause analysis of the issue, possible solutions, and other debugging info and steps.

As a developer, you can use the BetterBugs MCP server AI-debugging combined with your manual skills to resolve software issues significantly faster and better.

Prerequisites: What do you need to start using BetterBugs MCP

To start using it, create a bug report using BetterBugs extension and include the report link in your prompt.

Here’re the steps:

Steps to Create a Bug Report Using BetterBugs

1. Install the BetterBugs Chrome extension.

2. Open extension and capture the bug using the “Capture Screenshot” option.

3. Annotate the screenshot to highlight the bug (optional)

4. In the Summary area at the right, select the BetterBugs Workspace and Project. This is the location within BetterBugs where your report would save once you finish creating the report.

5. Add bug title and description. Or, just enable the “AI” toggle (as in the demo) to add AI-generated title, summary, and steps to reproduce. The technical details (console logs, env info, network, and others) would auto-attach to the bug report.

6. Hit “Create Session” button from the top right to create a report.

Okay! Your report is ready to be consumed by the AI Agent through the MCP Client.

How to setup BetterBugs MCP it for your preferred MCP Client

Here, we've provided practical steps to integrate BetterBugs MCP with the following Clients:

• Visual Studio Code

• Cursor

• Windsurf

• Google Antigravity

• Claude App

• Claude Code

• Trae IDE

• Other MCP Clients

VS Code

Visual Studio Code

Steps to Integrate BetterBugs MCP with VS Code

1. Open VS Code and press CTRL/CMD + P

2. Search >MCP: Add Server

3. Select HTTP (HTTP or Server-Sent Events)

4. Add the following URL: https://mcp.betterbugs.io/mcp

5. Give the MCP Server a name, such as BetterBugs

6. The mcp.json file opens instantly with the following code snippet:

{
  "servers": {
    "BetterBugs": {
      "url": "https://mcp.betterbugs.io/mcp",
      "type": "http"
    }
  },
  "inputs": []
}

For first time users, you’d be prompted to authenticate to mcp.betterbugs.io.

• From the dialog box, click “Allow” or "Open" to start authentication. Click “Authorize” (from the BetterBugs web page) and you’re good to go!

• If the dialog box isn’t auto-displayed, you can click the “Start” text available within your MCP code snippet to start the authentication process.

Or, if it's authenticated instantly (as in the demo), you'd find it "Running" state within your code snippet.

Cursor

Windsurf

Antigravity

Claude App

Claude Code

Trae IDE

For Other MCP Clients

How to use BetterBugs MCP for AI debugging: Windsurf Example

Once you’re good with the config steps, here’s how to use it:

Example: BetterBugs MCP + Windsurf in Action to Fix Code

1. Create a bug report using BetterBugs and copy the report link.

2. Paste the BetterBugs report link in your MCP client chat space along with the prompt and context for it.

3. If required, approve any requests that the AI agent makes to provide more info and context. Continue your debugging session in the chat interface.

BetterBugs MCP: Available tools/properties

Tools/Property Names	Description
getUserDetails	Get authenticated user profile, available workspaces, and account information.
listWorkspaces	Retrieve all workspaces the user has access to, including workspace metadata, permissions, and project counts.
listProjects	List all projects within a specific workspace, including project status, creation dates, and metadata. Requires a workspace_id parameter.
getBugDetails	Fetch comprehensive bug information including title, description, status, priority, reporter, timestamps, and visual evidence (screenshots, screen recordings). Returns structured bug data with metadata.
listBugs	Retrieve all bugs for a specific project, including bug summaries, status, priority, and basic metadata.
getScreenshot	Get a screenshot from the CDN. Requires screenshot_url. Use this to get a screenshot from the CDN. Must be called after getBugDetails. Essential for enhanced visual analysis.
getBugLogs	Get detailed technical logs for a specific bug including console logs, network requests, user interactions, and step-by-step reproduction data.

Prompt Example: Using BetterBugs MCP with Cursor

Prompt Example: Using BetterBugs MCP with Cursor

Prompt

Analyze the following report <BetterBugs Report Link> and provide a RCA for it. Suggest fixes and test cases for the issue. Provide the steps to resolve the issue.

BetterBugs Tools and AI Agent

• BetterBugs Report link (bundled with Screenshot and other technical details)

• BetterBugs MCP

• Cursor

Frequently Asked Question (FAQs)

1 - Can I use more than one BetterBugs report link in my prompt?

Yes. You can use more than one bug report link for analysis and troubleshooting the issue. However, we highly recommend using one report link at a time. This allows your AI agent to perform optimally and cohesively for better context analysis.

2 - Can I use the MCP without BetterBugs Chrome Extension?

Yes. All you need is the BetterBugs report link from any of your team members or end-user who uses the extension for creating BetterBugs reports. Same way, to analyze your own BetterBugs report you’d need the extension to create your reports. Else, you can use report links from others.

3 - Do BetterBugs MCP share the MCP data to third-party AI providers for training purposes?

No. BetterBugs does not auto-share or analyze your MCP data for training purposes. You can check out our AI privacy policies here.

4 - How do the BetterBugs admins control what MCP can access?

BetterBugs MCP works with the exact permissions set for the BetterBugs report link. The MCP has no access to any data that the user (whom the BetterBugs report belongs to) can’t see already.