Sentry

Sentry MCP server

Official hosted MCP server: search issues, errors and traces, read stack traces and let Seer analyze them. OAuth sign-in.

Developer toolsGuided#mcp#errors#monitoring#debugging#observability#ai-agents

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

The Sentry MCP server lets an AI assistant work with your Sentry account: find organizations and projects, search issues, errors, logs and traces, read an issue's stack trace and breadcrumbs, look at releases, ask Sentry's Seer AI to analyze an issue, and, if you allow it, resolve or assign issues, add notes, create projects and DSN keys. It is hosted by Sentry and built for coding agents that debug production problems.

  • Endpoint (Streamable HTTP): https://mcp.sentry.dev/mcp
  • Limit it to one organization or project by path: https://mcp.sentry.dev/mcp/<org-slug> or /mcp/<org-slug>/<project-slug> (from Sentry's OAuth architecture notes in the source repo).
  • Narrow the tool groups ("skills") with a query: ?skills=inspect,triage or ?disable-skills=seer.
  • Self-hosted Sentry: run the server over stdio with the Sentry CLI (sentry mcp) instead of the hosted endpoint.

Credentials (OAuth, checked 2026-11-18)

The hosted server needs a Sentry login. An unauthenticated call returns HTTP 401 with WWW-Authenticate: Bearer realm="OAuth", resource_metadata="https://mcp.sentry.dev/.well-known/oauth-protected-resource/mcp". The metadata lists the authorization server https://mcp.sentry.dev (authorize /oauth/authorize, token /oauth/token, dynamic client registration /oauth/register, PKCE S256, scopes org:read, project:write, team:write, event:write, alerts:write). Folder 4 replays those discovery requests.

  1. Use a client with MCP OAuth support (Claude Code, Cursor, VS Code, Claude Desktop connectors, and the MCP editor in Swastik Codes). On first connect your browser opens to sign in to Sentry and grant the permission groups you want.
  2. On the consent screen choose the skills: Inspect and Seer are on by default; Triage and Project Management (which can change data) are opt-in.
  3. For a fixed token instead, the repo documents sending Authorization: Sentry-Bearer <token> (a Sentry auth token); the plain Bearer scheme is reserved for tokens issued by the MCP's own OAuth. Create tokens in Sentry under Settings > Developer Settings.
  4. In this collection: native MCP requests use the app's OAuth sign-in. Set sentryToken only for the Sentry-Bearer example in folder 4.

Tools

The tool list below comes from the official source repository (github.com/getsentry/sentry-mcp, packages/mcp-core/src/tools/catalog) read on 2026-11-18, not from a live tools/list, because the hosted server requires sign-in. What you see after connecting depends on the skills you granted, your scopes and the server version.

Skill / scopeTools
Inspect (read-only)whoami, find_organizations, find_projects, find_teams, find_releases, search_issues, get_issue_details, search_errors, search_logs, search_traces, search_metrics, search_profiles, search_replays, get_trace_details, get_span_details, get_issue_activity, get_issue_breadcrumbs, find_dashboards, find_monitors, find_alert_rules, search_docs, get_doc, and more
Seer (AI debugger)analyze_issue_with_seer
Triage (writes)update_issue, add_issue_note, link_issue, unlink_issue
Project management (writes)create_team, create_project, update_project, create_dsn, update_dsn, add_team_to_project, remove_team_from_project, create_alert_rule, update_alert_rule, delete_alert_rule, create_monitor, create_metric_monitor, update_metric_monitor, delete_metric_monitor, create_uptime_monitor, update_uptime_monitor, delete_uptime_monitor

search_events is deprecated in favor of the dataset-specific search tools. The AI-assisted search tools (search_errors, search_issues, and the other search_* tools) turn natural language into Sentry query syntax; on the stdio server this needs an LLM provider key, on the hosted server it is handled for you.

Add it to your AI client

Claude Code:

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

then run /mcp in a session and sign in. Sentry also ships a Claude Code plugin: claude plugin marketplace add getsentry/sentry-mcp then claude plugin install sentry-mcp@sentry-mcp.

