io.github.MindscapeHQ/mcp-server-raygun

Official

by MindscapeHQ

Raygun

Investigate errors, track deployments, analyze performance, and manage application monitoring

Error investigation, deployment tracking, and application performance monitoring.

Topics

error-reportingllm-agentsmcpreal-user-monitoring

README.md9 KBView on GitHub

🔭 Raygun MCP Server

Access your crash reporting data in Raygun with AI assistants

A remote Model Context Protocol (MCP) server that connects AI assistants to your crash reporting and real user monitoring data in Raygun through natural language conversations.

📚 Tool Reference • 🚀 Quick Start • 🔑 Get API Token

</div>

✨ Key Features

🐛 Error Management - Investigate, resolve, and track application errors and crashes with full stack traces and context
🚀 Deployment Tracking - Monitor releases and correlate errors with deployments to identify problematic changes
⚡ Performance Insights - Analyze page load times, user metrics, and performance trends over time
👥 User Monitoring - Track customer sessions, behavior patterns, and identify affected users
🤝 Team Collaboration - Manage invitations and coordinate error resolution across your team
📊 Metrics & Analytics - Time-series analysis and distribution histograms for errors and performance

📋 Requirements

🔐 A Raygun account with an active subscription
🔑 A Raygun Personal Access Token (PAT)

🚀 Getting Started

The Raygun MCP server is hosted remotely at https://api.raygun.com/v3/mcp.

💡 Tip: Choose your AI assistant below and follow the configuration instructions. Don't forget to replace YOUR_PAT_TOKEN with your actual Raygun Personal Access Token!

Guide: Amp MCP Documentation

bash

amp mcp add raygun --header "Authorization=Bearer YOUR_PAT_TOKEN" https://api.raygun.com/v3/mcp

</details> <details> <summary>Claude Code</summary>

Guide: Claude Code MCP Documentation

bash

claude mcp add --transport http raygun https://api.raygun.com/v3/mcp --header "Authorization: Bearer YOUR_PAT_TOKEN"

</details> <details> <summary>Cline</summary>

Guide: Cline MCP Documentation

Use https://api.raygun.com/v3/mcp and your PAT token

</details> <details> <summary>Codex</summary>

Guide: Codex MCP Documentation

toml

[mcp_servers.raygun]
command = "npx"
args = ["mcp-remote", "https://api.raygun.com/v3/mcp", "--header", "Authorization: Bearer YOUR_PAT_TOKEN"]

</details> <details> <summary>Cursor</summary>

Go to Cursor Settings → MCP → New MCP Server

json

{
  "mcpServers": {
    "Raygun": {
      "url": "https://api.raygun.com/v3/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_PAT_TOKEN"
      }
    }
  }
}

</details> <details> <summary>Gemini CLI</summary>

bash

gemini mcp add --transport http raygun https://api.raygun.com/v3/mcp --header "Authorization: Bearer YOUR_PAT_TOKEN"

</details> <details> <summary>JetBrains AI Assistant</summary>

Guide: JetBrains AI Assistant MCP Documentation

json

{
  "mcpServers": {
    "Raygun": {
      "url": "https://api.raygun.com/v3/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_PAT_TOKEN"
      }
    }
  }
}

</details> <details> <summary>VS Code</summary>

Guide: VS Code MCP Servers

json

{
  "servers": {
    "raygun": {
      "url": "https://api.raygun.com/v3/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_PAT_TOKEN"
      }
    }
  }
}

</details> <details> <summary>Zed</summary>

Guide: Zed MCP Documentation

json

{
  "context_servers": {
    "raygun": {
      "source": "custom",
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.raygun.com/v3/mcp",
        "--header",
        "Authorization: Bearer YOUR_PAT_TOKEN"
      ],
      "env": {}
    }
  }
}

</details>

💬 Your First Prompt

After configuration, try asking your AI assistant:

code

🔍 "Show me the most recent error groups in my Raygun applications"

code

🚀 "What were the latest deployments and did they introduce any new errors?"

code

📊 "Analyze the performance trends for my top pages over the last 7 days"

🛠️ Tools

The Raygun MCP server provides the following categories of tools:

<details> <summary>📱 Applications</summary>

applications_list - List all applications in your Raygun account
applications_search - Search for applications by name
application_get_details - Get detailed application information
application_regenerate_api_key - Generate a new API key for an application

</details> <details> <summary>🐛 Error Management</summary>

error_groups_list - List error groups within an application
error_group_investigate - Get complete details about a specific error group
error_group_update_status - Change error group status (resolve, ignore, activate)
error_group_add_comment - Add investigation notes to an error group
error_instances_browse - Browse individual error occurrences
error_instance_get_details - Get full stack trace and context for an error instance

</details> <details> <summary>🚀 Deployments</summary>

deployments_list - List deployments for an application
deployment_create - Create a new deployment record
deployment_get_latest - Get the most recent deployment with error analysis
deployment_investigate - Get comprehensive deployment information
deployment_manage - Update or delete a deployment

</details> <details> <summary>👥 Customers & Sessions</summary>

customers_search - Search customers by name, email, or identifier
customer_investigate - Get customer profile, recent error groups, and sessions
sessions_list - List user sessions with environment and device data

</details> <details> <summary>📊 Performance & Metrics</summary>

pages_list - List monitored pages in an application
page_investigate - Get page details for metrics queries
metrics_website_performance_analyze - Track performance trends over time
metrics_performance_distribution_analyze - Understand performance variability
metrics_error_trends_analyze - Track error rates and patterns

</details> <details> <summary>🤝 Team Management</summary>

invitations_manage - List and review team invitations
invitation_send - Send a new team invitation
invitation_revoke - Cancel a pending invitation

</details>

For detailed documentation on each tool, see the Tool Reference.

🔑 Configuration

Obtaining a Personal Access Token

To use the Raygun MCP server, you need a Raygun Personal Access Token (PAT):

Navigate to Raygun Personal Access Tokens
Click Create New Token
Give your token a descriptive name (e.g., "MCP Server Access")
Select the appropriate permissions for your use case
Copy the generated token and use it in your MCP configuration

⚠️ Important: Replace YOUR_PAT_TOKEN in the configuration examples above with your actual token. Keep your token secure and never commit it to version control!

For more details, see the Raygun API documentation.

📖 About

The Raygun MCP server enables AI coding assistants to access and analyze your crash reporting and real user monitoring data in Raygun, helping you investigate errors, track deployments, analyze performance, and manage your application monitoring workflow—all through natural language conversations.

🔗 Resources

Built with ❤️ by Raygun

</div>

Install

claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-raygun": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.raygun.com/v3/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.