Raygun Mcp Server

What is Raygun Mcp Server about?

Raygun Mcp Server exposes Raygun's full set of V3 API capabilities—applications, error groups, deployments, sessions, performance metrics, source maps, and team management—as MCP commands that can be invoked from Claude Desktop or any other MCP client.

How to use Raygun Mcp Server?

Install the server via npx (no global install required):

{
  "mcpServers": {
    "raygun": {
      "command": "npx",
      "args": ["-y", "@raygun.io/mcp-server-raygun"],
      "env": { "RAYGUN_PAT_TOKEN": "<YOUR_PAT_TOKEN>" }
    }
  }
}

Add the above snippet to your claude_desktop_config.json (location varies by OS).
Ensure the required environment variable RAYGUN_PAT_TOKEN is set to a valid Raygun Personal Access Token.
(Optional) Define SOURCEMAP_ALLOWED_DIRS to restrict source‑map file operations.
Launch Claude Desktop; the server will start automatically and communicate over stdio.

Key features of Raygun Mcp Server

Application Management: list, retrieve, and regenerate API keys.
Error Group Handling: list, inspect, resolve, activate, ignore, or permanently ignore error groups.
Deployment Operations: list, fetch, delete, update, and re‑process deployment commits.
User & Session Insights: list customers, sessions, and retrieve detailed session data.
Performance Monitoring: list monitored pages, fetch time‑series or histogram metrics for pages and errors.
Source‑Map Lifecycle: list, get, update, delete, upload, and bulk‑remove source maps.
Team Management: list invitations, send, retrieve, and revoke team invitations.

Use cases of Raygun Mcp Server

Automated CI/CD pipelines: integrate Raygun deployment and source‑map updates directly from build scripts.
Interactive debugging: query error groups, session data, and performance metrics from Claude Desktop during incident triage.
Team onboarding: programmatically manage invitations and permissions for new team members.
Custom reporting dashboards: fetch metrics via MCP and feed them into internal observability dashboards.

FAQ from the Raygun Mcp Server

Q: Which environment variable is mandatory? A: RAYGUN_PAT_TOKEN must contain a valid Raygun Personal Access Token.

Q: Can I limit source‑map access? A: Yes, set SOURCEMAP_ALLOWED_DIRS to a comma‑separated list of allowed directories.

Q: Do I need to build the server before running it? A: No, using the npx command runs the pre‑built package directly. Building locally is only needed for development.

Q: How do I debug communication issues? A: Run npm run inspector to start the MCP Inspector, which provides a browser‑based debugging UI.

Q: Is this server compatible with other MCP clients? A: Absolutely; any client that speaks the Model Context Protocol can interact with the 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.

Raygun Mcp Server