Sentry MCP

1# sentry-mcp
2 
3[![Crates.io](https://img.shields.io/crates/v/sentry-mcp.svg)](https://crates.io/crates/sentry-mcp)
4[![codecov](https://codecov.io/gh/utapyngo/sentry-mcp-rs/branch/master/graph/badge.svg)](https://codecov.io/gh/utapyngo/sentry-mcp-rs)
5[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
6 
7A fast, lightweight [MCP](https://modelcontextprotocol.io/) server for Sentry, written in Rust.
8 
9## Why sentry-mcp?
10 
11Compared to the [official Node.js server](https://www.npmjs.com/package/@sentry/mcp-server):
12 
13- **Memory:** 10x less RAM usage
14- **Startup:** instant cold start
15- **Disk:** single binary, no runtime dependencies
16- **Tokens:** fewer tools = smaller tool list in context
17 
18## Features
19 
20This MCP server provides tools to interact with Sentry's API:
21 
22- **get_issue_details** - Retrieve detailed information about a Sentry issue including metadata, tags, stacktraces, and optionally a specific event
23- **get_trace_details** - Retrieve trace details including span tree and timing information for distributed tracing analysis
24- **search_issue_events** - Search events within an issue using Sentry's query syntax
25 
26## Installation
27 
28From crates.io:
29 
30```bash
31cargo install sentry-mcp
32```
33 
34From GitHub:
35 
36```bash
37cargo install --git https://github.com/utapyngo/sentry-mcp-rs.git
38```
39 
40Or with [mise](https://mise.jdx.dev/):
41 
42```bash
43mise use -g github:utapyngo/sentry-mcp-rs
44```
45 
46The binary will be installed as `sentry-mcp`.
47 
48## Configuration
49 
50Required environment variables:
51- `SENTRY_AUTH_TOKEN` - Your Sentry API authentication token
52- `SENTRY_HOST` - Your Sentry instance hostname (e.g., `sentry.io`)
53 
54Optional:
55- `SOCKS_PROXY` - SOCKS5 proxy URL (e.g., `socks5://127.0.0.1:1080`)
56- `HTTPS_PROXY` - HTTPS proxy URL
57 
58## MCP Client Configuration
59 
60Add to your MCP client configuration:
61 
62```json
63{
64  "mcpServers": {
65    "sentry": {
66      "command": "sentry-mcp",
67      "env": {
68        "SENTRY_AUTH_TOKEN": "your_token_here",
69        "SENTRY_HOST": "sentry.io"
70      }
71    }
72  }
73}
74```
75 
76Or without installation using mise:
77 
78```json
79{
80  "mcpServers": {
81    "sentry": {
82      "command": "mise",
83      "args": ["x", "github:utapyngo/sentry-mcp-rs", "--", "sentry-mcp"],
84      "env": {
85        "SENTRY_AUTH_TOKEN": "your_token_here",
86        "SENTRY_HOST": "sentry.io"
87      }
88    }
89  }
90}
91```
92 
93## Development
94 
95Clone the repository and create a `.env` file:
96 
97```bash
98git clone https://github.com/utapyngo/sentry-mcp-rs.git
99cd sentry-mcp-rs
100cp .env.example .env
101# Edit .env with your credentials
102```
103 
104Build and test with MCP Inspector:
105 
106```bash
107cargo build --release
108npx @modelcontextprotocol/inspector ./run.sh
109```
110 
111Or configure MCP client to use the script:
112 
113```json
114{
115  "mcpServers": {
116    "sentry": {
117      "command": "/path/to/sentry-mcp-rs/run.sh"
118    }
119  }
120}
121```
122 
123## Tools
124 
125### get_issue_details
126 
127Retrieve detailed information about a specific Sentry issue.
128 
129**Parameters:**
130- `issue_url` - Full Sentry issue URL (alternative to the parameters below)
131- `organization_slug` - Organization slug (required if `issue_url` not provided)
132- `issue_id` - Issue ID like `PROJECT-123` or numeric ID (required if `issue_url` not provided)
133- `event_id` - Specific event ID to fetch instead of latest (optional)
134 
135### get_trace_details
136 
137Retrieve trace details for distributed tracing analysis.
138 
139**Parameters:**
140- `organization_slug` - Organization slug
141- `trace_id` - 32-character hex trace ID
142 
143### search_issue_events
144 
145Search events within an issue using Sentry's query syntax.
146 
147**Parameters:**
148- `organization_slug` - Organization slug
149- `issue_id` - Issue ID (e.g., `PROJECT-123`)
150- `query` - Optional Sentry search query
151- `limit` - Maximum events to return (default: 10, max: 100)
152- `sort` - Sort order: `newest` (default) or `oldest`
153