Open Skills Logo
Open Skills

sentry-automation

Automate Sentry tasks via Rube MCP (Composio): manage issues/events, configure alerts, track releases, monitor projects and teams. Always search tools first for current schemas.

View Source
name:sentry-automationdescription:"Automate Sentry tasks via Rube MCP (Composio): manage issues/events, configure alerts, track releases, monitor projects and teams. Always search tools first for current schemas."requires:mcp:[rube]

Sentry Automation via Rube MCP

Automate Sentry error tracking and monitoring operations through Composio's Sentry toolkit via Rube MCP.

Prerequisites

  • Rube MCP must be connected (RUBE_SEARCH_TOOLS available)

  • Active Sentry connection via RUBE_MANAGE_CONNECTIONS with toolkit sentry

  • Always call RUBE_SEARCH_TOOLS first to get current tool schemas

    • Setup

    Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.


  • Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds

  • Call RUBE_MANAGE_CONNECTIONS with toolkit sentry

  • If connection is not ACTIVE, follow the returned auth link to complete Sentry OAuth

  • Confirm connection status shows ACTIVE before running any workflows

    • Core Workflows

    1. Investigate Issues

    When to use: User wants to find, inspect, or triage error issues

    Tool sequence:

  • SENTRY_LIST_AN_ORGANIZATIONS_ISSUES - List issues across the organization [Required]

  • SENTRY_GET_ORGANIZATION_ISSUE_DETAILS - Get detailed info on a specific issue [Optional]

  • SENTRY_LIST_AN_ISSUES_EVENTS - View individual error events for an issue [Optional]

  • SENTRY_RETRIEVE_AN_ISSUE_EVENT - Get full event details with stack trace [Optional]

  • SENTRY_RETRIEVE_ISSUE_TAG_DETAILS - Inspect tag distribution for an issue [Optional]

    • Key parameters:

  • organization_id_or_slug: Organization identifier

  • issue_id: Numeric issue ID

  • query: Search query (e.g., is:unresolved, assigned:me, browser:Chrome)

  • sort: Sort order (date, new, freq, priority)

  • statsPeriod: Time window for stats (24h, 14d, etc.)

    • Pitfalls:

  • organization_id_or_slug is the org slug (e.g., 'my-org'), not the display name

  • Issue IDs are numeric; do not confuse with event IDs which are UUIDs

  • Query syntax uses Sentry's search format: is:unresolved, assigned:me, !has:release

  • Events within an issue can have different stack traces; inspect individual events for details

    • 2. Manage Project Issues

    When to use: User wants to view issues scoped to a specific project

    Tool sequence:

  • SENTRY_RETRIEVE_ORGANIZATION_PROJECTS - List projects to find project slug [Prerequisite]

  • SENTRY_RETRIEVE_PROJECT_ISSUES_LIST - List issues for a specific project [Required]

  • SENTRY_RETRIEVE_ISSUE_EVENTS_BY_ID - Get events for a specific issue [Optional]

    • Key parameters:

  • organization_id_or_slug: Organization identifier

  • project_id_or_slug: Project identifier

  • query: Search filter string

  • statsPeriod: Stats time window

    • Pitfalls:

  • Project slugs are different from project display names

  • Always resolve project names to slugs via RETRIEVE_ORGANIZATION_PROJECTS first

  • Project-scoped issue lists may have different pagination than org-scoped lists

    • 3. Configure Alert Rules

    When to use: User wants to create or manage alert rules for a project

    Tool sequence:

  • SENTRY_RETRIEVE_ORGANIZATION_PROJECTS - Find project for the alert [Prerequisite]

  • SENTRY_RETRIEVE_PROJECT_RULES_BY_ORG_AND_PROJECT_ID - List existing rules [Optional]

  • SENTRY_CREATE_PROJECT_RULE_FOR_ALERTS - Create a new alert rule [Required]

  • SENTRY_CREATE_ORGANIZATION_ALERT_RULE - Create org-level metric alert [Alternative]

  • SENTRY_UPDATE_ORGANIZATION_ALERT_RULES - Update existing alert rules [Optional]

  • SENTRY_RETRIEVE_ALERT_RULE_DETAILS - Inspect specific alert rule [Optional]

  • SENTRY_GET_PROJECT_RULE_DETAILS - Get project-level rule details [Optional]

    • Key parameters:

  • name: Alert rule name

  • conditions: Array of trigger conditions

  • actions: Array of actions to perform when triggered

  • filters: Array of event filters

  • frequency: How often to trigger (in minutes)

  • actionMatch: 'all', 'any', or 'none' for condition matching

    • Pitfalls:

  • Project-level rules (CREATE_PROJECT_RULE) and org-level metric alerts (CREATE_ORGANIZATION_ALERT_RULE) are different

  • Conditions, actions, and filters use specific JSON schemas; check Sentry docs for valid types

  • frequency is in minutes; setting too low causes alert fatigue

  • actionMatch defaults may vary; explicitly set to avoid unexpected behavior

    • 4. Manage Releases

    When to use: User wants to create, track, or manage release versions

    Tool sequence:

  • SENTRY_LIST_ORGANIZATION_RELEASES - List existing releases [Optional]

  • SENTRY_CREATE_RELEASE_FOR_ORGANIZATION - Create a new release [Required]

  • SENTRY_UPDATE_RELEASE_DETAILS_FOR_ORGANIZATION - Update release metadata [Optional]

  • SENTRY_CREATE_RELEASE_DEPLOY_FOR_ORG - Record a deployment for a release [Optional]

  • SENTRY_UPLOAD_RELEASE_FILE_TO_ORGANIZATION - Upload source maps or files [Optional]

    • Key parameters:

  • version: Release version string (e.g., '1.0.0', commit SHA)

  • projects: Array of project slugs this release belongs to

  • dateReleased: Release timestamp (ISO 8601)

  • environment: Deployment environment name (e.g., 'production', 'staging')

    • Pitfalls:

  • Release versions must be unique within an organization

  • Releases can span multiple projects; use the projects array

  • Deploying a release is separate from creating it; use CREATE_RELEASE_DEPLOY

  • Source map uploads require the release to exist first

    • 5. Monitor Organization and Teams

    When to use: User wants to view org structure, teams, or member lists

    Tool sequence:

  • SENTRY_GET_ORGANIZATION_DETAILS or SENTRY_GET_ORGANIZATION_BY_ID_OR_SLUG - Get org info [Required]

  • SENTRY_LIST_TEAMS_IN_ORGANIZATION - List all teams [Optional]

  • SENTRY_LIST_ORGANIZATION_MEMBERS - List org members [Optional]

  • SENTRY_GET_PROJECT_LIST - List all accessible projects [Optional]

    • Key parameters:

  • organization_id_or_slug: Organization identifier

  • cursor: Pagination cursor for large result sets

    • Pitfalls:

  • Organization slugs are URL-safe identifiers, not display names

  • Member lists may be paginated; follow cursor pagination

  • Team and member visibility depends on the authenticated user's permissions

    • 6. Manage Monitors (Cron Monitoring)

    When to use: User wants to update cron job monitoring configuration

    Tool sequence:

  • SENTRY_UPDATE_A_MONITOR - Update monitor configuration [Required]

    • Key parameters:

  • organization_id_or_slug: Organization identifier

  • monitor_id_or_slug: Monitor identifier

  • name: Monitor display name

  • schedule: Cron schedule expression or interval

  • checkin_margin: Grace period in minutes for late check-ins

  • max_runtime: Maximum expected runtime in minutes

    • Pitfalls:

  • Monitor slugs are auto-generated from the name; use slug for API calls

  • Schedule changes take effect immediately

  • Missing check-ins trigger alerts after the margin period

    • Common Patterns

    ID Resolution

    Organization name -> Slug:

    1. Call SENTRY_GET_ORGANIZATION_DETAILS
  • Extract slug field from response

    • Project name -> Slug:

    1. Call SENTRY_RETRIEVE_ORGANIZATION_PROJECTS
  • Find project by name, extract slug

    • Pagination

  • Sentry uses cursor-based pagination with Link headers

  • Check response for cursor values

  • Pass cursor in next request until no more pages

    • Search Query Syntax

  • is:unresolved - Unresolved issues

  • is:resolved - Resolved issues

  • assigned:me - Assigned to current user

  • assigned:team-slug - Assigned to a team

  • !has:release - Issues without a release

  • first-release:1.0.0 - Issues first seen in release

  • times-seen:>100 - Seen more than 100 times

  • browser:Chrome - Filter by browser tag

    • Known Pitfalls

    ID Formats:

  • Organization: use slug (e.g., 'my-org'), not display name

  • Project: use slug (e.g., 'my-project'), not display name

  • Issue IDs: numeric integers

  • Event IDs: UUIDs (32-char hex strings)

    • Permissions:

  • API token scopes must match the operations being performed

  • Organization-level operations require org-level permissions

  • Project-level operations require project access

    • Rate Limits:

  • Sentry enforces per-organization rate limits

  • Implement backoff on 429 responses

  • Bulk operations should be staggered

    • Quick Reference

    TaskTool SlugKey Params
    List org issuesSENTRY_LIST_AN_ORGANIZATIONS_ISSUESorganization_id_or_slug, query
    Get issue detailsSENTRY_GET_ORGANIZATION_ISSUE_DETAILSorganization_id_or_slug, issue_id
    List issue eventsSENTRY_LIST_AN_ISSUES_EVENTSissue_id
    Get event detailsSENTRY_RETRIEVE_AN_ISSUE_EVENTorganization_id_or_slug, event_id
    List project issuesSENTRY_RETRIEVE_PROJECT_ISSUES_LISTorganization_id_or_slug, project_id_or_slug
    List projectsSENTRY_RETRIEVE_ORGANIZATION_PROJECTSorganization_id_or_slug
    Get org detailsSENTRY_GET_ORGANIZATION_DETAILSorganization_id_or_slug
    List teamsSENTRY_LIST_TEAMS_IN_ORGANIZATIONorganization_id_or_slug
    List membersSENTRY_LIST_ORGANIZATION_MEMBERSorganization_id_or_slug
    Create alert ruleSENTRY_CREATE_PROJECT_RULE_FOR_ALERTSorganization_id_or_slug, project_id_or_slug
    Create metric alertSENTRY_CREATE_ORGANIZATION_ALERT_RULEorganization_id_or_slug
    Create releaseSENTRY_CREATE_RELEASE_FOR_ORGANIZATIONorganization_id_or_slug, version
    Deploy releaseSENTRY_CREATE_RELEASE_DEPLOY_FOR_ORGorganization_id_or_slug, version
    List releasesSENTRY_LIST_ORGANIZATION_RELEASESorganization_id_or_slug
    Update monitorSENTRY_UPDATE_A_MONITORorganization_id_or_slug, monitor_id_or_slug

      sentry-automation - Agent Skills