sentry MCP Server

Use This MCP server To

Look up why the app crashed for one specific user Find the errors that started after yesterday's release Read a stack trace and get a plain explanation Search my errors by asking a question in plain English Trace which step made a request slow Check whether an issue is still happening today

README

sentry-mcp

Sentry's MCP service is primarily designed for human-in-the-loop coding agents. Our tool selection and priorities are focused on developer workflows and debugging use cases, rather than providing a general-purpose MCP server for all Sentry functionality.

This remote MCP server acts as middleware to the upstream Sentry API, optimized for coding assistants like Cursor, Claude Code, and similar development tools. It's based on Cloudflare's work towards remote MCPs.

Getting Started

You'll find everything you need to know by visiting the deployed service in production:

https://mcp.sentry.dev

If you're looking to contribute, learn how it works, or to run this for self-hosted Sentry, continue below.

Claude Code Plugin

Install as a Claude Code plugin for automatic subagent delegation:

claude plugin marketplace add getsentry/sentry-mcp
claude plugin install sentry-mcp@sentry-mcp

This provides a sentry-mcp subagent that Claude automatically delegates to when you ask about Sentry errors, issues, traces, or performance.

For forward-looking tool variants and features:

claude plugin install sentry-mcp@sentry-mcp-experimental

Stdio vs Remote

While this repository is focused on acting as an MCP service, we also support a stdio transport. This is still a work in progress, but is the easiest way to adapt run the MCP against a self-hosted Sentry install.

Note: The AI-powered search tools (search_events, search_issues, etc.) require an LLM provider (OpenAI, Azure OpenAI, Anthropic, or OpenRouter). These tools use natural language processing to translate queries into Sentry's query syntax. Without a configured provider, these specific tools will be unavailable, but all other tools will function normally.

To utilize the stdio transport, you'll need to create an User Auth Token in Sentry with the necessary scopes. As of writing this is:

org:read
project:read
project:write
team:read
team:write
event:write

Launch the transport:

npx @sentry/mcp-server@latest --access-token=sentry-user-token

Need to connect to a self-hosted deployment? Add --host (hostname only, e.g. --host=sentry.example.com) when you run the command. For isolated internal deployments that only expose plain HTTP, also add --insecure-http.

Some features (like Seer) may not be available on self-hosted instances. You can disable specific skills to prevent unsupported tools from being exposed:

npx @sentry/mcp-server@latest --access-token=TOKEN --host=sentry.example.com --disable-skills=seer

For self-hosted instances without TLS:

sentry-mcp FAQ

Which apps is it built for?

Coding assistants. Cursor, Claude Code and similar developer tools are the stated targets.

How hard is setup?

The hosted version at mcp.sentry.dev signs you in with your Sentry account, so there is very little to configure.

Can I use this with self-hosted Sentry?

Yes — run the local version with a personal token and point it at your own hostname.

Do I need any other paid keys?

Only for the plain-English search tools, which need a provider such as OpenAI or Anthropic. Everything else works without one.

Does it cover all of Sentry?

No. The maintainers say it is deliberately focused on debugging workflows rather than every Sentry feature.

Is there a Claude Code plugin?

Yes. It installs as a plugin that Claude hands Sentry questions to automatically.