Claude Desktop / claude.ai: Settings > Connectors > Add custom connector, URL https://mcp.sentry.dev/mcp.

Cursor (~/.cursor/mcp.json) and VS Code (.vscode/mcp.json, use servers and add "type": "http"):

{
  "mcpServers": {
    "sentry": { "url": "https://mcp.sentry.dev/mcp" }
  }
}

With a token instead of OAuth (from the repo README):

{
  "mcpServers": {
    "sentry": {
      "url": "https://mcp.sentry.dev/mcp",
      "headers": { "Authorization": "Sentry-Bearer ${SENTRY_ACCESS_TOKEN}" }
    }
  }
}

Safety for write tools

Read tools expose error data that may contain user details, request bodies or secrets that were captured in events; they go into your assistant's context. The write tools change your Sentry organization: update_issue can resolve, ignore, reassign or change priority of issues (affecting alert noise and your team's queue), add_issue_note posts a visible comment as you, create_project and create_dsn create real projects and client keys, and the delete_* tools remove alert rules and monitors. Grant only the skills you need (leave Triage and Project Management off for plain debugging), use the /mcp/<org>/<project> path to fence a session, and have your client ask for confirmation before each write. This collection's folder 3 is the only place that writes, and its examples use placeholder slugs.

Run order

  1. Start here: whoami, organizations, projects, issue search, issue details (replace the placeholder slugs with yours).
  2. Investigate: errors, trace, releases, docs, Seer.
  3. Write tools: change data; read the safety notes first.
  4. Sign-in and plain HTTP: the 401, OAuth discovery, and a raw call with a token.

Limits

Sentry applies rate limits to API use and Seer analysis is tied to your plan; see https://docs.sentry.io/api/ratelimits/ and https://sentry.io/pricing/. Search results are paged (25 or fewer per page, with a cursor).

Common errors

What you seeMeaningWhat to do
HTTP 401, empty bodyNot signed inComplete OAuth or send a token
Tool missing from the listSkill or scope not grantedReconnect and grant the skill
"Organization slug is required"Missing organizationSlugCall find_organizations first
Issue not foundWrong short ID or regionUse the ID shown in Sentry or the issue URL
Permission error on a writeToken lacks event:write or project:writeRe-authorize with the needed scopes

Links

  • Hosted server: https://mcp.sentry.dev
  • Source and docs: https://github.com/getsentry/sentry-mcp
  • Sentry CLI MCP: https://cli.sentry.dev/commands/mcp/
  • MCP authorization: https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization

Endpoints 19

