Sentry

getsentry/toolkitOfficial

Sentry MCP provides middleware between AI coding assistants and the Sentry error tracking platform, exposing tools for debugging workflows such as searching issues and events, retrieving traces, and analyzing performance data. The server supports both remote deployment and stdio transport for self-hosted Sentry instances, with AI-powered search capabilities that require configuration of an LLM provider (OpenAI or Anthropic) to translate natural language queries into Sentry's query syntax. It solves the problem of enabling AI coding agents like Claude and Cursor to programmatically access and investigate Sentry error data during development and debugging sessions.

tools: 19
auth: Secret needed
transport: STDIO, HTTP
env vars: 3
last updated: Nov 7, 2026

View on GitHub

Tools

19 tools

Public tool metadata for what this MCP can expose to an agent.

whoamiIdentify the authenticated user in Sentry. Use this tool when you need to: - Get the user's name and email address.

Identify the authenticated user in Sentry. Use this tool when you need to: - Get the user's name and email address.

No parameter schema in public metadata yet.

find_organizationsFind organizations that the user has access to in Sentry. Use this tool when you need to: - View organizations in Sentry - Find an organization's slug to aid other tool requests - Search for specific organizations by name or slug Returns up to 25 results. If you hit this limit...1 params

Find organizations that the user has access to in Sentry. Use this tool when you need to: - View organizations in Sentry - Find an organization's slug to aid other tool requests - Search for specific organizations by name or slug Returns up to 25 results. If you hit this limit...

Parameters* required

queryvalue

Search query to filter results by name or slug. Use this to narrow down results when there are many items.

find_teamsFind teams in an organization in Sentry. Use this tool when you need to: - View teams in a Sentry organization - Find a team's slug to aid other tool requests - Search for specific teams by name or slug Returns up to 25 results. If you hit this limit, use the query parameter t...3 params

Find teams in an organization in Sentry. Use this tool when you need to: - View teams in a Sentry organization - Find a team's slug to aid other tool requests - Search for specific teams by name or slug Returns up to 25 results. If you hit this limit, use the query parameter t...

Parameters* required

organizationSlugstring

The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool.

queryvalue

Search query to filter results by name or slug. Use this to narrow down results when there are many items.

regionUrlvalue

The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry...

find_projectsFind projects in Sentry. Use this tool when you need to: - View projects in a Sentry organization - Find a project's slug to aid other tool requests - Search for specific projects by name or slug Returns up to 25 results. If you hit this limit, use the query parameter to narro...3 params

Find projects in Sentry. Use this tool when you need to: - View projects in a Sentry organization - Find a project's slug to aid other tool requests - Search for specific projects by name or slug Returns up to 25 results. If you hit this limit, use the query parameter to narro...

Parameters* required

organizationSlugstring

The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool.

queryvalue

Search query to filter results by name or slug. Use this to narrow down results when there are many items.

regionUrlvalue

The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry...

find_releasesFind releases in Sentry. Use this tool when you need to: - Find recent releases in a Sentry organization - Find the most recent version released of a specific project - Determine when a release was deployed to an environment <examples> ### Find the most recent releases in the...4 params

Find releases in Sentry. Use this tool when you need to: - Find recent releases in a Sentry organization - Find the most recent version released of a specific project - Determine when a release was deployed to an environment <examples> ### Find the most recent releases in the...

Parameters* required

organizationSlugstring

The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool.

projectSlugvalue

The project's slug. This will default to all projects you have access to. It is encouraged to specify this when possible.

queryvalue

Search for versions which contain the provided string.

regionUrlvalue

The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry...

get_issue_detailsGet detailed information about a specific Sentry issue by ID. USE THIS TOOL WHEN USERS: - Provide a specific issue ID (e.g., 'CLOUDFLARE-MCP-41', 'PROJECT-123') - Ask to 'explain [ISSUE-ID]', 'tell me about [ISSUE-ID]' - Want details/stacktrace/analysis for a known issue - Pro...5 params

Get detailed information about a specific Sentry issue by ID. USE THIS TOOL WHEN USERS: - Provide a specific issue ID (e.g., 'CLOUDFLARE-MCP-41', 'PROJECT-123') - Ask to 'explain [ISSUE-ID]', 'tell me about [ISSUE-ID]' - Want details/stacktrace/analysis for a known issue - Pro...

Parameters* required

eventIdstring

The ID of the event.

issueIdstring

The Issue ID. e.g. `PROJECT-1Z43`

