Skip to main content

Cursor reads the exception you just hit

Start Buggregator with MCP_ENABLED=true and add it to Cursor's mcp.json with the command buggregator and the argument mcp. With this Cursor MCP setup, Cursor reads the Sentry error you just hit, with its stack trace, plus your variable dumps and profiles, from the Buggregator on your machine.

Steps

1. Turn MCP on

MCP is off by default. Start Buggregator with this variable, or set mcp.enabled: true in buggregator.yaml.

bash
MCP_ENABLED=true

2. Add the server to mcp.json

Cursor reads MCP servers from .cursor/mcp.json in your project, or from ~/.cursor/mcp.json for every project. The command and its argument go in separate fields. buggregator is the binary: the name works when it is on your PATH, otherwise give the full path.

json
{
  "mcpServers": {
    "buggregator": {
      "command": "buggregator",
      "args": ["mcp"]
    }
  }
}

3. Use the HTTP URL if Buggregator runs in Docker

Run Buggregator with the HTTP transport, then give Cursor a url instead of command and args.

yaml
services:
  buggregator:
    image: ghcr.io/buggregator/server:latest
    ports:
      - 127.0.0.1:8000:8000
      - 127.0.0.1:8001:8001    # MCP HTTP port
    environment:
      MCP_ENABLED: "true"
      MCP_TRANSPORT: http
      MCP_ADDR: ":8001"
json
{
  "mcpServers": {
    "buggregator": {
      "url": "http://localhost:8001/mcp"
    }
  }
}

4. Ask about the error

Trigger the error, then ask Cursor about it. The assistant picks the tools.

text
"Show me the latest Sentry errors"
"What's the stack trace for this exception?"
"What value was dumped in the last VarDumper event?"

Why it works

Buggregator has a built-in MCP server, and mcp.json is Cursor's own format (https://cursor.com/docs/mcp). sentry_event returns an error's message, severity, exception chain with stack traces and environment; vardump_get returns a dump as plain text; profiler_summary and profiler_top give the slowest functions. Cursor reads the data your app already sent, so nothing is copied by hand.

Checked on with Buggregator v2.8.0

Setup in 60 seconds

No registration. No account. Start it and point your app at it.

1

Start Buggregator

One file, installed with one command. The web UI opens on port 8000. Prefer containers? Use the Docker tab.

$ curl -fsSL https://raw.githubusercontent.com/buggregator/server/master/scripts/install.sh | sh
$ HTTP_ADDR=127.0.0.1:8000 \
  SMTP_ADDR=127.0.0.1:1025 \
  VAR_DUMPER_ADDR=127.0.0.1:9912 \
  MONOLOG_ADDR=127.0.0.1:9913 \
  PROXY_ADDR=127.0.0.1:8080 \
  ~/.local/bin/buggregator

The script picks the file for your CPU: Intel/AMD or ARM.

One file for Linux, macOS and Windows, about 40 MB. Nothing else to install.

This run line keeps it on this computer. Without the *_ADDR settings it listens on all network interfaces →

Rather not run a script? Download the file yourself →

Runs on Windows, macOS and Linux, on Intel/AMD and ARM.

Prefer not to do it yourself? Your AI agent can set Buggregator up for you →