Skip to content
MCP Shelf

Sentry MCP Server

Sentry issues, stack traces, traces and Seer fixes inside your coding agent.

View on GitHub
  • 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
Works withClaude CodeCursorClaude DesktopVS CodeCodexWindsurfChatGPTEach has a ready-made config on the Install tab, built from the README.

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).
MCP Shelf tests: numbers from our own runs, not the README · tested on 10 Nov 2026

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.

ToolWhat it is for
analyze_issue_with_seerAsks Seer for a root-cause analysis of an issue and a suggested code fix.

Only reads47 tools · Looks things up and changes nothing.

ToolWhat it is for
find_alert_rulesLists alert rules.
find_dashboardsLists dashboards.
find_metric_monitorsLists metric monitors.
find_monitorsLists cron monitors.
find_organizationsLists the organisations you can see, with the slug and region other tools need.
find_projectsLists or searches the projects in an organisation.
find_releasesLists releases for a project.
find_uptime_monitorsLists uptime monitors.
get_docReads one Sentry docs page.
get_event_stacktraceReturns an event's stack trace on its own.
get_issue_activityLists an issue's history: status changes, assignments and notes.
get_issue_breadcrumbsShows the breadcrumbs that led up to an error.
get_issue_detailsReads one issue: its error, latest event, stack trace and tags.
get_issue_tag_valuesShows how an issue spreads across a tag, such as browser or release.
get_issue_user_reportsReads the feedback users sent with an issue.
get_profile_detailsReads one profile.
get_release_detailsReads one release, with its commits and new issues.
get_replay_detailsReads one session replay's summary.
get_sentry_resourceOpens anything from a Sentry link or id: an issue, event, trace, replay and so on.
get_span_detailsReads one span.
get_trace_detailsReads a whole trace with its spans.
search_docsSearches the Sentry documentation.
search_errorsSearches error events, with counts and trends, from a plain-English question.
search_issue_eventsLists the individual events inside one issue.
search_issuesFinds issues from a plain-English description, such as unresolved errors in checkout this week.
search_logsSearches log lines the same way.
search_metricsQueries trace metrics.
search_profilesFinds profiling data.
search_replaysFinds session replays.
search_tracesSearches spans and traces, for questions such as the slowest endpoints today.
whoamiShows which Sentry user the session is signed in as.
  • find_dropped_events
  • find_teams
  • get_agent_conversation_details
  • get_alert_options
  • get_alert_rule
  • get_dashboard_details
  • get_event_attachment
  • get_latest_base_snapshot
  • get_metric_monitor_details
  • get_monitor_details
  • get_profile
  • get_snapshot
  • get_snapshot_image
  • get_uptime_monitor_details
  • search_agent_conversations
  • search_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 Code
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

Sentry 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.

Codex, Windsurf, ChatGPT and more →

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 Code
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

Sentry 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.

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.

SettingWhat it does
https://mcp.sentry.dev/mcpConfigThe hosted server. It signs in with OAuth, where you choose the organisation and the skills to grant.
?skills= and ?disable-skills=ConfigQuery parameters on the hosted URL that narrow which skill groups load.https://mcp.sentry.dev/mcp?skills=inspect,triage
Authorization: Sentry-BearerConfigHeader 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 variableA 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 variableYour 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 variableWhich 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 variableChoose 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
  • Microsoft Learn MCP

    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
  • Postman MCP Server

    Your Postman workspaces, collections, specs and mocks, from inside the editor.

    Tools
    42
    Runs on
    Hosted
    Licence
    Apache-2.0
    Stars
    325
  • Desktop Commander

    A terminal, file search and surgical file edits for your assistant.

    Tools
    25
    Runs on
    Your computer
    Licence
    MIT
    Stars
    10.2K
  • Serena

    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
  • Context7

    Pulls current, version-specific library docs into the conversation.

    Tools
    2
    Runs on
    Your computer or hosted
    Licence
    MIT
    Stars
    63.8K
Full docs on GitHubgetsentry/toolkit

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