@maxentr/sentry-selfhosted-mcp

A Model Context Protocol (MCP) server for interacting with self-hosted Sentry instances.

Installation

Via npx (recommended)

No installation needed. Add to your MCP client config:

{
  "mcpServers": {
    "sentry": {
      "command": "npx",
      "args": ["-y", "@maxentr/sentry-selfhosted-mcp"],
      "env": {
        "SENTRY_URL": "https://sentry.example.com",
        "SENTRY_AUTH_TOKEN": "your-token",
        "SENTRY_ORG_SLUG": "your-org"
      }
    }
  }
}

From source

git clone https://github.com/maxentr/sentry-selfhosted-mcp.git
cd sentry-selfhosted-mcp
pnpm install
pnpm build

Then reference the built file in your MCP config:

{
  "mcpServers": {
    "sentry": {
      "command": "node",
      "args": ["/path/to/sentry-selfhosted-mcp/build/index.js"],
      "env": {
        "SENTRY_URL": "https://sentry.example.com",
        "SENTRY_AUTH_TOKEN": "your-token",
        "SENTRY_ORG_SLUG": "your-org"
      }
    }
  }
}

Configuration

| Environment Variable | Required | Description | |---|---|---| | SENTRY_URL | Yes | Base URL of your self-hosted Sentry instance | | SENTRY_AUTH_TOKEN | Yes | API auth token (scopes: issue:read, project:read, event:read, issue:write, comment:write) | | SENTRY_ORG_SLUG | Yes | Organization slug |

Available Tools

| Tool | Description | |---|---| | get_sentry_issue | Retrieve issue details by ID or URL, with filtering and stack trace truncation | | list_sentry_projects | List all projects in the organization | | list_sentry_issues | List issues for a project with query/status filters and pagination | | get_sentry_event_details | Retrieve event details with smart entry prioritization and pagination | | update_sentry_issue_status | Update issue status (resolved/ignored/unresolved) | | create_sentry_issue_comment | Add a comment to an issue | | raw_sentry_api | Raw GET requests to any Sentry API endpoint with grep filtering | | get_stack_frames | Extract structured stack trace frames from an event | | check_dsym_status | Check for missing dSYM/debug symbols in iOS/macOS crashes |