1. Start here

  • MCPWho am I (whoami){{mcpUrl}}Returns the Sentry user the connection is authenticated as: name and email, plus any session constraints when you used an organization or project path. Run it…
  • MCPList organizations (find_organizations){{mcpUrl}}Lists the organizations your login can see with each slug and region URL, paged with a cursor. The slug is the value every other tool calls organizationSlug;…
  • MCPList projects (find_projects){{mcpUrl}}Lists or searches the projects of one organization, 25 per page, returning slugs. query filters by name or slug or accepts a numeric project ID; pass cursor…
  • MCPSearch issues (search_issues){{mcpUrl}}Searches grouped issues with status, occurrences, users affected, assignee and first and last seen. query takes plain English or Sentry syntax, sort is date,…
  • MCPIssue details (get_issue_details){{mcpUrl}}Reads one issue in depth: title, culprit, counts, status, assignee, platform and the latest event with its stack trace. Identify it with issueId (the short ID…

2. Investigate

  • MCPSearch error events (search_errors){{mcpUrl}}Searches individual error events, exceptions and stack traces, and can compute counts and trends. Use query for natural language or Sentry syntax, projectSlug…
  • MCPTrace overview (get_trace_details){{mcpUrl}}Summarizes one distributed trace by its 32-character hexadecimal trace ID: statistics, a condensed span breakdown and a link to the trace in Sentry. Pass…
  • MCPRecent releases (find_releases){{mcpUrl}}Lists releases (deployed versions) with dates, new-issue counts, last commit and last deploy, at most 25. Filter by projectSlug and by a query substring such…
  • MCPSearch Sentry docs (search_docs){{mcpUrl}}Searches docs.sentry.io for SDK setup, framework integrations, sampling and source maps, returning page paths and short snippets. Queries must be 2 to 200…
  • MCPRead a docs page (get_doc){{mcpUrl}}Fetches a full Sentry documentation page by the path returned from search_docs, or by a full docs.sentry.io URL, and returns its content. Use it when a…
  • MCPAnalyze an issue with Seer (analyze_issue_with_seer){{mcpUrl}}Asks Sentry's Seer AI debugger to analyze an issue, find a root cause and suggest a fix. It may take a while and uses your plan's Seer quota. Provide the…

3. Write tools (change data)

  • MCPResolve or reassign an issue (update_issue){{mcpUrl}}Changes an issue: status (resolved, resolvedInNextRelease, unresolved, ignored), assignedTo, priority (low, medium, high), and snooze options for ignoring.…
  • MCPComment on an issue (add_issue_note){{mcpUrl}}Posts a comment on an issue, up to 4096 characters, posted as is and visible to everyone on the issue under your name. Requires event:write. Use it to leave…
  • MCPCreate a client key (create_dsn){{mcpUrl}}Creates a new DSN, the client key SDKs use to send events, for one project, with a display name such as Production. Requires project:write. The returned DSN…
  • MCPCreate a project (create_project){{mcpUrl}}Creates a project under an existing team with a name, optional slug, platform and a repository in owner/repo form (the repository must already be connected by…

4. Sign-in and plain HTTP

  • POSTUnauthenticated call (expect 401){{mcpUrl}}POSTs an MCP initialize with no credentials. The server answers 401 with an empty body and a WWW-Authenticate header whose resource_metadata URL tells a…
  • GETProtected resource metadatahttps://mcp.sentry.dev/.well-known/oauth-protected-resource/mcpPublic GET that describes the MCP resource and which authorization server issues tokens for it (RFC 9728). Clients read it after the 401. It lists the…
  • GETAuthorization server metadatahttps://mcp.sentry.dev/.well-known/oauth-authorization-serverPublic GET with the OAuth endpoints: authorize, token, dynamic client registration and revocation, S256 PKCE and the grant types. The MCP editor's OAuth…
  • POSTtools/list with a token (plain HTTP){{mcpUrl}}Lists the tools you are allowed to use, sending a Sentry auth token in the Sentry-Bearer scheme documented in the source repo. Put the token in the secret…

API details

Base URL
https://mcp.sentry.dev/mcp
Authentication
OAuth 2.0 (authorization code flow) with 5 scopes
Operations
19 operations on 19 pathsPOST 17GET 2
Main resources
1. Start here 52. Investigate 63. Write tools (change data) 44. Sign-in and plain HTTP 4
Description format
Swastik Codes guided collection, API version checked against the docs on 2026-11-18

How to test the Sentry MCP server in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Sentry MCP server collection, without the publisher's secrets.
  3. Add your credentialsThis API uses OAuth 2.0 (authorization code flow) with 5 scopes. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Who am I (whoami)” (POST {{mcpUrl}}), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Sentry MCP server?

Official hosted MCP server: search issues, errors and traces, read stack traces and let Seer analyze them. OAuth sign-in. It is listed under Developer tools and has 19 endpoints.

Who publishes the Sentry MCP server?

It is listed from Sentry's public API description (an OpenAPI document), not published by Sentry on Swastik Codes. Anyone who controls sentry.io can claim the profile by adding a DNS TXT record.

What is the base URL of the Sentry MCP server?

Requests go to https://mcp.sentry.dev/mcp. Endpoint paths are added to this base URL.

How do I authenticate with the Sentry MCP server?

With OAuth 2.0 (authorization code flow) with 5 scopes.

How many endpoints does the Sentry MCP server have?

19 operations on 19 paths (17 POST, 2 GET). The largest groups are 1. Start here, 2. Investigate, 3. Write tools (change data), 4. Sign-in and plain HTTP.

Is forking the Sentry MCP server free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.