Skip to main content
Glama
HieuAnh87

selfhosted-sentry-mcp

by HieuAnh87

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
SENTRY_URLYesBase URL of your self-hosted Sentry instance (e.g., https://your-sentry-instance.com)
SENTRY_ORG_SLUGYesOrganization slug (e.g., my-org)
SENTRY_AUTH_TOKENYesSentry API token with scopes: issue:read, project:read, event:read, issue:write, comment:write

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{}
resources
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_sentry_issueA

Retrieve a Sentry issue by numeric ID, short ID (e.g. PROJ-1A2) or issue URL. Returns essential issue fields only; the stacktrace is NOT included unless include_latest_event is true, which adds the latest event's exception (innermost max_stack_frames frames per exception), message and recent breadcrumbs. Supports field filtering, grep and automatic truncation.

list_sentry_projectsA

List projects in the configured Sentry organization (essential fields only). When more projects exist, the result carries a next_cursor; pass it as cursor to get the next page.

list_sentry_issuesB

List issues for a specific project, optionally filtering by query or status. Supports pagination.

list_issuesA

List issues using Sentry search query syntax (e.g., "is:unresolved environment:production"). More powerful than list_sentry_issues which is project-scoped.

update_sentry_issue_statusB

Update the status of a Sentry issue. Returns the issue id, short ID, title and new status.

create_sentry_issue_commentA

Add a comment to a Sentry issue. Returns the new comment id.

get_issue_hashesA

Get the fingerprint hashes for an issue (25 per page). Useful for understanding why events are grouped together. Paginate with cursor.

bulk_update_issuesA

Bulk update issues in one project (resolve, ignore, unresolve, assign, mark seen). Scope: exactly one of issue_ids or query is required. issue_ids changes only those issues; query changes EVERY issue in the project that matches the Sentry search (up to 1000 per call). A call with neither is refused, because Sentry would otherwise change every unresolved issue in the project.

get_sentry_event_detailsB

Retrieve details for a specific event ID within a project. IMPORTANT: For large events, always use limit parameter (e.g., limit: 10) to avoid token limits.

list_issue_eventsA

List all events for a specific issue. Useful to see all occurrences of an error over time.

list_error_eventsA

List error events in a project. Search across all events without knowing the issue ID.

get_stack_framesC

Extract structured stack trace frames from an event. Optimized for debugging.

check_dsym_statusB

Check if debug symbols (dSYM files) are missing for iOS/macOS crashes.

list_breadcrumbsB

Extract all breadcrumbs from an event, showing the trail of events leading up to an error.

list_releasesC

List releases in the organization. Releases link code deployments to error data.

get_release_detailsA

Get detailed information about a release including health stats, commits, and authors.

list_teamsA

List all teams in the organization.

get_issue_tagsB

List all tags captured for an issue. Tags help identify patterns (e.g., environment, OS, user segment affected).

get_issue_tag_valuesA

Get tag value distribution for a specific tag key. Shows which values occur most frequently for an issue.

list_activityA

List activity log for an issue. Shows comments, assignments, status changes, and other events.

get_trace_detailsA

Get a distributed trace as a compact, flat list of spans/transactions (id, parent id, op, description, transaction, project, duration ms, start time, linked errors) in tree order with depth, plus totals and errors not attached to any span. Searches the last 90 days. Requires performance/tracing data.

get_grouping_configA

Explain why events are grouped into an issue: takes the issue's latest event and returns its grouping breakdown — the grouping config, and per variant (e.g. app/system stack trace, fingerprint, message) whether it contributes, its hash, hint and a short summary of the contributing components. Compare hashes with get_issue_hashes.

merge_issuesA

Merge issues of the same project into one (error issues only; cross-project merges are refused). Sentry picks the surviving parent itself — the issue first seen earliest — which is not necessarily issue_id; the others become its children. The merge completes asynchronously in Sentry. Use after confirming the issues share a root cause.

list_event_attachmentsA

List files attached to events (log files, minidumps, screenshots, view hierarchies). Pass issue_id for every attachment on an issue, or project_slug + event_id for one event. Read text attachments with get_event_attachment.

get_event_attachmentA

Read the contents of a text attachment (e.g. a log file) on an event. Binary attachments such as minidumps are not returned; their metadata is. Use grep_pattern to return only matching lines from large logs.

list_user_feedbackA

List user feedback (what end users wrote when reporting a crash) for an issue or a whole project. Pass exactly one of issue_id or project_slug. Reporter emails are omitted.

whoamiA

Check the Sentry connection: the user the token belongs to, the token's scopes, whether the configured organization is reachable, and which tools the scopes rule out. Call this first when other tools fail with 401/403.

raw_sentry_apiA

Make a raw API call to any Sentry endpoint. Returns unfiltered JSON. WARNING: Event endpoints can return 100K+ tokens. Use grep_pattern for events.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.5/5.0

Scored across 28 tools

Disambiguation4/5

Most tools target distinct resources, and the long descriptions explicitly differentiate near-neighbors (e.g. list_issues vs list_sentry_issues, list_issue_events vs list_error_events, update_sentry_issue_status vs bulk_update_issues). However, the event-fetching cluster (get_sentry_event_details, list_issue_events, list_error_events, get_stack_frames, list_breadcrumbs) still has adjacent boundaries that an agent could confuse, and single vs bulk status updates overlap.

Naming Consistency4/5

Names follow a mostly predictable snake_case verb_noun pattern (list_, get_, create_, update_, merge_, bulk_update_). The main blemish is an inconsistent redundant 'sentry' infix applied to only a subset (get_sentry_issue, list_sentry_projects, raw_sentry_api) while sibling tools omit it, which slightly muddies predictability.

Tool Count3/5

At 28 tools the surface is heavy and sits above the comfortable 3-15 range, with some redundancy (multiple issue/event listing tools). Sentry is a broad domain so most tools earn their place, but the count is borderline overweight.

Completeness4/5

Coverage spans issues, events, attachments, releases, traces, tags, feedback, teams, projects, grouping and comments, with a raw_sentry_api escape hatch for gaps. Missing explicit release creation and dedicated issue assignment tooling, but bulk_update_issues handles assignment and deploys are usually external, so gaps are minor.

Maintenance

ActivityMaintained
ResponsivenessNo issues