Sentry essentials skill for AI agents

The base Sentry skill. It resolves the right organization and project, writes real Sentry search queries, reads stack traces before drawing conclusions, and asks before it resolves, assigns or creates anything.

Asks before writingUses 16 Sentry toolsWorks in RevampKey, Claude Code, Codex and Cursor

Use in RevampKey

Get RevampKey to connect Sentry

RevampKey is a free desktop app for Mac, Windows and Linux. Install it, sign in, and Sentry is one click away with its skills already attached.

Download RevampKey

Not now? Use the skills in your current tool

curl -fsSL --create-dirs -o .claude/skills/sentry-essentials/SKILL.md https://revampkey.com/marketplace/sentry/skills/essentials/SKILL.md
Other agents
Other agents

When to use it

  • Any Sentry request that no more specific skill covers
  • When staging and production are separate projects
  • Questions about setting up or configuring Sentry

What it looks like

You

What are the top errors in production today?

whoamifind_organizationsfind_teamsfind_projects+12 more
Agent

In web-prod today: 1) TypeError: cannot read "id" of undefined in CartSummary, 1,240 events, 318 users, new since release 4.12.0; 2) a 504 from /api/search, 410 events; 3) ChunkLoadError, 160 events, mostly Safari 17. Query: is:unresolved environment:production firstSeen or lastSeen -24h, sorted by users.

The SKILL.md file

View raw
name: sentry-essentials

Ground rules for using Sentry through the Sentry MCP server, covering resolving the organization and project, writing Sentry search queries, reading issue details before concluding and asking before changing issues or projects. Use when the user asks for anything in Sentry and no more specific Sentry skill fits.

Orient

  • whoami shows the signed-in user. find_organizations, find_teams and find_projects resolve names to slugs. Ask when several projects match; staging and production are often separate projects.
  • Sentry issue ids look like PROJECT-1A2B, or a Sentry URL. Accept both.

Search well

  • find_issues takes Sentry search syntax, such as is:unresolved, level:error, firstSeen:-24h, release:1.4.2, environment:production and assigned:me. Sort by frequency or users affected for impact, or by first seen for new problems.
  • find_errors searches individual error events; find_transactions searches performance data.
  • find_tags shows which tags exist, such as browser, release or customer, so you can split an issue by them.

Reading

Read get_issue_details before saying what an issue is: the stack trace, breadcrumbs, tags and first and last seen. Do not diagnose from the title alone.

Docs

search_docs and get_doc answer "how do I set up or configure Sentry" questions from Sentry's own documentation.

Changes need a yes

update_issue (resolve, ignore, assign), create_team, create_project, update_project and create_dsn change Sentry. Show the exact change and get the user's explicit yes first.

Sentry tools it uses

  • whoami
  • find_organizations
  • find_teams
  • find_projects
  • find_issues
  • find_errors
  • find_transactions
  • find_tags
  • get_issue_details
  • search_docs
  • get_doc
  • update_issueAsks first
  • create_teamAsks first
  • create_projectAsks first
  • update_projectAsks first
  • create_dsnAsks first

Tool list from Sentry MCP documentation.

FAQ

Does it work with self-hosted Sentry?

The hosted Sentry MCP server works with sentry.io. Self-hosted Sentry needs the server run locally with your own host and token.

Will it resolve issues by itself?

No. Resolving, ignoring, assigning and creating all need your yes first.