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
- Go to your GlitchTip instance:
https://your-glitchtip.com/settings/api-tokens - Click Create New Token
- 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, orignored. 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.