issueUrlstring

The URL of the issue. e.g. https://my-organization.sentry.io/issues/PROJECT-1Z43

organizationSlugstring

The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool.

regionUrlvalue

The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry...

get_trace_detailsGet detailed information about a specific Sentry trace by ID. USE THIS TOOL WHEN USERS: - Provide a specific trace ID (e.g., 'a4d1aae7216b47ff8117cf4e09ce9d0a') - Ask to 'show me trace [TRACE-ID]', 'explain trace [TRACE-ID]' - Want high-level overview and link to view trace de...3 params

Get detailed information about a specific Sentry trace by ID. USE THIS TOOL WHEN USERS: - Provide a specific trace ID (e.g., 'a4d1aae7216b47ff8117cf4e09ce9d0a') - Ask to 'show me trace [TRACE-ID]', 'explain trace [TRACE-ID]' - Want high-level overview and link to view trace de...

Parameters* required

organizationSlugstring

The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool.

regionUrlvalue

The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry...

traceIdstring

The trace ID. e.g. `a4d1aae7216b47ff8117cf4e09ce9d0a`

get_event_attachmentDownload attachments from a Sentry event. Use this tool when you need to: - Download files attached to a specific event - Access screenshots, log files, or other attachments uploaded with an error report - Retrieve attachment metadata and download URLs <examples> ### Download...5 params

Download attachments from a Sentry event. Use this tool when you need to: - Download files attached to a specific event - Access screenshots, log files, or other attachments uploaded with an error report - Retrieve attachment metadata and download URLs <examples> ### Download...

Parameters* required

attachmentIdvalue

The ID of the attachment to download.

eventIdstring

The ID of the event.

organizationSlugstring

The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool.

projectSlugstring

The project's slug. You can find a list of existing projects in an organization using the `find_projects()` tool.

regionUrlvalue

The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry...

update_issueUpdate an issue's status or assignment in Sentry. This allows you to resolve, ignore, or reassign issues. Use this tool when you need to: - Resolve an issue that has been fixed - Assign an issue to a team member or team for investigation - Mark an issue as ignored to reduce no...6 params

Update an issue's status or assignment in Sentry. This allows you to resolve, ignore, or reassign issues. Use this tool when you need to: - Resolve an issue that has been fixed - Assign an issue to a team member or team for investigation - Mark an issue as ignored to reduce no...

Parameters* required

assignedTostring

The assignee in format 'user:ID' or 'team:ID' where ID is numeric. Example: 'user:123456' or 'team:789'. Use the whoami tool to find your user ID.

issueIdstring

The Issue ID. e.g. `PROJECT-1Z43`

issueUrlstring

The URL of the issue. e.g. https://my-organization.sentry.io/issues/PROJECT-1Z43

organizationSlugstring

The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool.

regionUrlvalue

The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry...

statusstring

The new status for the issue. Valid values are 'resolved', 'resolvedInNextRelease', 'unresolved', and 'ignored'.one of resolved · resolvedInNextRelease · unresolved · ignored

search_eventsSearch for events AND perform counts/aggregations - the ONLY tool for statistics and counts. Supports TWO query types: 1. AGGREGATIONS (counts, sums, averages): 'how many errors', 'count of issues', 'total tokens' 2. Individual events with timestamps: 'show me error logs from...6 params

Search for events AND perform counts/aggregations - the ONLY tool for statistics and counts. Supports TWO query types: 1. AGGREGATIONS (counts, sums, averages): 'how many errors', 'count of issues', 'total tokens' 2. Individual events with timestamps: 'show me error logs from...

Parameters* required

includeExplanationboolean

Include explanation of how the query was translateddefault: false

limitnumber

Maximum number of results to returndefault: 10

naturalLanguageQuerystring

Natural language description of what you want to search for

organizationSlugstring

The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool.

projectSlugvalue

The project's slug. You can find a list of existing projects in an organization using the `find_projects()` tool.

regionUrlvalue

The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry...

create_teamCreate a new team in Sentry. USE THIS TOOL WHEN USERS WANT TO: - 'Create a new team' - 'Set up a team called [X]' - 'I need a team for my project' Be careful when using this tool! <examples> ### Create a new team ``` create_team(organizationSlug='my-organization', name='the-go...3 params

Create a new team in Sentry. USE THIS TOOL WHEN USERS WANT TO: - 'Create a new team' - 'Set up a team called [X]' - 'I need a team for my project' Be careful when using this tool! <examples> ### Create a new team ``` create_team(organizationSlug='my-organization', name='the-go...

