MCP SERVER · DEVELOPER OPERATIONS

Sentry MCP Server

Real-time exception tracking, unresolved issue triage, stack trace inspection, and telemetry breadcrumbs.

FSL-1.1Verified OfficialTransport: STDIOAuth: API Key
Alternative to:
Verified: v1.0.0 · Today · Markly Editorial Desk
Claude Desktop — Sentry MCP Server
STDIO & SSE
LLM CLIENTClaude Desktop / Cursor
STDIO & SSE JSON-RPC 2.0
MCP DAEMONSentry MCP Server
EXPOSED TOOLS & PRIMITIVES:
sentry.unresolved()sentry.detailed()sentry.user()
Active Connection · Read-only Sandbox · Zero Cloud Relays
01 / Summary

What it does & operational scope

Sentry MCP Server connects developer assistants directly to live application monitoring data. Supported through both local stdio and hosted SSE endpoints at sentry.dev, it allows agents to search recent unresolved issues, inspect full stack traces with local variable state, review user telemetry breadcrumbs, and identify regression releases without leaving the code editor.

✦ DIRECT ANSWERCITABLE DEFINITION

Sentry MCP Server is an open-source Model Context Protocol server developed by Sentry under FSL-1.1 that connects AI code editors directly to production error stack traces and breadcrumb telemetry.

✓ Use it if

Your AI coding agent requires live access to Sentry tools and resources over local IPC or streamable transport.

✕ Skip it if

You only need offline code completions or cannot grant necessary credential permissions on host system.

02 / Install & Connect

Client configuration & wire setup

Prerequisites: Node.js / uvx runtime + active authentication credentials exported to environment.

claude_desktop_config.json
JSON8 lines
{
"mcpServers": {
"sentry": {
"command": "npx",
"args": ["-y", "@sentry/mcp-server@latest", "--access-token=<SENTRY_ACCESS_TOKEN>"]
}
}
}
03 / Capabilities

Exposed tool endpoints & primitives

Discovered MCP Tools

3 Tools Ready
list_issues🟢 Read-Only (Safe)

Retrieve unresolved production error issues sorted by event frequency

get_issue_details🟢 Read-Only (Safe)

Read full stack trace, exception type, and client breadcrumb records

list_project_events🟢 Read-Only (Safe)

Query recent runtime exception events across production deployments

04 / Permissions & Security

Scopes, secret storage, and sandbox boundaries

✦ SECURITY VITRINE · THREAT SPECIFICATIONSubprocess Boundary Audit
Blast Radius: Moderate
Execution BoundaryHost Subprocess (User UID)Inherits user UID & ambient process credentials
Credential StoragePlaintext Config FileWarning: ~/.config/Claude JSON unencrypted
Row-Level Security (RLS)Isolated / Not ApplicableRestricted schema permissions enforced
Threat Severity
Moderate Impact
Audit rating before agent prompt injection
Mandatory Sandboxing Policy & Least Privilege Directive:
Limit Sentry user token permissions to read:org and read:issues. Do not grant admin or project modification scopes.
05 / Example Workflows

Real conversational prompts & expected tool calls

Workflow 01User Prompt
💬 "Find latest technical updates for Sentry MCP Server from the last 7 days"
Dispatched Tool Invocation:
list_issues({ query: "Sentry MCP Server updates", limit: 5 })
Verified Model Return:

Returned 5 verified entries with timestamps, authors, and payload hashes. Zero data loss.

Workflow 02User Prompt
💬 "Inspect status and health boundaries for Sentry MCP Server"
Dispatched Tool Invocation:
list_issues_status({ verbose: true })
Verified Model Return:

Status: 200 OK. Transport: STDIO IPC. Active connections: 1. Blast radius: Safe.

06 / Operational Troubleshooting

Common error codes and recommended resolutions

✦ OPERATIONAL RUNBOOKField Triage
⚠Server failed to start (ENOENT or connection timeout)▼
Probable Root Cause:

Client process cannot resolve Node/Python binary on host system PATH.

Recommended Fix:

Provide full absolute path to the binary in your client config (e.g. "/opt/homebrew/bin/node" or "C:\\Program Files\\nodejs\\node.exe").

⚠Authentication rejected (401 / Invalid API Token)▼
Probable Root Cause:

Missing or expired environment variable in client config.

Recommended Fix:

Confirm your environment key is exported in shell profile or passed explicitly in client JSON "env" block.

⚠Windows path escaping syntax error▼
Probable Root Cause:

Unescaped single backslashes in JSON configuration files.

Recommended Fix:

Use forward slashes or double backslashes in path strings (e.g., "C:/Users/name/.env" or "C:\\Users\\name").

07 / Pros & Cons

Technical trade-offs and operational friction

✓ Strong Marks

+ Pulls real production crash context directly into IDE prompts for instant bug reproduction.

+ Includes local variable dumps and breadcrumb trails that pinpoint exact failures.

+ Official implementation maintained directly by the Sentry engineering team.

✕ Watch For

− Unsanitized exception frames and HTTP request payloads can leak sensitive environment variables, auth tokens, or customer PII directly into LLM prompts.

− Strict API rate limits on enterprise Sentry organizations can throttle autonomous agents querying high-frequency incident bursts.

08 / Alternatives & Battleground

Side-by-side rival comparisons

Compare Sentry MCP Server vs GitHub MCP Server across transport protocols and exposed tools.

Enter Showdown
09 / Sources & Changelog

JSON-RPC 2.0 wire trace & receipts

Inspect Raw JSON-RPC 2.0 Wire PacketIPC TELEMETRY
✦ JSON-RPC 2.0 WIRE PROTOCOL SPECIMEN
Claude Desktop [Client]──stdio pipe──▶Sentry MCP Server [Daemon]
method: "tools/call"
1{
2 "jsonrpc": "2.0",
3 "id": 21,
4 "method": "tools/call",
5 "params": {
6 "name": "get_issue",
7 "arguments": {
8 "issue_id": "109283401"
9 }
10 }
11}
IPC TransportSTDIO (POSIX Pipe)
Round-Trip Latency64ms
Wire Payload410 bytes
Protocol FramingNewline Delimited (\n)