What is Raygun MCP Server

The Raygun MCP Server is a tool designed to interact with Raygun’s API V3 endpoints for Crash Reporting and Real User Monitoring applications. It allows users to access and manage various API features effectively through the Model Context Protocol.

Use cases

This server can be utilized for managing applications, handling error reporting and resolution, overseeing deployments, tracking user sessions, and monitoring application performance. It is beneficial for developers and teams needing robust monitoring and management of application errors and user experiences.

How to use

To use the Raygun MCP Server, you need to configure your environment by setting up required variables such as your Raygun PAT token. You can integrate it with Claude Desktop by adding the specified JSON configuration to the appropriate config file. Further actions and commands can be executed through the provided API features.

Key features

Key features of the Raygun MCP Server include managing applications and their API keys, handling various statuses for error groups, managing deployments, monitoring user sessions, and tracking performance metrics. It also supports source map management and team collaboration through invitation management.

Where to use

The Raygun MCP Server is primarily used in development environments where integration with Raygun’s crash reporting and performance monitoring capabilities is necessary. It is suitable for software development teams, DevOps, and application performance management workflows.

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
• 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:

{
  "mcpServers": {
    "raygun": {
      "command": "npx",
      "args": [
        "-y",
        "@raygun.io/mcp-server-raygun"
      ],
      "env": {
        "RAYGUN_PAT_TOKEN": "your-pat-token-here"
      }
    }
  }
}

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

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

{
  "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, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.