rosentry-mcp

MCP (Model Context Protocol) server for RoSentry - AI-powered error monitoring for Roblox games.

This package allows Claude and other MCP-compatible AI assistants to query, analyze, and manage errors from your Roblox games directly in conversation.

Features

• Query Errors - Fetch recent errors with filters (level, user, place)
• Error Groups - View deduplicated/grouped errors with occurrence counts
• Trends Analysis - See error frequency over time (1h, 24h, 7d, 30d)
• Full-Text Search - Search across error messages and stack traces
• User Impact - See which Roblox users are affected by specific errors
• Status Management - Resolve, ignore, or reopen error groups

Installation

npm install -g rosentry-mcp

Or use with npx (no install required):

npx rosentry-mcp

Configuration

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | ROSENTRY_SUPABASE_URL | Yes | Your Supabase project URL | | ROSENTRY_SUPABASE_KEY | Yes | Supabase service role key | | ROSENTRY_API_KEY | Yes | Your RoSentry project API key (rs_...) |

Claude Desktop Setup

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "rosentry": {
      "command": "npx",
      "args": ["rosentry-mcp"],
      "env": {
        "ROSENTRY_SUPABASE_URL": "https://your-project.supabase.co",
        "ROSENTRY_SUPABASE_KEY": "your-service-role-key",
        "ROSENTRY_API_KEY": "rs_your_api_key"
      }
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "rosentry": {
      "command": "rosentry-mcp",
      "env": {
        "ROSENTRY_SUPABASE_URL": "https://your-project.supabase.co",
        "ROSENTRY_SUPABASE_KEY": "your-service-role-key",
        "ROSENTRY_API_KEY": "rs_your_api_key"
      }
    }
  }
}

Available Tools

get_recent_errors

Fetch recent error events with full details including stack traces and context.

| Parameter | Type | Description | |-----------|------|-------------| | limit | number | Max errors to return (default: 20, max: 100) | | level | string | Filter by level: error, warn, info, debug | | user_id | number | Filter by Roblox UserId | | place_id | number | Filter by Roblox PlaceId | | search | string | Search term for error messages |

get_error_groups

Fetch grouped/deduplicated errors showing occurrence counts and status.

| Parameter | Type | Description | |-----------|------|-------------| | limit | number | Max groups to return (default: 20, max: 50) | | status | string | Filter by status: open, resolved, ignored | | search | string | Search term for error messages |

get_error_group_details

Get detailed info about a specific error group including individual events.

| Parameter | Type | Description | |-----------|------|-------------| | group_id | string | Required. UUID of the error group | | include_events | boolean | Include individual events (default: true) | | events_limit | number | Max events to include (default: 10) |

get_error_trends

Get error frequency trends over time.

| Parameter | Type | Description | |-----------|------|-------------| | timeframe | string | Time range: 1h, 24h, 7d, 30d (default: 24h) | | group_by | string | Grouping: hour or day |

search_errors

Full-text search across error messages and stack traces.

| Parameter | Type | Description | |-----------|------|-------------| | query | string | Required. Search query | | limit | number | Max results (default: 20) |

get_affected_users

Get Roblox users affected by a specific error group.

| Parameter | Type | Description | |-----------|------|-------------| | group_id | string | Required. UUID of the error group | | limit | number | Max users to return (default: 50) |

get_stats

Get summary statistics for your project.

| Parameter | Type | Description | |-----------|------|-------------| | timeframe | string | Time range: 1h, 24h, 7d, 30d (default: 24h) |

Returns: Total errors, errors by level, open groups count, affected users, top 5 errors.

update_error_status

Update the status of an error group.

| Parameter | Type | Description | |-----------|------|-------------| | group_id | string | Required. UUID of the error group | | status | string | Required. New status: open, resolved, ignored |

Example Usage with Claude

Once configured, you can ask Claude things like:

• "What errors happened in the last hour?"
• "Show me the top errors affecting users"
• "Search for errors related to 'DataStore'"
• "How many users are affected by error group abc-123?"
• "Mark that error as resolved"
• "What's the error trend for the past week?"

Development

# Clone the repo
git clone https://github.com/rosentry/rosentry.git
cd rosentry/mcp

# Install dependencies
npm install

# Run in development
npm run dev

# Build for production
npm run build

Related

• RoSentry - Error monitoring platform for Roblox
• RoSentry Lua SDK - Roblox Lua SDK
• Model Context Protocol - MCP specification

License

MIT - see LICENSE