
Sentry MCP Server
Sentry issues, stack traces, traces and Seer fixes inside your coding agent.
- Needs your setup first
- ★ 949 GitHub stars
- 77.9K downloads a week
- Last commit 28 Oct 2026
What is Sentry MCP?
Sentry MCP is Sentry's official server that lets a coding agent read issues, stack traces, logs, traces and replays from Sentry and ask Seer, Sentry's AI debugger, for a root cause and fix.
- Tools
- 48
- Runs on
- Hosted
- Licence
- FSL-1.1-ALv2
- GitHub stars
- 949
Good for
- Going from a Sentry alert to a fix in the same session
- Asking for errors, slow spans or logs in plain English instead of Sentry query syntax
- Running Seer root-cause analysis on an issue from your coding agent
You'll need
- A Sentry account on sentry.io, or a self-hosted Sentry with a user auth token
- For the natural-language search tools on stdio only: an OpenAI, Anthropic or OpenRouter key
Needs your setup firstIt needs something our Linux test machine does not have (an account, a desktop app, a Mac or a running service), so on 10 Nov 2026 we read its tools from the source code instead of running this config. The repository moved from getsentry/sentry-mcp to getsentry/toolkit, which also holds the Sentry CLI. The stdio package is @sentry/mcp-server on npm, published from that repository.
Try asking Sentry MCP
Once it is installed, ask your assistant things like:
- What are the top unresolved errors in my project this week?
- Show me the stack trace for this issue and suggest a fix: <issue link>
- Which release introduced this error?
MCP Shelf take
Sentry needs something our Linux test machine does not have (an account, an app or a service), so on 10 Nov 2026 we read its source and counted 48 tools. 47 of the 48 only read; the other 1 can change things. It sits 23rd of 24 in its category on our shelf by GitHub stars (949, with 77.9K downloads a week).
What can Sentry MCP read and change?
It can read
- Issues, events, stack traces, breadcrumbs and user feedback
- Traces, spans, logs, metrics, replays and profiles
- Releases, dashboards, monitors, alert rules and project settings
It can change
- Issue status, assignees and notes, with the triage skill
- Projects, teams, DSNs, monitors and alert rules, with project management
- Starts Seer analyses, which count against your Seer usage
Safer setup: Grant only inspect, plus seer if you use it, when you sign in. Add triage or project management later, once you want the agent to change things.
Sentry MCP in more detail
Sentry built this server for coding agents rather than as a general admin tool. Paste an issue link or ask what broke and the assistant can open the issue, read the stack trace, breadcrumbs and tags, search errors, logs, spans and replays, and ask Seer, Sentry's own AI debugger, for a root cause and a suggested fix. That is usually enough to go from an alert to a patch without leaving the editor.
It runs as a remote server at mcp.sentry.dev that signs in with OAuth. Tools come in skill groups: inspecting and Seer are on by default, while triage (resolving and assigning issues) and project management (projects, DSNs, monitors, alert rules) have to be granted. A stdio package exists too, mainly for self-hosted Sentry.
- Made by
- Sentry (getsentry/toolkit)
- Downloads
- 77.9K a week
- Last commit
- 28 Oct 2026
- Setup checked
- 10 Nov 2026
- Page updated
- 10 Nov 2026
What's in the pod
What tools does Sentry MCP have?
We found 48 tools in its source code on 10 Nov 2026. 47 only read. The rest can change things, so keep your app's "ask before each tool call" setting on for them.
How we tested it: Read from the source of @sentry/mcp-server 0.49.0: the tools in the inspect and seer skills that load by default. The hosted server needs a Sentry sign-in; triage and project management add more once granted.
Changes things1 tool · Can create, edit, send or delete.
| Tool | What it is for |
|---|---|
analyze_issue_with_seer | Asks Seer for a root-cause analysis of an issue and a suggested code fix. |
Only reads47 tools · Looks things up and changes nothing.
| Tool | What it is for |
|---|---|
find_alert_rules | Lists alert rules. |
find_dashboards | Lists dashboards. |
find_metric_monitors | Lists metric monitors. |
find_monitors | Lists cron monitors. |
find_organizations | Lists the organisations you can see, with the slug and region other tools need. |
find_projects | Lists or searches the projects in an organisation. |
find_releases | Lists releases for a project. |
find_uptime_monitors | Lists uptime monitors. |
get_doc | Reads one Sentry docs page. |
get_event_stacktrace | Returns an event's stack trace on its own. |
get_issue_activity | Lists an issue's history: status changes, assignments and notes. |
get_issue_breadcrumbs | Shows the breadcrumbs that led up to an error. |
get_issue_details | Reads one issue: its error, latest event, stack trace and tags. |
get_issue_tag_values | Shows how an issue spreads across a tag, such as browser or release. |
get_issue_user_reports | Reads the feedback users sent with an issue. |
get_profile_details | Reads one profile. |
get_release_details | Reads one release, with its commits and new issues. |
get_replay_details | Reads one session replay's summary. |
get_sentry_resource | Opens anything from a Sentry link or id: an issue, event, trace, replay and so on. |
get_span_details | Reads one span. |
get_trace_details | Reads a whole trace with its spans. |
search_docs | Searches the Sentry documentation. |
search_errors | Searches error events, with counts and trends, from a plain-English question. |
search_issue_events | Lists the individual events inside one issue. |
search_issues | Finds issues from a plain-English description, such as unresolved errors in checkout this week. |
search_logs | Searches log lines the same way. |
search_metrics | Queries trace metrics. |
search_profiles | Finds profiling data. |
search_replays | Finds session replays. |
search_traces | Searches spans and traces, for questions such as the slowest endpoints today. |
whoami | Shows which Sentry user the session is signed in as. |
find_dropped_eventsfind_teamsget_agent_conversation_detailsget_alert_optionsget_alert_ruleget_dashboard_detailsget_event_attachmentget_latest_base_snapshotget_metric_monitor_detailsget_monitor_detailsget_profileget_snapshotget_snapshot_imageget_uptime_monitor_detailssearch_agent_conversationssearch_events
Tool groups
inspect (on by default)- Read-only: issues, events, stack traces, breadcrumbs, traces, spans, logs, replays, profiles, releases, dashboards, monitors, alert rules and the Sentry docs.
seer (on by default on sentry.io)- analyze_issue_with_seer, Sentry's AI root-cause analysis and fix suggestions. Left out by default on self-hosted Sentry, which has no Seer.
triage (off until you grant it)- update_issue, notes, and linking or unlinking issues to external trackers.
project-management (off until you grant it)- Create and change projects, teams, DSNs, cron, uptime and metric monitors, and alert rules.
Grouped and described by us. The README on GitHub lists the inputs each tool takes.
How do I install Sentry MCP?
Quick install
Pick your app and paste this in. It follows the README's own install steps below.
Where it goes: Your terminal, in the project folder
claude mcp add --transport http sentry https://mcp.sentry.dev/mcpSentry also ships a Claude Code plugin with a sentry-mcp subagent that Claude hands Sentry questions to: claude plugin marketplace add getsentry/sentry-mcp, then claude plugin install sentry-mcp@sentry-mcp.
Where it goes: ~/.cursor/mcp.json, or .cursor/mcp.json in a project
{
"mcpServers": {
"sentry": {
"url": "https://mcp.sentry.dev/mcp"
}
}
}Cursor opens Sentry's sign-in page the first time it connects. Pick the organisation and the skills to grant there.
Where it goes: Customize → Connectors → add a custom connector
https://mcp.sentry.dev/mcpPaste the URL and sign in if asked. Custom connectors depend on your plan.
Where it goes: .vscode/mcp.json in your project
{
"servers": {
"sentry": {
"type": "http",
"url": "https://mcp.sentry.dev/mcp"
}
}
}Install steps from the Sentry MCP README
Sentry MCP's licence (FSL-1.1-ALv2) does not let us copy its README, so its own install steps are on GitHub: read the Sentry MCP README. The steps and configs below are written from it in our own words.
What you need first
- A Sentry account on sentry.io, or a self-hosted Sentry with a user auth token
- For the natural-language search tools on stdio only: an OpenAI, Anthropic or OpenRouter key
Add Sentry MCP to your app
Pick your app for a ready-to-paste snippet and where it goes.
Where it goes: Your terminal, in the project folder
claude mcp add --transport http sentry https://mcp.sentry.dev/mcpSentry also ships a Claude Code plugin with a sentry-mcp subagent that Claude hands Sentry questions to: claude plugin marketplace add getsentry/sentry-mcp, then claude plugin install sentry-mcp@sentry-mcp.
Where it goes: ~/.cursor/mcp.json, or .cursor/mcp.json in a project
{
"mcpServers": {
"sentry": {
"url": "https://mcp.sentry.dev/mcp"
}
}
}Cursor opens Sentry's sign-in page the first time it connects. Pick the organisation and the skills to grant there.
Where it goes: Customize → Connectors → add a custom connector
https://mcp.sentry.dev/mcpPaste the URL and sign in if asked. Custom connectors depend on your plan.
Where it goes: .vscode/mcp.json in your project
{
"servers": {
"sentry": {
"type": "http",
"url": "https://mcp.sentry.dev/mcp"
}
}
}Where it goes: ~/.codex/config.toml, shared by the Codex CLI, IDE extension and ChatGPT desktop app
[mcp_servers.sentry]
url = "https://mcp.sentry.dev/mcp"Or run: codex mcp add sentry --url https://mcp.sentry.dev/mcp, then codex mcp login sentry if it asks you to sign in.
Where it goes: ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"sentry": {
"serverUrl": "https://mcp.sentry.dev/mcp"
}
}
}Where it goes: chatgpt.com/plugins → + → Add custom MCP server
https://mcp.sentry.dev/mcpPaste the URL as the server address, choose OAuth if it asks you to sign in, create it as a plugin, then install it before using it in a chat. Workspace admins can block custom servers.
Your client opens a Sentry sign-in in the browser, where you pick the organisation and the skills to grant. For self-hosted Sentry, run npx @sentry/mcp-server@latest with SENTRY_AUTH_TOKEN and SENTRY_HOST instead.
Checked against the project's own install docs on 10 Nov 2026: getsentry/toolkit README, mcp.sentry.dev, www.npmjs.com/package/@sentry/mcp-server.
Did this work for you?
Projects change their install steps often. If Sentry MCP did not install, or something here no longer matches the project, tell us and we will check it against the README and fix the page.
New to this? See the setup guides for Claude Code, Cursor, Claude Desktop, VS Code, Codex and ChatGPT. If it will not start, test it in MCP Inspector and look up the error in Fixing MCP server errors.
Sentry MCP not working? Common fixes
- Rate Limited messages
- Sentry's API limits calls per second, and agents hit them by running many Sentry tools in parallel. The server retries on its own; if it still fails, ask the agent to run calls one at a time.
- search_errors, search_logs and the other search tools are missing on stdio
- They need an LLM provider. Set EMBEDDED_AGENT_PROVIDER and that provider's API key in env.
- OAuth fails in the MCP Inspector on 127.0.0.1
- Open the Inspector on localhost instead, for example http://localhost:6274.
- Seer is missing on self-hosted Sentry
- Self-hosted Sentry has no Seer, so setting SENTRY_HOST drops it. If your deployment does run Seer, add --skills=inspect,seer.
- The server warns about --access-token
- That option is deprecated. Use SENTRY_AUTH_TOKEN, or sign in once with npx @sentry/mcp-server@latest auth login.
How do I configure Sentry MCP?
Names are exactly as the project spells them. Required ones are marked.
| Setting | What it does |
|---|---|
https://mcp.sentry.dev/mcpConfig | The hosted server. It signs in with OAuth, where you choose the organisation and the skills to grant. |
?skills= and ?disable-skills=Config | Query parameters on the hosted URL that narrow which skill groups load.https://mcp.sentry.dev/mcp?skills=inspect,triage |
Authorization: Sentry-BearerConfig | Header for passing a Sentry API token to the hosted server instead of OAuth. Kept apart from Bearer, which is for OAuth tokens.Authorization: Sentry-Bearer YOUR_SENTRY_TOKEN |
SENTRY_AUTH_TOKENEnvironment variable | A user auth token for the stdio package, with org:read, project:read, project:write, team:read, team:write and event:write. Optional after npx @sentry/mcp-server@latest auth login. |
SENTRY_HOSTEnvironment variable | Your self-hosted Sentry's hostname for the stdio package. Setting it also drops the seer skill. Use SENTRY_URL with http:// for an internal server without TLS.sentry.example.com |
EMBEDDED_AGENT_PROVIDEREnvironment variable | Which LLM the stdio package uses to turn plain-English searches into Sentry queries: openai, azure-openai, anthropic or openrouter, with the matching API key. Without one, the search_* tools are missing.anthropic |
MCP_SKILLS and MCP_DISABLE_SKILLSEnvironment variable | Choose skill groups for the stdio package, or --skills and --disable-skills on the command line.inspect,seer |
Sentry MCP FAQ
Is Sentry MCP official?
Yes. Sentry builds it in the getsentry/toolkit repository, alongside the Sentry CLI, and runs the hosted server at mcp.sentry.dev. The stdio version is the @sentry/mcp-server package on npm.
How do I add Sentry MCP to Claude Code?
Run claude mcp add --transport http sentry https://mcp.sentry.dev/mcp, then /mcp to sign in. Or install Sentry's plugin, which adds a subagent for Sentry questions: claude plugin install sentry-mcp@sentry-mcp after adding the getsentry/sentry-mcp marketplace.
Does Sentry MCP work with self-hosted Sentry?
Yes, through the stdio package. Run npx @sentry/mcp-server@latest with SENTRY_HOST set to your server and SENTRY_AUTH_TOKEN, or sign in with auth login. Seer is left out, as self-hosted Sentry does not include it.
Can the agent change things in Sentry?
Only if you grant it. Inspect and Seer are the default skills. Resolving and assigning issues needs triage, and creating projects, DSNs, monitors or alert rules needs project management.
What is Seer?
Sentry's AI debugger. analyze_issue_with_seer asks it to find the root cause of an issue and propose a fix, which your coding agent can then apply.
Why does the local version need an OpenAI or Anthropic key?
The search tools take plain-English questions and use an LLM to turn them into Sentry query syntax. The hosted server handles that for you; with stdio you supply the provider and key.
What licence is Sentry MCP under?
The Functional Source License 1.1, which turns into Apache 2.0 after two years. You can use and self-host it freely, but not offer it as a competing commercial service.
What does Sentry MCP cost?
The server itself is free to use with any Sentry plan. Seer is a paid Sentry feature, so analyses count against your Seer usage.
How do I add Sentry MCP to Cursor?
In ~/.cursor/mcp.json, or .cursor/mcp.json for one project, add an entry named sentry with the URL https://mcp.sentry.dev/mcp. Cursor opens Sentry's sign-in page the first time it connects. Pick the organisation and the skills to grant there.
Can I use Sentry MCP in VS Code?
Yes, through GitHub Copilot. In .vscode/mcp.json, add a server named sentry with type http and the URL https://mcp.sentry.dev/mcp. Then switch Copilot Chat to Agent mode to use its tools.
Does Sentry MCP work with Codex?
Yes. Run codex mcp add sentry --url https://mcp.sentry.dev/mcp in a terminal, or add an [mcp_servers.sentry] table to ~/.codex/config.toml, which the Codex CLI and IDE extension share. Then codex mcp login sentry if it asks you to sign in.
Two peas, one chat
Chat with AI about Sentry
Opens a chat primed with Sentry’s README and setup docs from this page, or add it in Cursor to use its tools.
The Cursor button opens Cursor and asks before it adds the server. Fill in any keys it needs in Cursor’s MCP settings.
Peas in a pod
What are the alternatives to Sentry MCP?
How Sentry MCP lines up against its neighbours on the shelf. See every developer tools server.

