Sentry MCP
Sentry's hosted MCP service for debugging — pull issues, events, traces, and releases into your agent, and trigger Seer root-cause analysis.
Sentry MCP connects agents to production reality: 38 tools for searching issues and events, pulling stack traces and trace details, updating and annotating issues, and invoking Seer root-cause analysis. For Claude Code, Sentry ships it as a plugin that installs a sentry-mcp subagent — errors get debugged against the actual telemetry instead of your memory of it.
Sentry MCP closes the loop between "an error is happening in production" and "the agent is fixing it." Instead of pasting a stack trace into chat, the agent queries Sentry itself — full issue context, event history, trace data — and can even hand the gnarly ones to Seer, Sentry's root-cause analysis, before writing the fix.
Highlights
- 38 debugging-focused tools —
get_issue_details,search_issues,search_events,get_trace_details,update_issue, project/release/team lookups, and docs search; curated for coding agents, not a 1:1 API mirror. - Seer on demand —
analyze_issue_with_seerruns Sentry's AI root-cause analysis and returns the findings as agent context. - A real Claude Code plugin — the install ships a
sentry-mcpsubagent that Claude Code auto-delegates Sentry investigations to, keeping noisy telemetry out of your main context. - Hosted or self-hosted — OAuth remote at
mcp.sentry.dev/mcpfor SaaS; an npx stdio server with a user token for self-hosted Sentry.
In an AI-assisted workflow
claude plugin marketplace add getsentry/sentry-mcp
claude plugin install sentry-mcp@sentry-mcp
# then:
# > Investigate the spike in SENTRY-1207, find the root cause, and propose a fixThe agent pulls the issue, reads representative events and the trace, correlates with the release, and comes back with a diagnosis grounded in telemetry — the workflow the debugger agent runs, now with production data attached.
NOTE
The subagent delegation pattern here is worth copying for any noisy data source: raw events stay in the subagent's context; only the diagnosis returns to yours. It's the same context discipline covered in Managing Claude Code Memory & Context.
Good to know
The hosted service is free with a Sentry account (Sentry itself is freemium). The code is source-available under FSL-1.1-Apache-2.0 — readable and self-hostable, not OSI open source. Self-hosted stdio mode needs token scopes (org:read, project:read/write, team:read/write, event:write), and its AI-search tools require your own LLM provider key.
Frequently asked questions
- How do I add Sentry MCP to Claude Code?
- Sentry's documented path is the plugin: claude plugin marketplace add getsentry/sentry-mcp, then claude plugin install sentry-mcp@sentry-mcp — it installs a subagent Claude Code delegates Sentry work to. The hosted endpoint (https://mcp.sentry.dev/mcp) also works as a normal remote server with OAuth via /mcp.
- What can an agent do through Sentry MCP?
- Search issues and events, pull full issue details with stack traces, fetch trace details, update issues (assign, resolve, annotate), look up projects/releases/teams, search Sentry's docs, and trigger Seer — Sentry's AI root-cause analysis — on an issue. The tool set is curated for human-in-the-loop debugging rather than full API coverage.
- Does Sentry MCP work with self-hosted Sentry?
- Yes, via the stdio server: npx @sentry/mcp-server@latest --access-token=<user-token> --host=sentry.example.com. Note the AI-powered natural-language search tools need an OpenAI or Anthropic key in that mode, and Seer may be unavailable on self-hosted instances.
Related
- The Best MCP Servers in 2026The MCP servers actually worth connecting in 2026 — Context7, GitHub, Chrome DevTools, Playwright, Serena, Exa, Firecrawl, and the best official vendor servers, by use case.
- Adding MCP Servers to Claude Code: Local, Remote, and Project-ScopedThe complete claude mcp add reference — stdio vs HTTP transports, local/project/user scopes, .mcp.json with env expansion, OAuth via /mcp, and the gotchas.
- DebuggerUse this agent to diagnose failing tests, runtime errors, or unexpected behavior by forming and testing hypotheses. Examples — a stack trace to root-cause, a flaky test, a "works locally but not in CI" bug.
- Explain ErrorDiagnose an error message or stack trace and propose a fix.
- Find BugInvestigate a reported symptom, form hypotheses, and locate the root cause.
- Claude Code Plugins: Install, Use, and Build Your OwnHow Claude Code plugins work — what they can bundle, the /plugin and marketplace commands, the plugin.json manifest, and building and testing your own.