Parameters* required

namestring

The name of the team to create.

organizationSlugstring

The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool.

regionUrlvalue

The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry...

create_projectCreate a new project in Sentry (includes DSN automatically). USE THIS TOOL WHEN USERS WANT TO: - 'Create a new project' - 'Set up a project for [app/service] with team [X]' - 'I need a new Sentry project' - Create project AND need DSN in one step DO NOT USE create_dsn after th...5 params

Create a new project in Sentry (includes DSN automatically). USE THIS TOOL WHEN USERS WANT TO: - 'Create a new project' - 'Set up a project for [app/service] with team [X]' - 'I need a new Sentry project' - Create project AND need DSN in one step DO NOT USE create_dsn after th...

Parameters* required

namestring

The name of the project to create. Typically this is commonly the name of the repository or service. It is only used as a visual label in Sentry.

organizationSlugstring

The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool.

platformvalue

The platform for the project. e.g., python, javascript, react, etc.

regionUrlvalue

The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry...

teamSlugstring

The team's slug. You can find a list of existing teams in an organization using the `find_teams()` tool.

update_projectUpdate project settings in Sentry, such as name, slug, platform, and team assignment. Be careful when using this tool! Use this tool when you need to: - Update a project's name or slug to fix onboarding mistakes - Change the platform assigned to a project - Update team assignm...7 params

Update project settings in Sentry, such as name, slug, platform, and team assignment. Be careful when using this tool! Use this tool when you need to: - Update a project's name or slug to fix onboarding mistakes - Change the platform assigned to a project - Update team assignm...

Parameters* required

namevalue

The new name for the project

organizationSlugstring

The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool.

platformvalue

The platform for the project. e.g., python, javascript, react, etc.

projectSlugstring

The project's slug. You can find a list of existing projects in an organization using the `find_projects()` tool.

regionUrlvalue

The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry...

slugvalue

The new slug for the project (must be unique)

teamSlugvalue

The team to assign this project to. Note: this will replace the current team assignment.

create_dsnCreate an additional DSN for an EXISTING project. USE THIS TOOL WHEN: - Project already exists and needs additional DSN - 'Create another DSN for project X' - 'I need a production DSN for existing project' DO NOT USE for new projects (use create_project instead) Be careful whe...4 params

Create an additional DSN for an EXISTING project. USE THIS TOOL WHEN: - Project already exists and needs additional DSN - 'Create another DSN for project X' - 'I need a production DSN for existing project' DO NOT USE for new projects (use create_project instead) Be careful whe...

Parameters* required

namestring

The name of the DSN to create, for example 'Production'.

organizationSlugstring

The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool.

projectSlugstring

The project's slug. You can find a list of existing projects in an organization using the `find_projects()` tool.

regionUrlvalue

The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry...

find_dsnsList all Sentry DSNs for a specific project. Use this tool when you need to: - Retrieve a SENTRY_DSN for a specific project <hints> - If the user passes a parameter in the form of name/otherName, its likely in the format of <organizationSlug>/<projectSlug>. - If only one param...3 params

List all Sentry DSNs for a specific project. Use this tool when you need to: - Retrieve a SENTRY_DSN for a specific project <hints> - If the user passes a parameter in the form of name/otherName, its likely in the format of <organizationSlug>/<projectSlug>. - If only one param...

Parameters* required

organizationSlugstring

The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool.

projectSlugstring

The project's slug. You can find a list of existing projects in an organization using the `find_projects()` tool.

regionUrlvalue

The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry...

analyze_issue_with_seerUse Seer to analyze production errors and get detailed root cause analysis with specific code fixes. Use this tool when you need: - Detailed AI-powered root cause analysis - Specific code fixes and implementation guidance - Step-by-step troubleshooting for complex issues - Und...5 params

Use Seer to analyze production errors and get detailed root cause analysis with specific code fixes. Use this tool when you need: - Detailed AI-powered root cause analysis - Specific code fixes and implementation guidance - Step-by-step troubleshooting for complex issues - Und...

Parameters* required

instructionstring

Optional custom instruction for the AI analysis

issueIdstring

The Issue ID. e.g. `PROJECT-1Z43`

issueUrlstring

The URL of the issue. e.g. https://my-organization.sentry.io/issues/PROJECT-1Z43

organizationSlugstring

The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool.

regionUrlvalue

