📌Overview

Purpose: To provide a comprehensive server for Raygun's API V3, facilitating interactions with Crash Reporting and Real User Monitoring applications via the Model Context Protocol.

Overview: The Raygun MCP Server offers a robust interface to access and manage features of Raygun's API, including application insight, error management, deployment tracking, user session management, performance monitoring, source map manipulation, and team management. It simplifies the integration and management of Raygun functionalities in applications.

Key Features:

Application Management: Offers methods to list, retrieve, regenerate API keys, and query details of applications.
Error Management: Enables detailed error group management with functionalities to list, resolve, activate, ignore, and permanently ignore error groups.
Deployment Management: Provides capabilities to list, retrieve, update, delete deployments, and reprocess deployment commit data.
User & Session Management: Facilitates listing and retrieving information of users and sessions associated with applications.
Performance Monitoring: Allows monitoring and retrieval of performance metrics for pages and errors, enhancing the ability to analyze application performance.
Source Maps Management: Supports listing, updating, deleting, and uploading of source maps, crucial for effective error tracking and debugging.
Team Management: Includes features to manage team invitations, making it easy to collaborate with multiple users on applications.

Raygun MCP Server

MCP Server for Raygun's API V3 endpoints, enabling interaction with your Crash Reporting and Real User Monitoring applications. This server provides 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"
      }
    }
  }
}

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

Example configuration:

{
  "mcpServers": {
    "raygun": {
      "command": "/path/to/server-raygun/build/index.js",
      "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

Debugging

MCP servers communicate over stdio, which can make debugging challenging. Use the MCP Inspector for debugging:

npm run inspector

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