Raygun

🚀 Raygun MCP Server

The MCP server for Raygun's API V3 endpoints, designed to interact with your error reporting and real - user monitoring applications. This server provides you with full access to Raygun's API capabilities through the model context protocol.

🚀 Quick Start

The Raygun MCP Server allows you to interact with Raygun's API V3 endpoints for error reporting and real - user monitoring. Follow the steps below to get started.

✨ Features

Tools

Applications

• list_applications - List all applications under your account.
• get_application - Get detailed information about an application by its identifier.
• get_application_by_api_key - Get detailed information about an application by its 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 the status of an error group to resolved.
• activate_error_group - Set the status of an error group to active.
• ignore_error_group - Set the status of an error group to ignored.
• permanently_ignore_error_group - Set the status of an error group to permanently ignored.

Deployment Management

• list_deployments - List deployments for an application.
• get_deployment - Get detailed information about a deployment by its identifier.
• delete_deployment - Delete a deployment.
• update_deployment - Update deployment information.
• reprocess_deployment_commits - Reprocess deployment commit data.

User and Session Management

• list_customers - List customers for an application.
• list_sessions - List user sessions for an application.
• get_session - Get detailed information about a session.

Performance Monitoring

• list_pages - List monitored pages for an application's sessions.
• get_page_metrics_time_series - Get time - series data for performance metrics.
• get_page_metrics_histogram - Get a histogram of performance metrics.
• get_error_metrics_time_series - Get time - series data for error metrics.

Source Maps

• list_source_maps - List source maps for an application.
• get_source_map - Get detailed information about a source map.
• update_source_map - Update source map information.
• delete_source_map - Delete a source map.
• upload_source_map - Upload a new source map.
• delete_all_source_maps - Delete all source maps.

Team Management

• list_invitations - List pending team invitations.
• send_invitation - Send a new team invitation.
• get_invitation - Get detailed information about an invitation.
• revoke_invitation - Revoke a pending invitation.

📦 Installation

Configuration

The server requires the following environment variables:

• RAYGUN_PAT_TOKEN (Required): Your Raygun PAT token.
• SOURCEMAP_ALLOWED_DIRS (Optional): A comma - separated list of directories allowed for source map operations.

Usage with Claude Desktop

Add the following 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 Steps

When using with Claude Desktop:

• 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"
      }
    }
  }
}

💻 Usage Examples

Basic Usage

Development

Install dependencies:

npm install

Build the server:

npm run build

Development with auto - rebuild:

npm run watch

Advanced Usage

Debugging

Since the MCP server communicates via stdio, debugging can be challenging. We recommend using MCP Inspector, which is available as a package script:

npm run inspector

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