Sentry MCPThis pea
Sentry issues, stack traces, traces and Seer fixes inside your coding agent.
- Tools
- 48
- Runs on
- Hosted
- Licence
- FSL-1.1-ALv2
- Stars
- 949

Official Microsoft docs and code samples for your assistant, free and with no sign-in.
- Tools
- 3
- Runs on
- Hosted
- Licence
- CC-BY-4.0
- Stars
- 2K

Your Postman workspaces, collections, specs and mocks, from inside the editor.
- Tools
- 42
- Runs on
- Hosted
- Licence
- Apache-2.0
- Stars
- 325

A terminal, file search and surgical file edits for your assistant.
- Tools
- 25
- Runs on
- Your computer
- Licence
- MIT
- Stars
- 10.2K

IDE-style "find symbol" and "edit symbol" for an agent, backed by language servers.
- Tools
- 3 (REPL)
- Runs on
- Your computer
- Licence
- GPL-3.0
- Stars
- 30.8K

Pulls current, version-specific library docs into the conversation.
- Tools
- 2
- Runs on
- Your computer or hosted
- Licence
- MIT
- Stars
- 63.8K
Something wrong on this page? Tell us.
For bots & AI agents
Machine-readable versions of Sentry MCP and MCP Shelf. Fetch these instead of parsing this page.
This listing (.md)llms.txtllms-full.txtai.txtFull catalog (.md)API specMCP serverMCP manifestDeveloper docs