sentry-self-hosted-mcp
Provides tools for interacting with a self-hosted Sentry instance, enabling AI agents to list projects, manage issues, and retrieve events and stack traces.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@sentry-self-hosted-mcp list recent issues in my-org"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
sentry-self-hosted-mcp
MCP (Model Context Protocol) server for integrating self-hosted Sentry with AI assistants — Cursor, Claude Desktop, and any other MCP-compatible clients.
Tools
Tool | Description |
| List all projects in the organization |
| List issues with filtering by project, status, and level |
| Issue details by numeric ID or short ID (e.g. |
| Issue metadata + latest event stacktrace in a single call |
| Latest event for an issue |
| Specific event by project slug and event ID |
| Stack frames for an event, with an option to show only in-app frames |
Related MCP server: Sentry MCP Server
Requirements
Node.js 18+
Self-hosted Sentry instance with API access
Auth token with
org:read,project:read,event:readscopes
Installation
npm install
npm run buildConfiguration
The server reads three environment variables:
Variable | Description | Example |
| Your Sentry URL |
|
| Auth token |
|
| Organization slug |
|
Tokens are created in Settings → Auth Tokens in Sentry.
Connecting to Cursor
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"sentry-selfhosted": {
"command": "npx",
"args": ["@vitaliypanait/sentry-self-hosted-mcp"],
"env": {
"SENTRY_HOST": "https://sentry.example.com",
"SENTRY_TOKEN": "sntrys_...",
"SENTRY_ORG_SLUG": "my-org"
}
}
}
}Local development alternative (if running from a cloned repo):
{
"mcpServers": {
"sentry-selfhosted": {
"command": "node",
"args": ["/absolute/path/to/sentry-mcp/dist/index.js"],
"env": {
"SENTRY_HOST": "https://sentry.example.com",
"SENTRY_TOKEN": "sntrys_...",
"SENTRY_ORG_SLUG": "my-org"
}
}
}
}Connecting to Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"sentry-selfhosted": {
"command": "npx",
"args": ["@vitaliypanait/sentry-self-hosted-mcp"],
"env": {
"SENTRY_HOST": "https://sentry.example.com",
"SENTRY_TOKEN": "sntrys_...",
"SENTRY_ORG_SLUG": "my-org"
}
}
}
}Cursor Rule
To make Cursor automatically fetch Sentry context when you mention an issue or ask about a bug, add a rule to your project.
Copy examples/cursor-rule.mdc into your project as .cursor/rules/sentry.mdc.
With alwaysApply: false the rule activates only when relevant (recommended). Change to alwaysApply: true to apply it to every request in the project.
Development
# Run the compiler in watch mode
npm run dev
# Type check
npx tsc --noEmitStack
Available Tools
7 toolsget_eventA
Get detailed information about a specific Sentry event by project slug and event ID. Returns exception details, stacktrace, tags, and context.
Inputs: event_id (required), project_slug (required).
get_issueB
Get information about a Sentry issue by its numeric ID or short ID (e.g. "PAYOUT-123"). Includes status, event count, first/last seen.
Inputs: issue_id (required).
get_issue_with_stacktraceB
Get issue metadata and latest event stacktrace in a single call.
Inputs: issue_id (required).
get_latest_eventB
Get the latest event for a Sentry issue.
Inputs: issue_id (required).
get_stack_framesA
Extract and format stack frames from a Sentry event. Useful for quickly seeing the call chain without full event details.
Inputs: event_id (required), project_slug (required), in_app_only.
list_issuesB
List Sentry issues with optional filters. Supports search queries like "is:unresolved", "level:error", etc.
Inputs: limit, query, project_slug.
list_projectsA
List all Sentry projects in the organization.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Most tools have distinct purposes: list vs. get, issue vs. event vs. stacktrace. Some minor overlap exists between get_event and get_stack_frames, as both return stacktrace data, but they are differentiated by level of detail and formatting.
All tool names follow a consistent verb_noun pattern using snake_case. The 'get_' and 'list_' prefixes clearly indicate action type, and resource names are used uniformly across the set.
With 7 tools, the server is well-scoped for a read-only Sentry debugging workflow. Each tool provides a meaningful view into issues and events without unnecessary bloat or redundancy.
The tool surface covers exploration and retrieval well, including issues, events, stacktraces, and projects. However, it lacks any mutating operations (e.g., updating issue status, resolving issues) and has no way to list all events for an issue, which could create dead ends in a complete debugging workflow.
Maintenance
Related MCP Connectors
MCP server for Sentry - error monitoring, issue tracking, and debugging for AI assistants
Enable secure connectivity between Sentry issues and debugging data, and LLM clients, using a Model Context Protocol (MCP) server.
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
- FlicenseBqualityDmaintenanceA Model Context Protocol server that retrieves and analyzes Sentry.io issues, allowing users to inspect error reports, stacktraces, and debugging information from their Sentry account.223-
- AlicenseBqualityFmaintenanceA Model Context Protocol server that enables AI assistants to interact with Sentry for error tracking and monitoring, allowing retrieval and analysis of error data, project management, and performance monitoring through the Sentry API.1121ISC
- FlicenseNot gradedqualityDmaintenanceAn MCP server that connects to Sentry.io or self-hosted Sentry instances to retrieve and analyze error reports, stack traces, and debugging information.3-

Sentry MCP Serverofficial
AlicenseBqualityDmaintenanceA Model Context Protocol server that lets AI assistants interact with the Sentry API to retrieve and analyze error data, manage projects, and monitor application performance.1112ISC