mcp-server-glitchtip

MCP server enabling LLMs to query issues, stacktraces, and resolve errors in GlitchTip.

GlitchTip is an open-source, self-hosted error tracking platform that's API-compatible with Sentry. This MCP server lets AI assistants like Claude directly access your error data to help debug and fix issues faster.

Features

• List Issues - Query all unresolved, resolved, or ignored issues
• Get Issue Details - Retrieve full stacktraces and error context
• Resolve Issues - Mark issues as resolved after fixing them

Installation

Using pip

pip install mcp-server-glitchtip

From source

git clone https://github.com/hffmnnj/mcp-server-glitchtip.git
cd mcp-server-glitchtip
pip install -e .

Configuration

1. Create a GlitchTip API Token

1. Go to your GlitchTip instance: https://your-glitchtip.com/settings/api-tokens
2. Click Create New Token
3. Copy the token

2. Find Your Organization and Project Slugs

Your organization slug is in the URL when viewing your organization:

https://your-glitchtip.com/organizations/{org-slug}/issues

Your project slug is visible in your project settings or URL:

https://your-glitchtip.com/organizations/{org-slug}/projects/{project-slug}

3. Add to Claude Code

claude mcp add mcp-server-glitchtip \
  -s user \
  -e GLITCHTIP_AUTH_TOKEN=your_token_here \
  -e GLITCHTIP_API_URL=https://your-glitchtip.com/api/0/ \
  -e GLITCHTIP_ORGANIZATION=your-org-slug \
  -e GLITCHTIP_PROJECT=your-project-slug \
  -- mcp-server-glitchtip

4. Add to Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "glitchtip": {
      "command": "mcp-server-glitchtip",
      "env": {
        "GLITCHTIP_AUTH_TOKEN": "your_token_here",
        "GLITCHTIP_API_URL": "https://your-glitchtip.com/api/0/",
        "GLITCHTIP_ORGANIZATION": "your-org-slug",
        "GLITCHTIP_PROJECT": "your-project-slug"
      }
    }
  }
}

Environment Variables

Variable	Required	Description	Example
GLITCHTIP_AUTH_TOKEN	Yes	API token from GlitchTip	abc123...
GLITCHTIP_API_URL	Yes	Base API URL (include trailing slash)	https://glitchtip.example.com/api/0/
GLITCHTIP_ORGANIZATION	Yes	Organization slug	my-org
GLITCHTIP_PROJECT	Yes	Project slug	my-app

Available Tools

get_glitchtip_issues

List all issues from your GlitchTip project.

Parameters:

• status (optional): Filter by status - unresolved, resolved, or ignored. Default: unresolved

Example response:

GlitchTip Issues (unresolved):

---
ID: 123 (PROJ-1)
Title: TypeError: Cannot read property 'foo' of undefined
Level: error | Count: 42
Culprit: app.js in handleClick
First: 2024-01-15T10:30:00Z | Last: 2024-01-15T14:22:00Z

get_glitchtip_issue

Get detailed information about a specific issue including the full stacktrace.

Parameters:

• issue_id (required): The numeric issue ID

resolve_glitchtip_issue

Mark an issue as resolved after fixing the underlying bug.

Parameters:

• issue_id (required): The numeric issue ID to resolve

Usage Examples

Once configured, you can ask Claude:

• "Show me all unresolved errors in GlitchTip"
• "What's the stacktrace for issue 123?"
• "What errors are happening most frequently?"
• "I fixed that null pointer bug, mark issue 456 as resolved"

Compatibility

This server works with any GlitchTip instance. GlitchTip uses a Sentry-compatible API, so the endpoints follow Sentry's API structure.

Tested with:

• GlitchTip 3.x+
• Python 3.10+

Development

# Clone the repo
git clone https://github.com/hffmnnj/mcp-server-glitchtip.git
cd mcp-server-glitchtip

# Create virtual environment
python -m venv venv
source venv/bin/activate  # or `venv\Scripts\activate` on Windows

# Install in development mode
pip install -e .

# Run the server locally
GLITCHTIP_AUTH_TOKEN=xxx \
GLITCHTIP_API_URL=https://your-glitchtip.com/api/0/ \
GLITCHTIP_ORGANIZATION=your-org \
GLITCHTIP_PROJECT=your-project \
mcp-server-glitchtip

Related Projects

• GlitchTip - Open source error tracking
• MCP - Model Context Protocol
• mcp-sentry - Similar MCP server for Sentry.io

License

MIT License - see LICENSE for details.