|
| 1 | +--- |
| 2 | +name: sentry |
| 3 | +description: Analyze Sentry issues, spans, crashes, and performance metrics. Use when user requests check in Sentry, asks about performance metrics and spans or asks about crash rates. |
| 4 | +--- |
| 5 | + |
| 6 | +# Sentry |
| 7 | + |
| 8 | +## When to Use This Skill |
| 9 | + |
| 10 | +Use Sentry skill when: |
| 11 | +- User requests any data from Sentry |
| 12 | +- User asks about performance metrics or span summary |
| 13 | +- User want to compare metrics between any date ranges |
| 14 | +- User asks about latest production crashes and issues |
| 15 | +- User want to investigate profiles or traces from production sessions |
| 16 | + |
| 17 | +## Sentry MCP |
| 18 | + |
| 19 | +The Sentry MCP server is configured in `.mcp.json` and gives Claude Code direct access to Sentry. |
| 20 | + |
| 21 | +### Prerequisites |
| 22 | + |
| 23 | +**Setup** (one-time per engineer): On first use, Claude Code will open a browser OAuth login to Sentry. Sign in and authorize — no manual token setup required. |
| 24 | + |
| 25 | +### Available MCP Tools |
| 26 | + |
| 27 | +Use these tools for data analysis: |
| 28 | + |
| 29 | +| Tool | Purpose | |
| 30 | +|------|---------| |
| 31 | +| `mcp__sentry__find_releases` | Find release versions for scoping queries | |
| 32 | +| `mcp__sentry__search_issues` | Search for errors/crashes by query, project, date range | |
| 33 | +| `mcp__sentry__search_events` | Query raw events/spans (performance data, durations) | |
| 34 | +| `mcp__sentry__search_issue_events` | Get individual events for a known issue ID | |
| 35 | +| `mcp__sentry__get_issue_tag_values` | Inspect tag distributions (e.g. device, version) on an issue | |
| 36 | +| `mcp__sentry__get_sentry_resource` | Fetch a specific Sentry resource by URL/ID | |
| 37 | + |
| 38 | +**Do not use** `mcp__sentry__analyze_issue_with_seer` — AI analysis is out of scope for this skill. |
| 39 | + |
| 40 | +Always use: |
| 41 | +- **org slug**: `expensify` |
| 42 | +- **project slug**: `app` |
| 43 | + |
| 44 | +## Example uses |
| 45 | + |
| 46 | +- "Search Sentry for crashes in the last 24h related to expense creation" |
| 47 | +- "Get details on Sentry issue APP-123" |
| 48 | +- "Compare P90 of ManualAppStartup durations between last two weeks" |
0 commit comments