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

``bash
npm install -g rosentry-mcp
`

Or use with npx (no install required):

`bash
npx rosentry-mcp
`

Configuration

$3

| 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_...) |

$3

Add to your Claude Desktop config file:

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

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

`json
{
"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

$3

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 |

$3

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 |

$3

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

$3

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 |

$3

Full-text search across error messages and stack traces.

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

$3

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

$3

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.

$3

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

`bash


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