Sentry MCP connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'sentrymcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Sentry MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'sentrymcp_find_organizations',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "sentrymcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Sentry MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="sentrymcp_find_organizations",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Update issue — Update a Sentry issue’s status or assignment
• Search sentry tools, issues, events — Search the available Sentry MCP tool catalog by keyword
• Get sentry resource — Fetch a Sentry resource by URL, or by resourceType plus resourceId
• Projects find — Find projects within a Sentry organization
• Organizations find — Find organizations that the user has access to in Sentry
• Execute sentry tool — Execute any available Sentry MCP tool discovered through the search_sentry_tools tool

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

sentrymcp_analyze_issue_with_seer#Use Sentry's Seer AI to analyze a production error and get root cause analysis with specific code fixes. Provides file locations, line numbers, and concrete fix recommendations. Results are cached — subsequent calls return instantly.5 params▾

Use Sentry's Seer AI to analyze a production error and get root cause analysis with specific code fixes. Provides file locations, line numbers, and concrete fix recommendations. Results are cached — subsequent calls return instantly.

NameTypeRequiredDescription

instructionstringoptionalOptional custom instruction for the AI analysis, to focus on specific aspects of the issue.

issueIdstringoptionalThe Issue ID. Example: 'PROJECT-1Z43'. Required if issueUrl is not provided.

issueUrlstringoptionalFull URL to the Sentry issue. Example: 'https://my-org.sentry.io/issues/PROJECT-1Z43'. Use instead of organizationSlug + issueId.

organizationSlugstringoptionalThe organization's slug. Use the find_organizations tool to list available organizations.

regionUrlstringoptionalThe region URL for the organization. For sentry.io, typically 'https://us.sentry.io'. Omit for self-hosted.

sentrymcp_execute_sentry_tool#Execute any available Sentry MCP tool discovered through the search_sentry_tools tool. Use this to call Sentry operations that are not exposed as direct top-level tools.2 params▾

Execute any available Sentry MCP tool discovered through the search_sentry_tools tool. Use this to call Sentry operations that are not exposed as direct top-level tools.

NameTypeRequiredDescription

namestringrequiredThe name of the Sentry tool to execute, as returned by search_sentry_tools. Example: 'find_projects', 'whoami', 'get_issue_details'.

argumentsobjectoptionalArguments for the target tool, matching the schema returned by search_sentry_tools. Example: {"organizationSlug": "my-org"}.

sentrymcp_find_organizations#Find organizations that the user has access to in Sentry. Supports filtering by name or slug. Returns up to 25 results.1 param▾

Find organizations that the user has access to in Sentry. Supports filtering by name or slug. Returns up to 25 results.

NameTypeRequiredDescription

querystringoptionalSearch query to filter results by name or slug. Use this to narrow down results when there are many items.

sentrymcp_find_projects#Find projects within a Sentry organization. Supports filtering by name or slug. Returns up to 25 results.3 params▾

Find projects within a Sentry organization. Supports filtering by name or slug. Returns up to 25 results.

NameTypeRequiredDescription

organizationSlugstringrequiredThe organization's slug. Use the find_organizations tool to list available organizations.

querystringoptionalSearch query to filter results by project name or slug.

regionUrlstringoptionalThe region URL for the organization. For sentry.io, this is typically 'https://us.sentry.io'. Omit for self-hosted installations.

sentrymcp_get_sentry_resource#Fetch a Sentry resource by URL, or by resourceType plus resourceId. Supports issues, events, traces, spans, AI conversations, breadcrumbs, replays, monitors, and snapshots. Pass a Sentry URL directly when possible — the resource type is auto-detected.4 params▾

Fetch a Sentry resource by URL, or by resourceType plus resourceId. Supports issues, events, traces, spans, AI conversations, breadcrumbs, replays, monitors, and snapshots. Pass a Sentry URL directly when possible — the resource type is auto-detected.

NameTypeRequiredDescription

organizationSlugstringoptionalThe organization's slug. Required when not providing a URL.

resourceIdstringoptionalResource identifier. For issues: short ID like 'PROJECT-123'. For spans: 'traceId:spanId'. For snapshot images: 'snapshotId:image_file_name'. Required when not using a URL.

resourceTypestringoptionalResource type to fetch. Use with resourceId when not providing a URL.

urlstringoptionalSentry URL. The resource type is auto-detected from the URL pattern. Example: 'https://my-org.sentry.io/issues/PROJECT-123/'.

sentrymcp_search_events#Search Sentry events across datasets (errors, logs, spans, metrics, profiles, replays). Supports aggregations (counts, averages) and individual event queries. Use natural language or Sentry query syntax.10 params▾

Search Sentry events across datasets (errors, logs, spans, metrics, profiles, replays). Supports aggregations (counts, averages) and individual event queries. Use natural language or Sentry query syntax.

NameTypeRequiredDescription

organizationSlugstringrequiredThe organization's slug. Use the find_organizations tool to list available organizations.

