Sentry MCP Server

A comprehensive Model Context Protocol (MCP) server that provides deep integration with Sentry's error tracking and performance monitoring platform. This server enables AI assistants to search, analyze, and troubleshoot production issues, access detailed error information, query performance data, and navigate Sentry's extensive documentation—all through natural language interactions.

Overview

The Sentry MCP server bridges the gap between conversational AI and production monitoring by providing direct access to your Sentry data. Whether you need to investigate a critical error, analyze performance metrics, find documentation for SDK setup, or get AI-powered root cause analysis, this server offers a complete toolkit for working with Sentry through natural language queries.

Key Features

Natural Language Search: Query issues and events using plain English instead of complex search syntax
AI-Powered Root Cause Analysis: Leverage Sentry's Seer AI to get detailed explanations and code fixes for production errors
Comprehensive Issue Management: Access detailed issue information, traces, events, and attachments
Performance Monitoring: Query spans, traces, and performance metrics across your applications
Documentation Access: Search and retrieve Sentry SDK documentation for any platform or framework
Organization Management: Discover and navigate your Sentry organizations, teams, projects, and releases
Multi-Region Support: Work seamlessly with both Sentry Cloud (including region-specific deployments) and self-hosted installations

Tools

Identity & Discovery

whoami

Identify the currently authenticated user in Sentry. Returns the user's name and email address associated with the API token.

Parameters: None

find_organizations

List all Sentry organizations that the authenticated user has access to. Essential for discovering organization slugs needed for other operations.

Parameters: None

find_teams

Discover teams within a specific Sentry organization. Useful for understanding team structure and finding team slugs for assignment or filtering purposes.

Parameters:

organizationSlug (required): The organization's slug
regionUrl (optional): Region-specific URL for multi-region deployments

find_projects

List all projects within a Sentry organization. Projects are the primary organizational unit in Sentry where errors and performance data are collected.

Parameters:

organizationSlug (required): The organization's slug
regionUrl (optional): Region-specific URL for multi-region deployments

find_releases

Search for releases in a Sentry organization. Find recent deployments, locate specific version numbers, or determine when a release was deployed to an environment.

Parameters:

organizationSlug (required): The organization's slug
query (optional): Search string to filter releases by version
projectSlug (optional): Limit results to a specific project
regionUrl (optional): Region-specific URL for multi-region deployments

find_dsns

Retrieve the Data Source Name (DSN) configuration for a specific project. The DSN is required to configure Sentry SDKs in your applications.

Parameters:

organizationSlug (required): The organization's slug
projectSlug (required): The project's slug
regionUrl (optional): Region-specific URL for multi-region deployments

Issue Investigation

get_issue_details

Fetch comprehensive information about a specific Sentry issue including stack traces, metadata, tags, and occurrence patterns. Use this when you have a specific issue ID or URL and need detailed diagnostic information.

Parameters:

issueUrl (optional): Full URL to the issue in Sentry
organizationSlug (optional): The organization's slug
issueId (optional): Issue identifier (e.g., "PROJECT-123")
eventId (optional): Specific event ID
regionUrl (optional): Region-specific URL for multi-region deployments

search_issues

Search for grouped issues using natural language queries. Returns a list of issues with metadata like title, status, user impact, and assignment. The AI automatically translates your natural language into Sentry's search syntax.

Parameters:

organizationSlug (required): The organization's slug
naturalLanguageQuery (required): Plain English description of what to search for
projectSlugOrId (optional): Limit search to a specific project
limit (optional): Maximum results to return (1-100, default 10)
includeExplanation (optional): Show how the query was translated
regionUrl (optional): Region-specific URL for multi-region deployments

Examples:

"critical bugs from last week"
"unhandled errors affecting 100+ users"
"issues assigned to me"

analyze_issue_with_seer

Use Sentry's Seer AI to perform deep root cause analysis on production errors. Receives detailed explanations, specific code locations, concrete fixes, and step-by-step implementation guidance. The analysis is cached, so subsequent requests return instantly.

Parameters:

issueUrl (optional): Full URL to the issue
organizationSlug (optional): The organization's slug
issueId (optional): Issue identifier
instruction (optional): Custom instruction for the AI analysis
regionUrl (optional): Region-specific URL for multi-region deployments

