Raygun Mcp Server

What is Raygun Mcp Server about?

Enables interaction with Raygun's Crash Reporting and Real User Monitoring APIs through a Model Context Protocol (MCP) server, exposing a rich set of operations for applications, errors, deployments, sessions, performance data, source maps, and team management.

How to use Raygun Mcp Server?

1. Install – No separate installation required; the server runs directly with npx.
2. Configure – Supply the required RAYGUN_PAT_TOKEN environment variable (your Raygun Personal Access Token). Optionally set SOURCEMAP_ALLOWED_DIRS to restrict source‑map file access.
3. Run – Launch the server using the MCP command configuration (e.g., via Claude Desktop or manually with npx -y @raygun.io/mcp-server-raygun).
4. Interact – Communicate over stdio using any MCP‑compatible client or the MCP Inspector for debugging.

Key features of Raygun Mcp Server

• Application Management: list, retrieve, and regenerate API keys.
• Error Management: list groups, fetch details, resolve, activate, ignore, or permanently ignore errors.
• Deployment Management: list, get, delete, update, and reprocess deployment commits.
• User & Session Management: list customers, sessions, and fetch session details.
• Performance Monitoring: list pages, obtain time‑series or histogram metrics for pages and errors.
• Source Map Operations: list, get, update, delete, upload, and bulk‑delete source maps with optional directory restrictions.
• Team Management: handle invitations – list, send, retrieve, and revoke.
• Debugging Support: built‑in npm script npm run inspector launches the MCP Inspector UI.

Use cases of Raygun Mcp Server

• Automated CI/CD pipelines: integrate deployment creation, update, and commit reprocessing directly into build scripts.
• Monitoring dashboards: pull real‑time error and performance metrics for custom dashboards or alerts.
• Security‑aware source‑map handling: restrict source‑map uploads to specific directories, ensuring sensitive paths are protected.
• Team onboarding automation: programmatically send and manage Raygun team invitations for new developers.
• Incident response tooling: resolve or ignore error groups automatically based on external criteria.

FAQ from the Raygun Mcp Server

• What authentication is required? Provide a Raygun Personal Access Token via the RAYGUN_PAT_TOKEN environment variable.

• Do I need to install the server globally? No. The recommended approach is to run it with npx -y @raygun.io/mcp-server-raygun, which fetches the package at runtime.

• Can I restrict source‑map operations? Yes. Set SOURCEMAP_ALLOWED_DIRS to a comma‑separated list of permitted directories.

• How do I debug communication issues? Use the provided MCP Inspector (npm run inspector) which offers a web UI for inspecting stdio traffic.

• Is the server compatible with non‑Claude clients? Absolutely. Any MCP‑compatible client can communicate over stdio with the server.

🔭 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

---

✨ 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

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

Guide: Claude Code MCP Documentation

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

Guide: Cline MCP Documentation

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

Guide: Codex MCP Documentation

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

Go to Cursor Settings → MCP → New MCP Server

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

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

Guide: JetBrains AI Assistant MCP Documentation

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

Guide: VS Code MCP Servers

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

Guide: Zed MCP Documentation

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

💬 Your First Prompt

After configuration, try asking your AI assistant:

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

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

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

🛠️ Tools

The Raygun MCP server provides the following categories of tools:

• 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

• 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

• 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

• customers_list - List customers for an application
• customer_investigate - Get detailed customer information
• sessions_list - List user sessions with environment and device data

• 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

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

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

1. Navigate to Raygun Personal Access Tokens
2. Click Create New Token
3. Give your token a descriptive name (e.g., "MCP Server Access")
4. Select the appropriate permissions for your use case
5. 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

• 📚 Raygun Documentation
• 🔌 Raygun API Reference
• 🤖 Model Context Protocol
• 🐛 Report Issues

---

Built with ❤️ by Raygun