home / mcp / glitchtip mcp server

GlitchTip MCP Server

Queries GlitchTip errors, retrieves stack traces, and resolves issues via MCP.

Installation

Add the following to your MCP client configuration file.

Configuration

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

You can run a dedicated MCP server that lets Claude-like assistants query GlitchTip errors, retrieve stack traces, and mark issues as resolved. This makes debugging faster by giving your AI direct access to your error data in a controlled, programmable way.

How to use

You interact with the GlitchTip MCP server through your MCP client. Start by configuring the server with your GlitchTip credentials, then use the available tools to list issues, view detailed error information, and resolve items once you have fixed them. In practice, you will: list unresolved or any issues to understand current errors; fetch an issue’s full stacktrace and context to diagnose the bug; and mark issues as resolved after applying a fix.

How to install

Prerequisites you need before installing: Python 3.10+ and a working internet connection.

# Install from PyPI
pip install mcp-server-glitchtip

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

Configuration and running the server

Prepare your GlitchTip access details and run the MCP server locally. You provide your API token, the GlitchTip API URL, and the target GlitchTip organization and project.

Set these environment variables and start the server: - GLITCHTIP_AUTH_TOKEN: your GlitchTip API token - GLITCHTIP_API_URL: base API URL end with a trailing slash - GLITCHTIP_ORGANIZATION: your organization slug - GLITCHTIP_PROJECT: your project slug Then run the MCP server command.

Example configuration and environment for the MCP server

{
  "mcpServers": {
    "glitchtip": {
      "command": "mcp-server-glitchtip",
      "args": [],
      "env": {
        "GLITCHTIP_AUTH_TOKEN": "YOUR_TOKEN",
        "GLITCHTIP_API_URL": "https://your-glitchtip.com/api/0/",
        "GLITCHTIP_ORGANIZATION": "your-org-slug",
        "GLITCHTIP_PROJECT": "your-project-slug"
      }
    }
  },
  "envVars": [
    {"name": "GLITCHTIP_AUTH_TOKEN", "description": "API token from GlitchTip", "required": true, "example": "abc123..."},
    {"name": "GLITCHTIP_API_URL", "description": "Base API URL (include trailing slash)", "required": true, "example": "https://glitchtip.example.com/api/0/"},
    {"name": "GLITCHTIP_ORGANIZATION", "description": "Organization slug", "required": true, "example": "my-org"},
    {"name": "GLITCHTIP_PROJECT", "description": "Project slug", "required": true, "example": "my-app"}
  ]
}
```}],

Security and maintenance notes

Keep your GlitchTip API token secret. Rotate tokens periodically and restrict token scopes to only what is needed by the MCP server. Run the MCP server in a protected environment and monitor access to the process. Regularly update the MCP server to pick up security fixes and feature improvements.

Troubleshooting tips

If the MCP server fails to start, ensure all required environment variables are present and correctly spelled. Verify that the GLITCHTIP_API_URL ends with a trailing slash and that the token has permission to access the specified organization and project. Check network connectivity to your GlitchTip instance and review any error messages from the server process for clues.

Available tools

get_glitchtip_issues

Query issues from your GlitchTip project with optional status filtering to list unresolved, resolved, or ignored items.

get_glitchtip_issue

Fetch full details for a specific issue, including stack traces and error context.

resolve_glitchtip_issue

Mark a specific issue as resolved after applying a fix.