datasetstringoptionalDataset to query: errors (exceptions), logs (log entries), spans (traces/performance), metrics (counters/gauges), profiles (profiling), replays (session replays).

fieldsarrayoptionalFields to return. Include aggregate functions like count(), avg() for statistics. Example: ['issue', 'count()'].

includeExplanationbooleanoptionalInclude an explanation of how the query was interpreted or repaired.

limitnumberoptionalMaximum number of results to return (1–100). Default is 10.

projectSlugstringoptionalFilter results to a specific project by slug.

querystringoptionalNatural language or Sentry event search query. Example: 'how many errors today', 'level:error', 'span.op:db'.

regionUrlstringoptionalThe region URL for the organization. For sentry.io, typically 'https://us.sentry.io'. Omit for self-hosted.

sortstringoptionalSort field (prefix with - for descending). Example: '-count()' for most frequent, '-timestamp' for newest.

statsPeriodstringoptionalTime period to query: 1h, 24h, 7d, 14d, 30d, etc.

sentrymcp_search_issues#Search for grouped issues/problems in Sentry. Returns a list of issues with metadata like title, status, and user count. Supports natural language or Sentry query syntax. Use search_events for counts/aggregations.7 params▾

Search for grouped issues/problems in Sentry. Returns a list of issues with metadata like title, status, and user count. Supports natural language or Sentry query syntax. Use search_events for counts/aggregations.

NameTypeRequiredDescription

organizationSlugstringrequiredThe organization's slug. Use the find_organizations tool to list available organizations.

includeExplanationbooleanoptionalInclude an explanation of how the query was interpreted or repaired by the AI.

limitnumberoptionalMaximum number of issues to return (1–100). Default is 10.

projectSlugOrIdstringoptionalFilter by project slug or numeric ID (optional).

querystringoptionalNatural language or Sentry issue search query. Examples: 'is:unresolved', 'level:error firstSeen:-24h', 'assigned:me', 'critical bugs from last week'.

regionUrlstringoptionalThe region URL for the organization. For sentry.io, typically 'https://us.sentry.io'. Omit for self-hosted.

sortstringoptionalSort order for results: date (last seen), freq (frequency), new (first seen), user (user count).

sentrymcp_search_sentry_tools#Search the available Sentry MCP tool catalog by keyword. Use this to discover catalog tools and their schemas for any Sentry operation not directly exposed as a top-level tool (e.g. project management, documentation, DSNs, releases, attachments, snapshots).2 params▾

Search the available Sentry MCP tool catalog by keyword. Use this to discover catalog tools and their schemas for any Sentry operation not directly exposed as a top-level tool (e.g. project management, documentation, DSNs, releases, attachments, snapshots).

NameTypeRequiredDescription

querystringrequiredNatural language keywords describing the Sentry operation or resource to find. Example: 'list projects', 'issue details', 'find dsn'.

limitintegeroptionalMaximum number of matching tools to return (1–20). Default is 8.

sentrymcp_update_issue#Update a Sentry issue's status or assignment. Use to resolve, reopen, assign, or ignore an issue. Provide issueUrl or organizationSlug + issueId. At least one of status or assignedTo is required.13 params▾

Update a Sentry issue's status or assignment. Use to resolve, reopen, assign, or ignore an issue. Provide issueUrl or organizationSlug + issueId. At least one of status or assignedTo is required.

NameTypeRequiredDescription

assignedTostringoptionalAssignee in format 'user:ID' or 'team:ID_OR_SLUG'. Example: 'user:123456', 'team:my-team-slug'.

ignoreCountintegeroptionalNumber of occurrences before the issue stops being ignored when ignoreMode is 'untilOccurrenceCount'.

ignoreDurationMinutesintegeroptionalMinutes to ignore the issue when ignoreMode is 'forDuration'.

ignoreModestringoptionalHow ignored issues should behave: untilEscalating (Sentry default), forever, forDuration, untilOccurrenceCount, or untilUserCount.

ignoreUserCountintegeroptionalNumber of affected users before the issue stops being ignored when ignoreMode is 'untilUserCount'.

ignoreUserWindowMinutesintegeroptionalOptional time window in minutes for ignoreUserCount. Maximum 10080 (1 week).

ignoreWindowMinutesintegeroptionalOptional time window in minutes for ignoreCount. Maximum 10080 (1 week).

issueIdstringoptionalThe Issue ID, e.g. 'PROJECT-1Z43'. Required if issueUrl is not provided.

issueUrlstringoptionalFull URL to the Sentry issue. Use instead of organizationSlug + issueId.

organizationSlugstringoptionalThe organization's slug. Required if issueUrl is not provided.

reasonstringoptionalOptional reason for the action. When provided, posted as a comment on the issue's activity feed.

regionUrlstringoptionalThe region URL for the organization. For sentry.io, typically 'https://us.sentry.io'. Omit for self-hosted.

statusstringoptionalNew status for the issue: resolved, resolvedInNextRelease, unresolved, or ignored.