Note - This has largely been superceded by the Sentry Remote-MCP Server which supports a lot more capabilities (auth, better tooling, etc...). This one exists for educational purposes as a standalone MCP server; but in all likelihood you'll want to use the remote. You can see it live at https://mcp.sentry.dev
Sentry MCP Server
A Model Context Protocol (MCP) server for interacting with Sentry. This MCP server provides tools to interact with the Sentry API, allowing AI assistants to retrieve and analyze error data, manage projects, and monitor application performance.
Requirements
- Node.js (v14 or higher)
- npm or yarn
- Sentry account with API access
- Sentry authentication token with appropriate permissions
Setup
- Install dependencies:
npm install
Using this within an IDE
This MCP has been verified to work against Cursor, Codeium Windsurf, and Claude Desktop.
Using with Claude
To use this MCP server with Claude, add the following configuration to your Claude settings:
{
"mcpServers": {
"sentry": {
"command": "npx",
"args": ["ts-node", "/Users/<your-user-directory>/sentry-mcp-ts/index.ts"],
"env": {
"SENTRY_AUTH": "<YOUR_AUTH_TOKEN>"
}
}
}
}
- Update with your directory path in the
argsfield. - Replace
<YOUR_AUTH_TOKEN>with your Sentry authentication token.
Available Tools
list_projects
Lists all accessible Sentry projects for a given organization.
Parameters:
organization_slug(string, required): The slug of the organization to list projects fromview(string, optional): View type, either "summary" or "detailed" (default: "detailed")format(string, optional): Output format, either "plain" or "markdown" (default: "markdown")
resolve_short_id
Retrieves details about an issue using its short ID.
Parameters:
organization_slug(string, required): The slug of the organization the issue belongs toshort_id(string, required): The short ID of the issue to resolve (e.g., PROJECT-123)format(string, optional): Output format, either "plain" or "markdown" (default: "markdown")
get_sentry_event
Retrieves and analyzes a specific Sentry event from an issue.
Parameters:
issue_id_or_url(string, required): Either a full Sentry issue URL or just the numeric issue IDevent_id(string, required): The specific event ID to retrieveview(string, optional): View type, either "summary" or "detailed" (default: "detailed")format(string, optional): Output format, either "plain" or "markdown" (default: "markdown")
list_error_events_in_project
Lists error events from a specific Sentry project.
Parameters:
organization_slug(string, required): The slug of the organization the project belongs toproject_slug(string, required): The slug of the project to list events fromview(string, optional): View type, either "summary" or "detailed" (default: "detailed")format(string, optional): Output format, either "plain" or "markdown" (default: "markdown")
create_project
Creates a new project in Sentry and retrieves its client keys.
Parameters:
organization_slug(string, required): The slug of the organization to create the project inteam_slug(string, required): The slug of the team to assign the project toname(string, required): The name of the new projectplatform(string, optional): The platform for the new projectview(string, optional): View type, either "summary" or "detailed" (default: "detailed")format(string, optional): Output format, either "plain" or "markdown" (default: "markdown")
list_project_issues
Lists issues from a specific Sentry project.
Parameters:
organization_slug(string, required): The slug of the organization the project belongs toproject_slug(string, required): The slug of the project to list issues fromview(string, optional): View type, either "summary" or "detailed" (default: "detailed")format(string, optional): Output format, either "plain" or "markdown" (default: "markdown")
list_issue_events
Lists events for a specific Sentry issue.
Parameters:
organization_slug(string, required): The slug of the organization the issue belongs toissue_id(string, required): The ID of the issue to list events fromview(string, optional): View type, either "summary" or "detailed" (default: "detailed")format(string, optional): Output format, either "plain" or "markdown" (default: "markdown")
get_sentry_issue
Retrieves and analyzes a Sentry issue.
Parameters:
issue_id_or_url(string, required): Either a full Sentry issue URL or just the numeric issue IDview(string, optional): View type, either "summary" or "detailed" (default: "detailed")format(string, optional): Output format, either "plain" or "markdown" (default: "markdown")
list_organization_replays
Lists replays from a specific Sentry organization.
Parameters:
organization_slug(string, required): The slug of the organization to list replays fromproject_ids(string[], optional): List of project IDs to filter replays byenvironment(string, optional): Environment to filter replays bystats_period(string, optional): Time period for stats (e.g., "24h", "7d")start(string, optional): Start date for filtering replaysend(string, optional): End date for filtering replayssort(string, optional): Field to sort replays byquery(string, optional): Search query to filter replaysper_page(number, optional): Number of replays per pagecursor(string, optional): Cursor for paginationview(string, optional): View type, either "summary" or "detailed" (default: "detailed")format(string, optional): Output format, either "plain" or "markdown" (default: "markdown")
Running the Server
npx ts-node index.ts
Authentication
This tool requires a Sentry authentication token with appropriate permissions to access the Sentry API. You can generate a token in your Sentry account settings under Settings -> User Settings -> Auth Tokens.