{"id":30839126,"url":"https://github.com/coffebar/mcp-glitchtip","last_synced_at":"2025-09-06T18:55:21.131Z","repository":{"id":311661563,"uuid":"1044485515","full_name":"coffebar/mcp-glitchtip","owner":"coffebar","description":"An MCP (Model Context Protocol) server for GlitchTip error monitoring integration. This server allows AI assistants to quickly find and analyze relevant issues from your GlitchTip error monitoring.","archived":false,"fork":false,"pushed_at":"2025-08-25T19:33:21.000Z","size":23,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-25T21:25:08.970Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/coffebar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-25T18:54:06.000Z","updated_at":"2025-08-25T19:33:25.000Z","dependencies_parsed_at":"2025-08-25T21:25:11.206Z","dependency_job_id":"5aaee6a5-736d-440d-abc1-d3fb3cb26dfb","html_url":"https://github.com/coffebar/mcp-glitchtip","commit_stats":null,"previous_names":["coffebar/mcp-glitchtip"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/coffebar/mcp-glitchtip","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coffebar%2Fmcp-glitchtip","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coffebar%2Fmcp-glitchtip/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coffebar%2Fmcp-glitchtip/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coffebar%2Fmcp-glitchtip/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coffebar","download_url":"https://codeload.github.com/coffebar/mcp-glitchtip/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coffebar%2Fmcp-glitchtip/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273948884,"owners_count":25196400,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-06T02:00:13.247Z","response_time":2576,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-09-06T18:55:12.400Z","updated_at":"2025-09-06T18:55:21.122Z","avatar_url":"https://github.com/coffebar.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MCP GlitchTip\n\nAn MCP (Model Context Protocol) server that integrates GlitchTip error monitoring with AI assistants like Claude. This allows AI to analyze and help resolve errors from your GlitchTip instance.\n\n## What it does\n\nThis MCP server enables AI assistants to:\n\n- Fetch and analyze current issues from your GlitchTip instance\n- Get detailed error context including stack traces, user data, and breadcrumbs\n- Help debug and suggest solutions based on error patterns\n\n### Example Use Case\n\n```\nUser: \"Check GlitchTip for any payment-related errors\"\n\nAI Assistant:\n- Fetches all unresolved issues from GlitchTip\n- Identifies payment component errors\n- Analyzes stack traces and error patterns\n- Suggests specific fixes based on the error context\n```\n\n## Quick Start\n\n### 1. Get Your GlitchTip Credentials\n\nYou'll need:\n\n- **Authentication**: Either an API token (recommended) or Session ID Cookie\n- **Organization Slug**: Your organization identifier in GlitchTip\n- **Base URL** (optional): Your GlitchTip instance URL if self-hosted\n\n#### Authentication Options\n\n**Option 1: API Token (Recommended)**\n\n1. Log in to your GlitchTip instance\n2. Go to /profile/auth-tokens\n3. Create a new API token with appropriate permissions\n4. Copy the token for use as `GLITCHTIP_TOKEN`\n\n**Option 2: Session ID**\n\n1. Log in to your GlitchTip instance\n2. Open browser developer tools (F12)\n3. Go to Application/Storage \u003e Cookies\n4. Find the `sessionid` cookie value\n5. Copy this value for use as `GLITCHTIP_SESSION_ID`\n\n### 2. Configure Your Project\n\nCreate a `.mcp.json` file in your project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"glitchtip\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-glitchtip\"],\n      \"env\": {\n        \"GLITCHTIP_TOKEN\": \"your-api-token-here\",\n        \"GLITCHTIP_ORGANIZATION\": \"your-org-slug\",\n        \"GLITCHTIP_BASE_URL\": \"https://app.glitchtip.com\"\n      }\n    }\n  }\n}\n```\n\n**Note**: Add `.mcp.json` to your `.gitignore` to keep credentials secure:\n\n```bash\necho \".mcp.json\" \u003e\u003e .gitignore\n```\n\n### 3. Open Your Project in Claude Desktop\n\nWhen you open your project folder in Claude Desktop, it will automatically detect the `.mcp.json` configuration and connect to your GlitchTip instance.\n\n## Configuration Options\n\n| Environment Variable     | Required | Description                          | Default                     |\n| ------------------------ | -------- | ------------------------------------ | --------------------------- |\n| `GLITCHTIP_TOKEN`        | Yes*     | Your GlitchTip API token (recommended) | -                           |\n| `GLITCHTIP_SESSION_ID`   | Yes*     | Your GlitchTip session cookie        | -                           |\n| `GLITCHTIP_ORGANIZATION` | Yes      | Organization slug from GlitchTip URL | -                           |\n| `GLITCHTIP_BASE_URL`     | No       | GlitchTip instance URL               | `https://app.glitchtip.com` |\n\n*Either `GLITCHTIP_TOKEN` or `GLITCHTIP_SESSION_ID` is required. If both are provided, `GLITCHTIP_TOKEN` takes priority.\n\n### Self-Hosted GlitchTip\n\nIf you're using a self-hosted GlitchTip instance, update the `GLITCHTIP_BASE_URL`:\n\n```json\n\"GLITCHTIP_BASE_URL\": \"https://glitchtip.your-domain.com\"\n```\n\n## Available Tools\n\n### `glitchtip_issues`\n\nFetches all issues from GlitchTip (unresolved by default).\n\n**Usage**: \"Show me all GlitchTip errors\"\n\n### `glitchtip_latest_event`\n\nGets the most recent event for a specific issue with full error context.\n\n**Parameters**:\n\n- `issueId`: The issue ID to get details for\n\n**Usage**: \"Get details for GlitchTip issue #123\"\n\n## Available Resources\n\n### `glitchtip://issues`\n\nA resource endpoint that provides all current issues in JSON format.\n\n## Example Workflows\n\n### Debugging a Production Error\n\n```\nUser: \"Check GlitchTip for recent 500 errors\"\n\nAI: [Fetches issues] I found 3 recent 500 errors:\n1. DatabaseConnectionError in /api/users\n2. TimeoutError in payment processing\n3. ValidationError in checkout flow\n\nUser: \"Show me details about the payment timeout\"\n\nAI: [Gets latest event] The TimeoutError occurs when...\n[Provides stack trace analysis and suggested fixes]\n```\n\n### Monitoring Error Trends\n\n```\nUser: \"What are the most frequent errors in GlitchTip?\"\n\nAI: [Analyzes issue counts] The top errors by frequency are:\n1. CORS policy errors (145 occurrences)\n2. Missing authentication token (89 occurrences)\n3. Rate limit exceeded (67 occurrences)\n```\n\n## Development\n\n### Building from Source\n\n```bash\ngit clone https://github.com/coffebar/mcp-glitchtip.git\ncd mcp-glitchtip\nnpm install\nnpm run build\n```\n\n### Development Mode\n\n```bash\nnpm run watch  # Auto-rebuild on changes\n```\n\n### Testing with MCP Inspector\n\n```bash\nnpm run inspector\n```\n\nSet the required environment variables before running the inspector:\n\n```bash\nexport GLITCHTIP_TOKEN=\"your-api-token\"\n# OR export GLITCHTIP_SESSION_ID=\"your-session-id\"\nexport GLITCHTIP_ORGANIZATION=\"your-org\"\nnpm run inspector\n```\n\n## Troubleshooting\n\n### Authentication Errors\n\nIf you see \"Authentication failed. Check your token or session ID\":\n\n1. If using a token: Verify it's valid and has appropriate permissions\n2. If using a session ID: Your session may have expired - get a new session ID from GlitchTip\n3. Verify you're using the correct organization slug\n4. Check if your GlitchTip instance requires additional authentication headers\n\n### Connection Errors\n\nIf you see \"Failed to connect to GlitchTip\":\n\n1. Verify your `GLITCHTIP_BASE_URL` is correct\n2. Check if you're behind a proxy or firewall\n3. Ensure your GlitchTip instance is accessible from your network\n\n### No Issues Found\n\nIf the tool returns empty results:\n\n1. Verify there are actually issues in your GlitchTip project\n2. Check if your organization slug is correct\n3. Ensure your session has permission to view the issues\n\n## Security Notes\n\n- **Never commit `.mcp.json` to version control** - it contains sensitive credentials\n- For team usage, each developer should use their own API token or session ID\n\n## Contributing\n\nContributions are welcome! Please:\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Add tests if applicable\n5. Submit a pull request\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## Support\n\n- **Issues**: [GitHub Issues](https://github.com/coffebar/mcp-glitchtip/issues)\n- **Documentation**: [GitHub README](https://github.com/coffebar/mcp-glitchtip#readme)\n- **GlitchTip Docs**: [GlitchTip Documentation](https://glitchtip.com/documentation)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoffebar%2Fmcp-glitchtip","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoffebar%2Fmcp-glitchtip","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoffebar%2Fmcp-glitchtip/lists"}