How do I install the Sentry skill?

Run npx skillmds@latest add builderio/sentry in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Sentry safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Sentry?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Sentry free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Sentry?

Builder.io (@builderio) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Sentry by builderio — Agent Skill

Name: Sentry
Author: Builder.io

File contents

Sentry Integration

Connection

Base URL: https://sentry.io/api/0
Org slug: discovered from the token's accessible organizations by default. Configure SENTRY_ORG_SLUG or pass orgSlug to the sentry action when a user needs a specific Sentry organization.
Auth: Authorization: Bearer $SENTRY_SERVER_TOKEN (internal integration token, NOT user auth token or DSN)
Env vars: SENTRY_SERVER_TOKEN (falls back to SENTRY_AUTH_TOKEN)
Caching: 5-minute in-memory cache, max 100 entries
Scopes needed: alerts:read, event:read, org:read, project:distribution, project:read, team:read

Server Lib & API Routes

File: server/lib/sentry.ts

Exported Functions

Function	Description
`listProjects()`	List all projects in the org
`listIssues(projectSlug?, query?, statsPeriod?)`	List issues (project-scoped or org-wide)
`getIssueEvents(issueId)`	Events for a specific issue
`getOrganizationStats(statsPeriod?, category?)`	Org-level error stats over time

Agent Action

Use sentry for all agent-facing Sentry work. Do not call /api/sentry/* directly from the agent.

Mode	Args	Description
`organizations`		List organizations visible to the token
`issues`	`statsPeriod`, `project`, `query`, `orgSlug`	Frequent issues, sorted by frequency
`projects`	`orgSlug`	List projects
`issue-events`	`issueId`, `orgSlug`	Events for a specific issue
`stats`	`statsPeriod`, `category`, `orgSlug`	Org-level stats

API Routes

Route	Description
`GET /api/sentry/projects`	List projects
`GET /api/sentry/issues`	List issues
`GET /api/sentry/issue-events`	Events for an issue
`GET /api/sentry/stats`	Org error stats

Dashboard

/adhoc/sentry — Sentry Error Health dashboard

Key Patterns & Gotchas

Token type: This is a custom/internal integration token from Sentry's integration settings TOKEN table (not the Client Secret)
getOrganizationStats uses stats_v2 endpoint with field=sum(quantity), groupBy=outcome, default category error
If the default org is wrong, pass orgSlug explicitly in the action call.

---name: sentrydescription: Track errors and issues across your projects via Sentry. Use this skill when the user asks about errors, exceptions, error trends, or application health.---# Sentry Integration## Connection- **Base URL**: `https://sentry.io/api/0`- **Org slug**: discovered from the token's accessible organizations by default. Configure `SENTRY_ORG_SLUG` or pass `orgSlug` to the `sentry` action when a user needs a specific Sentry organization.- **Auth**: `Authorization: Bearer $SENTRY_SERVER_TOKEN` (internal integration token, NOT user auth token or DSN)- **Env vars**: `SENTRY_SERVER_TOKEN` (falls back to `SENTRY_AUTH_TOKEN`)- **Caching**: 5-minute in-memory cache, max 100 entries- **Scopes needed**: `alerts:read`, `event:read`, `org:read`, `project:distribution`, `project:read`, `team:read`## Server Lib & API Routes- **File**: `server/lib/sentry.ts`### Exported Functions| Function | Description || ------------------------------------------------ | ---------------------------------------- || `listProjects()` | List all projects in the org || `listIssues(projectSlug?, query?, statsPeriod?)` | List issues (project-scoped or org-wide) || `getIssueEvents(issueId)` | Events for a specific issue || `getOrganizationStats(statsPeriod?, category?)` | Org-level error stats over time |### Agent ActionUse `sentry` for all agent-facing Sentry work. Do not call `/api/sentry/*`directly from the agent.| Mode | Args | Description || --------------- | -------------------------------------------- | --------------------------------------- || `organizations` | | List organizations visible to the token || `issues` | `statsPeriod`, `project`, `query`, `orgSlug` | Frequent issues, sorted by frequency || `projects` | `orgSlug` | List projects || `issue-events` | `issueId`, `orgSlug` | Events for a specific issue || `stats` | `statsPeriod`, `category`, `orgSlug` | Org-level stats |### API Routes| Route | Description || ------------------------------ | ------------------- || `GET /api/sentry/projects` | List projects || `GET /api/sentry/issues` | List issues || `GET /api/sentry/issue-events` | Events for an issue || `GET /api/sentry/stats` | Org error stats |### Dashboard- `/adhoc/sentry` — Sentry Error Health dashboard## Key Patterns & Gotchas- Token type: This is a **custom/internal integration** token from Sentry's integration settings TOKEN table (not the Client Secret)- `getOrganizationStats` uses `stats_v2` endpoint with `field=sum(quantity)`, `groupBy=outcome`, default category `error`- If the default org is wrong, pass `orgSlug` explicitly in the action call.

Frequently asked questions

Sentry