getsentry/sentry-mcp
Project Overview
sentry-mcp
An MCP server that lets AI coding assistants query and interact with the Sentry error-monitoring API.
True Intent (AI Assessment)
An official Sentry MCP server enabling AI coding assistants to query Sentry error data, issues, and traces in real time.
README Accuracy
Notes
README accurately describes the dual transport (remote Cloudflare + local stdio), OAuth flow, and LLM dependency for AI search tools. The FSL-1.1-ALv2 license is noted as NOASSERTION by GitHub but is explicitly declared in package.json files.
This is an official Sentry-built Model Context Protocol (MCP) server that exposes Sentry's error monitoring, issue tracking, and performance data as tools consumable by AI coding assistants. It is deployed as a remote service at mcp.sentry.dev and also supports a local stdio transport via npx.
It solves the problem of AI coding agents lacking direct access to runtime error data, stack traces, and performance issues captured in Sentry. Without this, developers must manually copy-paste Sentry data into their chat context; this server automates that bridge.
Primary users are developers using AI-assisted coding tools (Cursor, Claude Code, VS Code Copilot, etc.) who want their agent to automatically pull Sentry issues, events, and traces when debugging. It is also used by Sentry's own internal automation and CI pipelines via evaluation tests.
The architecture is a pnpm monorepo using Turborepo. The core logic lives in @sentry/mcp-core (tools, API client, skills system). The Cloudflare Workers deployment (@sentry/mcp-cloudflare) handles remote OAuth-backed access and hosts a React UI. The @sentry/mcp-server package handles stdio transport. AI-powered search tools (search_events, search_issues) embed a sub-agent that translates natural language into Sentry query syntax using an external LLM (OpenAI, Anthropic, etc.).
Notable: The project has an unusually sophisticated AI-agent development infrastructure including agent skill definitions, LLM evaluation harnesses (vitest-evals), AST-grep lint rules, and plugin manifests for multiple AI IDEs. The license is FSL-1.1-ALv2 (Functional Source License), not a standard open-source license—commercial use restrictions apply for competing products. The repository version is tagged 0.37.0 in workspace packages but 0.0.1 at root, suggesting the root package.json is a workspace coordinator, not a published artifact.
| Languages | TypeScript, JavaScript, CSS, Shell |
| Runtime | Node.js >=22.13 / Cloudflare Workers |
| Framework | Hono (API routing), React (Cloudflare UI), Vite (frontend build) |
| Database | better-sqlite3 (Cloudflare worker local state) |
| Package Manager | pnpm 11.8 with Turborepo |
| Key Dependencies | @modelcontextprotocol/sdk, @cloudflare/workers-oauth-provider, ai (Vercel AI SDK), @ai-sdk/openai, hono, msw (mocking), vitest-evals, wrangler |
| Build Tool | Turborepo + tsdown + Vite |
| Test Framework | Vitest with vitest-evals for LLM evaluation tests |