Fire in da houseTop Tip:Paying $100+ per month for Perplexity, MidJourney, Runway, ChatGPT is crazy - get all your AI tools in one site starting at $15 per month with Galaxy AIFire in da houseCheck it out free

sentry-mcp-stdio

MCP.Pizza Chef: getsentry

The sentry-mcp-stdio is a Model Context Protocol (MCP) server designed to interface with Sentry's API. It enables AI assistants to retrieve, analyze, and manage error reports, project data, and application performance metrics from Sentry. Primarily educational, it has been largely superseded by the more feature-rich Sentry Remote-MCP Server but remains useful for standalone MCP server implementations and learning purposes. It supports integration with IDEs and AI clients like Cursor, Codeium Windsurf, and Claude Desktop.

Use This MCP server To

Retrieve and analyze Sentry error reports via AI Manage Sentry projects through AI-driven commands Monitor application performance metrics from Sentry Integrate Sentry data into AI-assisted debugging workflows Enable AI to query Sentry API for real-time error insights Use within IDEs for contextual error analysis Automate incident summaries from Sentry logs

README

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

  1. 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 args field.
  • 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 from
  • view (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 to
  • short_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 ID
  • event_id (string, required): The specific event ID to retrieve
  • view (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 to
  • project_slug (string, required): The slug of the project to list events from
  • view (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 in
  • team_slug (string, required): The slug of the team to assign the project to
  • name (string, required): The name of the new project
  • platform (string, optional): The platform for the new project
  • view (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 to
  • project_slug (string, required): The slug of the project to list issues from
  • view (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 to
  • issue_id (string, required): The ID of the issue to list events from
  • view (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 ID
  • view (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 from
  • project_ids (string[], optional): List of project IDs to filter replays by
  • environment (string, optional): Environment to filter replays by
  • stats_period (string, optional): Time period for stats (e.g., "24h", "7d")
  • start (string, optional): Start date for filtering replays
  • end (string, optional): End date for filtering replays
  • sort (string, optional): Field to sort replays by
  • query (string, optional): Search query to filter replays
  • per_page (number, optional): Number of replays per page
  • cursor (string, optional): Cursor for pagination
  • view (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.

sentry-mcp-stdio FAQ

How do I set up sentry-mcp-stdio?
Install Node.js v14+, then run npm install to install dependencies, and configure with your Sentry API token.
Can sentry-mcp-stdio be used with popular AI clients?
Yes, it works with Cursor, Codeium Windsurf, and Claude Desktop.
Is sentry-mcp-stdio the latest Sentry MCP server?
No, it has been largely superseded by the Sentry Remote-MCP Server which offers more features like authentication and better tooling.
What permissions are required for the Sentry token?
The token must have API access with permissions to read error data and manage projects.
Can I use sentry-mcp-stdio outside of IDEs?
Yes, but it is optimized for integration within IDEs and AI clients for enhanced developer workflows.
Does sentry-mcp-stdio support real-time error monitoring?
It allows querying Sentry for current error and performance data but is not a real-time streaming server.
Is sentry-mcp-stdio open source?
Yes, it is available on GitHub for educational and development use.
What Node.js versions are supported?
Node.js version 14 or higher is required to run sentry-mcp-stdio.