bugsink-mcp

MCP (Model Context Protocol) server for Bugsink error tracking.

Browse teams, projects, issues, events, stacktraces and releases from any MCP-compatible client — Cursor, Claude Desktop, etc.

Quick Start

Install via npm (recommended)

npm install -g bugsink-mcp

Or run with npx

npx bugsink-mcp

Configuration

You need a Bugsink API token. Generate one on your Bugsink instance:

# Docker / Coolify:
docker exec <bugsink-container> bugsink-manage create_auth_token

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "bugsink": {
      "command": "npx",
      "args": ["-y", "bugsink-mcp"],
      "env": {
        "BUGSINK_URL": "https://your-bugsink-instance.com",
        "BUGSINK_TOKEN": "your-api-token"
      }
    }
  }
}

Claude Desktop

Add to your Claude Desktop config:

{
  "mcpServers": {
    "bugsink": {
      "command": "npx",
      "args": ["-y", "bugsink-mcp"],
      "env": {
        "BUGSINK_URL": "https://your-bugsink-instance.com",
        "BUGSINK_TOKEN": "your-api-token"
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | |---|---|---| | BUGSINK_URL | Yes | Base URL of your Bugsink instance (no trailing slash) | | BUGSINK_TOKEN | Yes | API bearer token |

Available Tools

| Tool | Description | |---|---| | test_connection | Verify connectivity to your Bugsink instance | | list_teams | List all teams | | list_projects | List all projects | | get_project | Get project details including DSN | | list_issues | List issues (grouped errors) for a project, with pagination | | get_issue | Get detailed info about a specific issue | | list_events | List individual error occurrences for an issue | | get_event | Get full event detail including tags and contexts | | get_stacktrace | Get the full stacktrace for an event | | list_releases | List releases, optionally filtered by project | | get_release | Get detailed release information |

License

MIT