Raygun
Interact with your crash reporting and real using monitoring data on your Raygun account
What is Raygun?
Raygun is a server designed to interact with Raygun's API V3 endpoints for crash reporting and real user monitoring applications, facilitating comprehensive access to various features of Raygun's services.
How to use Raygun?
To use Raygun, set up your configuration file with the necessary environment variables, install dependencies, and integrate it with your applications through the provided endpoints for error and performance management.
Key features of Raygun?
- Application management (list, get, regenerate API keys)
- Error management (list, get, resolve error groups)
- Deployment management (list, get, update deployments)
- Performance monitoring (list monitored pages, get performance metrics)
- Team management (send and revoke invitations)
Use cases of Raygun?
- Monitor and resolve application errors efficiently.
- Track performance issues in real time.
- Manage deployments seamlessly within your application ecosystem.
FAQ from Raygun?
- What is the Raygun PAT Token?
The Raygun PAT Token is a personal access token used for authentication when interfacing with the Raygun API. You must acquire one to use Raygun services.
- How do you configure Raygun for Claude Desktop?
Include the Raygun server settings in your Claude Desktop configuration file, specifying the command and environment variables necessary for operation.
- Is there any debugging tool available for Raygun?
Yes! The MCP Inspector can be used to help debug issues, providing tools accessible via a browser.
# Raygun MCP Server
MCP Server for Raygun's API V3 endpoints for interacting with your Crash Reporting and Real User Monitoring applications. This server provides comprehensive access to Raygun's API features through the Model Context Protocol.
Features
Tools
Applications
- `list_applications` - List all applications under your account
- `get_application` - Get application details by identifier
- `get_application_by_api_key` - Get application details by API key
- `regenerate_application_api_key` - Generate a new API key for an application
Error Management
- `list_error_groups` - List error groups for an application
- `get_error_group` - Get detailed information about an error group
- `resolve_error_group` - Set error group status to resolved
- `activate_error_group` - Set error group status to active
- `ignore_error_group` - Set error group status to ignored
- `permanently_ignore_error_group` - Set error group status to permanently ignored
Deployment Management
- `list_deployments` - List deployments for an application
- `get_deployment` - Get deployment details by identifier
- `delete_deployment` - Remove a deployment
- `update_deployment` - Update deployment information
- `reprocess_deployment_commits` - Reprocess deployment commit data
User & Session Management
- `list_customers` - List customers for an application
- `list_sessions` - List user sessions for an application
- `get_session` - Get detailed session information
Performance Monitoring
- `list_pages` - List monitored pages for an application
- `get_page_metrics_time_series` - Get time-series performance metrics
- `get_page_metrics_histogram` - Get histogram of performance metrics
- `get_error_metrics_time_series` - Get time-series error metrics
Source Maps
- `list_source_maps` - List source maps for an application
- `get_source_map` - Get source map details
- `update_source_map` - Update source map information
- `delete_source_map` - Remove a source map
- `upload_source_map` - Upload a new source map
- `delete_all_source_maps` - Remove all source maps
Team Management
- `list_invitations` - List pending team invitations
- `send_invitation` - Send a new team invitation
- `get_invitation` - Get invitation details
- `revoke_invitation` - Revoke a pending invitation
Configuration
The server requires the following environment variables:
- `RAYGUN_PAT_TOKEN` (required): Your [Raygun PAT token](https://raygun.com/documentation/product-guides/raygun-api/)
- `SOURCEMAP_ALLOWED_DIRS` (optional): Comma-separated list of directories allowed for source map operations
Usage with Claude Desktop
Add to your `claude_desktop_config.json`:
```json { "mcpServers": { "raygun": { "command": "npx", "args": ["-y", "@raygun.io/mcp-server-raygun"], "env": { "RAYGUN_PAT_TOKEN": "your-pat-token-here" } } } } ```
Development
Install dependencies: ```bash npm install ```
Build the server: ```bash npm run build ```
For development with auto-rebuild: ```bash npm run watch ```
Installation
To use with Claude Desktop, add the server config:
On MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json` On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
```json { "mcpServers": { "raygun": { "command": "/path/to/server-raygun/build/index.js", "env": { "RAYGUN_PAT_TOKEN": "your-pat-token-ken" } } } } ```
Debugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector), which is available as a package script:
```bash npm run inspector ```
The Inspector will provide a URL to access debugging tools in your browser.