Event & Performance Analysis

search_events

Search for individual events and perform statistical aggregations. This is the primary tool for querying error logs, performance spans, and computing metrics like counts, averages, and sums. The AI automatically selects the appropriate dataset (errors, logs, or spans) and translates natural language into Sentry's query language.

Parameters:

organizationSlug (required): The organization's slug
naturalLanguageQuery (required): What you want to search for or calculate
projectSlug (optional): Limit to a specific project
limit (optional): Maximum results (1-100, default 10)
includeExplanation (optional): Show query translation details
regionUrl (optional): Region-specific URL for multi-region deployments

Examples:

"how many errors today"
"total tokens used by model"
"error logs from the last hour"
"average response time for API endpoints"

get_trace_details

Retrieve comprehensive information about a distributed trace including span breakdown, timing statistics, and service interactions. Provides a high-level overview with links to view detailed trace visualization in Sentry.

Parameters:

organizationSlug (required): The organization's slug
traceId (required): 32-character hexadecimal trace identifier
regionUrl (optional): Region-specific URL for multi-region deployments

get_event_attachment

Download or list attachments associated with a Sentry event, such as screenshots, log files, or other files uploaded with error reports.

Parameters:

organizationSlug (required): The organization's slug
projectSlug (required): The project's slug
eventId (required): The event identifier
attachmentId (optional): Specific attachment to download; omit to list all
regionUrl (optional): Region-specific URL for multi-region deployments

Documentation

search_docs

Search Sentry's comprehensive technical documentation for SDK setup guides, instrumentation instructions, configuration options, and integration tutorials. Covers all supported platforms and frameworks.

Parameters:

query (required): Search terms (2-200 characters)
guide (optional): Filter to specific platform/framework (e.g., "javascript/nextjs", "python/django")
maxResults (optional): Number of results (1-10, default 3)

Examples:

"Django setup configuration SENTRY_DSN"
"source maps webpack upload"
"release tracking deployment integration"

get_doc

Fetch the complete markdown content of a specific Sentry documentation page. Use paths obtained from search_docs results to retrieve full implementation details and code examples.

Parameters:

path (required): Documentation path (e.g., "/platforms/javascript/guides/nextjs.md")

Resource Templates

sentry-docs-platform

Access platform-specific SDK documentation for any supported Sentry platform.

URI Template: https://docs.sentry.io/platforms/{platform}/

Parameters:

platform: Platform identifier (e.g., "javascript", "python", "java")

sentry-docs-platform-guide

Access integration guides for specific frameworks within a platform.

URI Template: https://docs.sentry.io/platforms/{platform}/guides/{framework}/

Parameters:

platform: Platform identifier
framework: Framework identifier (e.g., "nextjs", "django", "spring-boot")

Prompts

find_errors_in_file

A pre-configured prompt that searches for all errors occurring in a specific file within your codebase. Useful for targeted debugging when you know which file is problematic.

Arguments:

organizationSlug (required): The organization's slug
filename (required): The filename to search for

fix_issue_with_seer

A guided prompt for getting AI-powered fixes for production issues. Automatically invokes Seer analysis and presents actionable remediation steps.

Arguments:

issueUrl (optional): Full URL to the issue
organizationSlug (optional): The organization's slug
issueId (optional): Issue identifier

Use Cases

Incident Response: Quickly investigate production errors by asking "show me critical issues from the last hour" and then diving into specific issues with "analyze this error and tell me how to fix it."

Performance Optimization: Query performance metrics with natural language like "what are the slowest database queries this week" or "show me API endpoints with response times over 2 seconds."

SDK Integration: Get instant access to setup documentation by asking "how do I set up Sentry in Next.js" or "show me Django configuration options."

Team Collaboration: Discover organizational structure, find project DSNs for team members, and track releases across environments.

Root Cause Analysis: Use Seer AI integration to get detailed explanations of complex errors, including specific code fixes and implementation guidance.

Data Privacy & Security

This MCP server communicates directly with Sentry's API using your authentication credentials. All queries respect your Sentry organization's access controls and permissions. No data is stored or transmitted to third parties beyond your Sentry instance.