The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry...

search_docsSearch Sentry documentation for SDK setup, instrumentation, and configuration guidance. Use this tool when you need to: - Set up Sentry SDK or framework integrations (Django, Flask, Express, Next.js, etc.) - Configure features like performance monitoring, error sampling, or re...3 params

Search Sentry documentation for SDK setup, instrumentation, and configuration guidance. Use this tool when you need to: - Set up Sentry SDK or framework integrations (Django, Flask, Express, Next.js, etc.) - Configure features like performance monitoring, error sampling, or re...

Parameters* required

guidevalue

Optional guide filter to limit search results to specific documentation sections. Use either a platform (e.g., 'javascript', 'python') or platform/guide combination (e.g., 'javascript/nextjs', 'pyt...

maxResultsinteger

Maximum number of results to return (1-10)default: 3

querystring

The search query in natural language. Be specific about what you're looking for.

get_docFetch the full markdown content of a Sentry documentation page. Use this tool when you need to: - Read the complete documentation for a specific topic - Get detailed implementation examples or code snippets - Access the full context of a documentation page - Extract specific s...1 params

Fetch the full markdown content of a Sentry documentation page. Use this tool when you need to: - Read the complete documentation for a specific topic - Get detailed implementation examples or code snippets - Access the full context of a documentation page - Extract specific s...

Parameters* required

pathstring

The documentation path (e.g., '/platforms/javascript/guides/nextjs.md'). Get this from search_docs results.

search_issuesSearch for grouped issues/problems in Sentry - returns a LIST of issues, NOT counts or aggregations. Uses AI to translate natural language queries into Sentry issue search syntax. Returns grouped issues with metadata like title, status, and user count. USE THIS TOOL WHEN USERS...6 params

Search for grouped issues/problems in Sentry - returns a LIST of issues, NOT counts or aggregations. Uses AI to translate natural language queries into Sentry issue search syntax. Returns grouped issues with metadata like title, status, and user count. USE THIS TOOL WHEN USERS...

Parameters* required

includeExplanationboolean

Include explanation of how the query was translateddefault: false

limitnumber

Maximum number of issues to returndefault: 10

naturalLanguageQuerystring

Natural language description of issues to search for

organizationSlugstring

The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool.

projectSlugOrIdvalue

The project's slug or numeric ID (optional)

regionUrlvalue

The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry...

Configuration

SENTRY_AUTH_TOKENsecret

Sentry auth token. Optional after `npx -y @sentry/mcp-server auth login`.

SENTRY_HOST

Self-hosted Sentry hostname or URL. Takes precedence over SENTRY_URL. Defaults to sentry.io.

SENTRY_URL

Self-hosted Sentry URL, such as https://sentry.example.com. Defaults to sentry.io.

Readme

Sentry Toolkit

This repository contains the Sentry CLI, the Sentry MCP server, and shared packages. For the CLI, see the CLI guide and the published documentation at https://cli.sentry.dev/. The documentation index covers both products and shared contributor guidance.

The independent Docs MCP Worker provides documentation search and AI-generated answers backed by docs.sentry.io.

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

View the full README on GitHub

Details

Repository: github.com/getsentry/toolkit
Website: mcp.sentry.dev
Categories: Developer Tools, Monitoring & Observability
Package: @sentry/mcp-server
Transport: STDIO, HTTP
Auth: Required
Registry: MCP registry, active

Related Developer Tools MCP servers

View all

Filesystemmark3labs/mcp-filesystem-serverGo server implementing Model Context Protocol (MCP) for filesystem operations.640stars

Linearjerhadf/linear-mcp-serverA server that integrates Linear's project management system with the Model Context Protocol (MCP) to allow LLMs to interact with Linear.344stars

Mcpsnyk/studio-mcpEasily find and fix security issues in your applications leveraging Snyk platform capabilities.0stars

GitLab MCP Serverjmrplens/gitlab-mcp-serverGo MCP server for GitLab: 2 dynamic tools reach ~876 actions on Free/CE, up to ~1103 on Ultimate.47stars

Git Coureralejandro-m-p/git-courerFull git MCP server for LLM agents — 17 tools, AST annotator, auto-backups, real plumbing.32stars

Filesystem MCPj0hanz/filesystem-mcpFilesystem MCP server for AI assistants.32stars

Sentry

Tools

Configuration

Readme

Sentry Toolkit

Sentry MCP

Getting Started

Details

More from getsentry

Related Developer Tools MCP servers