# Raygun Remote MCP

Connect supported coding agents to Raygun's remote MCP server for live production observability context.

## Endpoint

`https://api.raygun.com/v3/mcp`

Configure this URL as a Streamable HTTP MCP server. Do not add an Authorization header. On first connection, the MCP client opens Raygun in a browser so the user can sign in, select a plan, review permissions, and authorize access through OAuth.

## Machine permissions

The authoritative OAuth protected-resource metadata for Raygun MCP is:

https://api.raygun.com/.well-known/oauth-protected-resource/v3/mcp

```json
{
  "resource": "https://api.raygun.com/v3/mcp",
  "authorization_servers": ["https://api.raygun.com/v3"],
  "bearer_methods_supported": ["header"],
  "scopes_supported": [
    "applications:read",
    "applications:write",
    "apm:read",
    "customers:read",
    "deployments:read",
    "deployments:write",
    "cr.errors:read",
    "cr.errors:write",
    "invitations:read",
    "invitations:write",
    "metrics:errors",
    "metrics:pages",
    "rum.pages:read",
    "rum.sessions:read"
  ]
}
```

Request only the scopes needed for the operation: use `applications:read` to find an application; add the relevant read scope for Crash Reporting, APM, deployments, customers, RUM, or metrics; request a `:write` scope only for the matching mutation. OAuth authorizations and PATs use these same permission families.

## Capabilities

- **Error management**: List and investigate error groups, browse instances, read stack traces, update status, and add comments.
  Tools: error_groups_list, error_group_investigate, error_instances_browse, error_instance_get_details
- **Deployments**: List releases, inspect the latest deploy with related errors, and investigate a specific deployment.
  Tools: deployments_list, deployment_get_latest, deployment_investigate, deployment_create
- **Customers & sessions**: Search customers, pull recent errors and sessions for a user, and list session environment data.
  Tools: customers_search, customer_investigate, sessions_list
- **Performance metrics**: List pages, analyze load/CWV trends, and performance distributions.
  Tools: pages_list, metrics_website_performance_analyze, metrics_performance_distribution_analyze, metrics_error_trends_analyze
- **Applications**: List and search apps, fetch application details for scoped investigations.
  Tools: applications_list, applications_search, application_get_details
- **Team collaboration**: List, send, and revoke invitations when coordinating access for workflows.
  Tools: invitations_manage, invitation_send, invitation_revoke

## Tool names

Source: https://github.com/MindscapeHQ/mcp-server-raygun/blob/main/TOOLS.md

- `applications_list` (Applications): List applications available to the current user.
- `applications_search` (Applications): Search for applications by name.
- `application_get_details` (Applications): Get detailed application information including settings and status.
- `error_groups_list` (Error Management): List error groups within an application.
- `error_group_investigate` (Error Management): Get complete details for an error group including stack context.
- `error_group_update_status` (Error Management): Change error group status (active, resolved, ignored, permanently_ignored).
- `error_group_add_comment` (Error Management): Add investigation notes to an error group.
- `error_instances_browse` (Error Management): Browse individual error occurrences in a group.
- `error_instance_get_details` (Error Management): Get full stack trace and environment for an error instance.
- `deployments_list` (Deployments): List deployments for an application.
- `deployment_get_latest` (Deployments): Get the most recent deployment with related error groups.
- `deployment_investigate` (Deployments): Get comprehensive deployment information and related errors.
- `deployment_create` (Deployments): Create a deployment record for a software release.
- `customers_search` (Customers & Sessions): Search customers by name, email, or identifier.
- `customer_investigate` (Customers & Sessions): Get customer profile, recent error groups, and sessions.
- `sessions_list` (Customers & Sessions): List user sessions with environment and device data.
- `pages_list` (Performance & Metrics): List monitored pages for metrics queries.
- `metrics_website_performance_analyze` (Performance & Metrics): Track performance trends over time (load, paint, FID, page views).
- `metrics_performance_distribution_analyze` (Performance & Metrics): Histogram analysis of performance metrics.
- `metrics_error_trends_analyze` (Performance & Metrics): Track error rates and patterns as time series.
- `invitations_manage` (Team Management): List and review team invitations.
- `invitation_send` (Team Management): Send a team invitation.
- `invitation_revoke` (Team Management): Cancel a pending invitation.

## Setup

For client-specific configuration and browser OAuth instructions, follow [Get started](https://ai.raygun.com/get-started.md).

## Next steps

- [Prompt library](https://ai.raygun.com/prompts)
- [MCP repository](https://github.com/MindscapeHQ/mcp-server-raygun)
- [API V3 for deterministic automation](https://ai.raygun.com/api)