ERROR INVESTIGATION / Sentry
Sentry MCP
Brings Sentry issues and event context into an assistant’s debugging workflow, with hosted OAuth and a local adapter for self-hosted Sentry.
“Sentry's MCP service is primarily designed for human-in-the-loop coding agents.”
01 / THE REASONING
Why this made the selection.
- Focuses its tool selection on debugging rather than pretending to expose the entire Sentry API.
- Documents both a hosted connection and the extra requirements of self-hosted deployments.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- README.md at 6c7d57a50c3bd3368e26a344b1a9fc07dadfc2df (Sentry MCP section, stdio, remote token, environment variables, example configurations)
- packages/mcp-server/package.json at 6c7d57a50c3bd3368e26a344b1a9fc07dadfc2df: @sentry/mcp-server, license FSL-1.1-ALv2, bin sentry-mcp
- packages/mcp-server/src/index.ts at 6c7d57a50c3bd3368e26a344b1a9fc07dadfc2df: stdio entrypoint and skill filtering
- LICENSE.md at 6c7d57a50c3bd3368e26a344b1a9fc07dadfc2df
- https://mcp.sentry.dev, read 2026-10-13: hosted OAuth and organization/project-scoped endpoints
Our findings
- The documented local token scopes include project, team and event writes; this is not a read-only integration.
- The source distinguishes MCP OAuth Authorization from the Sentry-Bearer upstream token and allows skills to be narrowed (?skills=, ?disable-skills=, --skills, --disable-skills).
- Repository renamed from getsentry/sentry-mcp to getsentry/toolkit; the old URL returns a 301 to the new one. This record is re-pinned at the new name; the README's Claude Code plugin line still says claude plugin marketplace add getsentry/sentry-mcp.
- The hosted guide says all connections use OAuth, and that scoping the URL to an organization or project defaults tools to it and hides discovery tools.
- configExample is the README's remote block with an explicit Sentry token at 6c7d57a5; the header value refers to ${SENTRY_ACCESS_TOKEN} rather than a literal token.
- Re-pinned from e61c1888c8f8bcca76b60229cad4eeb28226399d to 6c7d57a50c3bd3368e26a344b1a9fc07dadfc2df; LICENSE.md is byte-identical and the package name @sentry/mcp-server is unchanged.
- Correction: LICENSE.md (FSL-1.1-Apache-2.0) grants redistribution only for a Permitted Purpose, defined as any purpose other than a Competing Use. That is narrower than the licences this catalogue counts as redistribution licences, so redistribution is now recorded as false; the 2026-09-21 record said true.
Not established by this review
- Server startup, authentication and tool execution were not tested.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Connect a server deliberately.
- Add https://mcp.sentry.dev/mcp using the hosted connection guide and complete OAuth; append the documented organization/project path to narrow the connection.
- For self-hosting, follow the README's stdio instructions (npx @sentry/mcp-server@latest with --access-token and --host) and configure the documented Sentry token scopes and optional model provider.
- No one-line command is shown: the README's primary path is the hosted service, and its stdio line embeds a token argument.
Before you start
- A Sentry account with access to the target organization, or a configured self-hosted Sentry instance.
Documented configuration example
Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.
{
"mcpServers": {
"sentry": {
"url": "https://mcp.sentry.dev/mcp",
"headers": {
"Authorization": "Sentry-Bearer ${SENTRY_ACCESS_TOKEN}"
}
}
}
} 04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- Official documentation ↗Checked
https://github.com/getsentry/toolkit/blob/6c7d57a50c3bd3368e26a344b1a9fc07dadfc2df/README.md
Supports: summary, whySelected, bestFor, limitations, install, access, compatibility, transports, configExample, review
- Applicable source licence ↗Checked
https://github.com/getsentry/toolkit/blob/6c7d57a50c3bd3368e26a344b1a9fc07dadfc2df/LICENSE.md
Supports: license
https://github.com/getsentry/toolkit/blob/6c7d57a50c3bd3368e26a344b1a9fc07dadfc2df/packages/mcp-server/package.json
Supports: language, review
https://github.com/getsentry/toolkit/blob/6c7d57a50c3bd3368e26a344b1a9fc07dadfc2df/packages/mcp-server/src/index.ts
Supports: language, review
https://mcp.sentry.dev
Supports: install, access, compatibility, transports, review