sentry-mcp

A fast, lightweight MCP server for Sentry, written in Rust.

Why sentry-mcp?

Compared to the official Node.js server:

Memory: 10x less RAM usage
Startup: instant cold start
Disk: single binary, no runtime dependencies
Tokens: fewer tools = smaller tool list in context

Features

This MCP server provides tools to interact with Sentry's API:

get_issue_details - Retrieve detailed information about a Sentry issue including metadata, tags, stacktraces, and optionally a specific event
get_trace_details - Retrieve trace details including span tree and timing information for distributed tracing analysis
search_issue_events - Search events within an issue using Sentry's query syntax

Installation

From crates.io:

bash

cargo install sentry-mcp

From GitHub:

bash

cargo install --git https://github.com/utapyngo/sentry-mcp-rs.git

Or with mise:

bash

mise use -g github:utapyngo/sentry-mcp-rs

The binary will be installed as sentry-mcp.

Configuration

Required environment variables:

SENTRY_AUTH_TOKEN - Your Sentry API authentication token
SENTRY_HOST - Your Sentry instance hostname (e.g., sentry.io)

Optional:

SOCKS_PROXY - SOCKS5 proxy URL (e.g., socks5://127.0.0.1:1080)
HTTPS_PROXY - HTTPS proxy URL

MCP Client Configuration

Add to your MCP client configuration:

config.json

{
  "mcpServers": {
    "sentry": {
      "command": "sentry-mcp",
      "env": {
        "SENTRY_AUTH_TOKEN": "your_token_here",
        "SENTRY_HOST": "sentry.io"
      }
    }
  }
}

Or without installation using mise:

config.json

{
  "mcpServers": {
    "sentry": {
      "command": "mise",
      "args": ["x", "github:utapyngo/sentry-mcp-rs", "--", "sentry-mcp"],
      "env": {
        "SENTRY_AUTH_TOKEN": "your_token_here",
        "SENTRY_HOST": "sentry.io"
      }
    }
  }
}

Development

Clone the repository and create a .env file:

bash

git clone https://github.com/utapyngo/sentry-mcp-rs.git
cd sentry-mcp-rs
cp .env.example .env
# Edit .env with your credentials

Build and test with MCP Inspector:

bash

cargo build --release
npx @modelcontextprotocol/inspector ./run.sh

Or configure MCP client to use the script:

config.json

{
  "mcpServers": {
    "sentry": {
      "command": "/path/to/sentry-mcp-rs/run.sh"
    }
  }
}

Tools

get_issue_details

Retrieve detailed information about a specific Sentry issue.

Parameters:

issue_url - Full Sentry issue URL (alternative to the parameters below)
organization_slug - Organization slug (required if issue_url not provided)
issue_id - Issue ID like PROJECT-123 or numeric ID (required if issue_url not provided)
event_id - Specific event ID to fetch instead of latest (optional)

get_trace_details

Retrieve trace details for distributed tracing analysis.

Parameters:

organization_slug - Organization slug
trace_id - 32-character hex trace ID

search_issue_events

Search events within an issue using Sentry's query syntax.

Parameters:

organization_slug - Organization slug
issue_id - Issue ID (e.g., PROJECT-123)
query - Optional Sentry search query
limit - Maximum events to return (default: 10, max: 100)
sort - Sort order: newest (default) or oldest