Reference
MCP tools
This page is generated from the implemented MCP tool catalog so descriptions and argument lists stay aligned with the live server surface.
Setup
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
doctor | Run local DebugBundle environment diagnostics. | None | authFilePath, privacy |
smoke | Run the end-to-end smoke flow for a hosted project. | projectId | authFilePath, environment, maxAgeMinutes, service |
validate | Validate local DebugBundle project setup and optionally apply fixes. | None | fix |
verify_cloud | Verify hosted ingestion or actively prove hosted incident creation. | projectId | authFilePath, environment, maxAgeMinutes, service, trigger4xxStatus, trigger5xx |
verify_local | Run the local verification flow against the current repository. | None | None |
Analyze
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
analyze | Run local agent-oriented DebugBundle analysis. | None | local, type |
Retrieval
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
get_bundle | Fetch the debug bundle for an incident. | incidentId | bearerToken, source |
get_incident | Fetch a single incident by incident id. | incidentId | bearerToken, source |
get_incident_context | Fetch deterministic one-call incident context for explanation and triage. | incidentId | bearerToken, source |
get_logs | Fetch log records for an incident from the hosted API. | bearerToken, incidentId | cursor, level, limit |
get_reproduction | Fetch the reproduction artifact for an incident. | incidentId | bearerToken, source |
list_incidents | List incidents from local storage, cloud storage, or the combined connected view. | None | attentionAfter, bearerToken, cursor, environment, firstSeenAfter, limit, projectId, service, severity, source, status |
reopen_incident | Reopen an incident by incident id. | incidentId | bearerToken, source |
reopen_incidents | Reopen incidents in bulk by incident id. | incidentIds | bearerToken, source |
resolve_incident | Resolve an incident by incident id. | incidentId | bearerToken, source |
resolve_incidents | Resolve incidents in bulk by incident id. | incidentIds | bearerToken, source |
Improvements
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
get_improvement | Fetch a single hosted improvement opportunity by id. | bearerToken, improvementId | None |
get_improvement_bundle | Fetch the hosted improvement bundle artifact for a project improvement opportunity. | bearerToken, improvementId, projectId | None |
list_improvements | List hosted improvement opportunities for the current workspace or a specific project. | bearerToken | cursor, environment, kind, limit, projectId, service, severity, status |
reopen_improvement | Reopen a hosted improvement opportunity. | bearerToken, improvementId | None |
resolve_improvement | Resolve a hosted improvement opportunity. | bearerToken, improvementId | None |
snooze_improvement | Snooze a hosted improvement opportunity until an ISO8601 timestamp. | bearerToken, improvementId, snoozedUntil | None |
Github
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
create_github_dispatch_rule | Create a GitHub dispatch automation rule for a project. | bearerToken, bundleType, cooldownSeconds, environments, eventTypes, incidentStatus, name, projectId, services, severityMin | enabled |
delete_github_dispatch_rule | Delete a GitHub dispatch automation rule. | bearerToken, projectId, ruleId | None |
get_github_status | Get the project GitHub App installation status and optional project repo assignment. | bearerToken | projectId |
list_github_deliveries | List GitHub dispatch delivery history for a project. | bearerToken, projectId | limit, status |
list_github_dispatch_rules | List GitHub dispatch automation rules for a project. | bearerToken, projectId | None |
list_github_repositories | List repositories available to the project GitHub App installation for owner/admin callers. | bearerToken | projectId |
remove_project_github_repo | Remove a project GitHub repository assignment. | bearerToken, projectId | None |
retry_github_delivery | Retry a failed GitHub dispatch delivery. | bearerToken, deliveryId, projectId | None |
set_project_github_repo | Assign a primary GitHub repository to a project. | bearerToken, owner, projectId, repo | None |
update_github_dispatch_rule | Update a GitHub dispatch automation rule. | bearerToken, projectId, ruleId | bundleType, cooldownSeconds, enabled, environments, eventTypes, incidentStatus, name, services, severityMin |
Tokens
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
create_member_token | Create a new member token. | bearerToken, label | None |
create_project_token | Create a new project token. | bearerToken, label, projectId | allowedOrigins |
list_member_tokens | List member tokens for the authenticated member. | bearerToken | limit |
list_project_tokens | List project tokens for a project. | bearerToken, projectId | limit |
revoke_member_token | Revoke a member token. | bearerToken, tokenId | None |
revoke_project_token | Revoke a project token. | bearerToken, projectId, tokenId | None |
Webhooks
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
create_webhook | Create a webhook endpoint. | bearerToken, events, projectId, url | filters, isEnabled |
delete_webhook | Delete a webhook endpoint. | bearerToken, projectId, webhookId | None |
list_webhook_deliveries | List deliveries for a webhook endpoint. | bearerToken, projectId, webhookId | limit |
list_webhooks | List webhooks for a project. | bearerToken, projectId | limit |
retry_webhook_delivery | Retry a webhook delivery. | bearerToken, deliveryId, projectId, webhookId | None |
test_webhook | Queue a synthetic webhook delivery. | bearerToken, projectId, webhookId | eventType |
update_webhook | Update a webhook endpoint. | bearerToken, projectId, webhookId | events, filters, isEnabled, url |
Slack
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
delete_slack_destination | Delete a connected Slack destination from a project organization. | bearerToken, destinationId, projectId | None |
get_slack_connect_url | Return a browser Slack connect URL for a project. | bearerToken, projectId | returnTo |
list_slack_destinations | List reusable connected Slack destinations for a project organization. | bearerToken, projectId | None |
test_slack_destination | Send a test message to a connected Slack destination. | bearerToken, destinationId, projectId | None |
Weekly reports
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
create_weekly_report_channel | Create a weekly report delivery channel. Email channel config supports up to 3 recipients in config.to. | bearerToken, channel, config, projectId, schedule | isEnabled |
delete_weekly_report_channel | Delete a weekly report delivery channel. | bearerToken, channelId | None |
list_weekly_report_channels | List weekly report delivery channels for a project. | bearerToken, projectId | limit |
update_weekly_report_channel | Update a weekly report delivery channel. Email channel config supports up to 3 recipients in config.to. | bearerToken, channelId | config, isEnabled, schedule |
Alerts
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
create_alert | Create an alert rule, including optional severity-threshold lifecycle scope. | bearerToken, channel, conditionType, config, projectId | cooldownSeconds, isEnabled, serviceId, severityLifecycleScope, severityMin |
delete_alert | Delete an alert rule. | alertId, bearerToken, projectId | None |
list_alerts | List alert rules for a project. | bearerToken, projectId | limit |
update_alert | Update an alert rule, including optional severity-threshold lifecycle scope. | alertId, bearerToken, projectId | channel, conditionType, config, cooldownSeconds, isEnabled, serviceId, severityLifecycleScope, severityMin |
Projects
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
create_project | Create a new project. | bearerToken, name, slug | colorTag, environmentDefault |
delete_project | Delete a project. | bearerToken, projectId | None |
list_projects | List projects in the organization. | bearerToken | limit |
update_project | Update a project. | bearerToken, projectId | colorTag, environmentDefault, name, slug |
Capture Rules
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
create_capture_rule | Create a project capture rule. | bearerToken, create, projectId | None |
create_capture_rule_from_incident_suggestion | Create a capture rule from an incident-derived suggestion. | bearerToken, create, incidentId | None |
delete_capture_rule | Delete a project capture rule. | bearerToken, projectId, ruleId | None |
list_capture_rules | List project capture rules. | bearerToken, projectId | None |
suggest_capture_rules_from_incident | Generate deterministic capture rule suggestions from an incident bundle. | bearerToken, incidentId | None |
update_capture_rule | Update a project capture rule. | bearerToken, projectId, ruleId, update | None |
Analytics Metrics
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
generate_analytics_bundle | Request an AnalyticsBundle generation for a project analysis window and focus. | analysisKind, bearerToken, projectId | deployId, filters, from, funnel, incidentId, last, opportunityId, route, to |
get_action_metrics | Get aggregate AnalyticsBundle action, marker, and conversion metrics. | bearerToken, projectId | authState, browser, country, customDimensions, deviceType, environment, from, granularity, language, last, limit, os, referrer, route, service, to, utmCampaign, utmMedium, utmSource |
get_analytics_bundle | Get a generated AnalyticsBundle artifact or its pending/failed generation state. | bearerToken, bundleGenerationId, projectId | None |
get_analytics_journey_sample | Get one retained redacted AnalyticsBundle journey sample artifact for a project. | bearerToken, projectId, sampleId | None |
get_analytics_opportunity | Get an AnalyticsBundle opportunity for a project. | bearerToken, opportunityId, projectId | None |
get_device_breakdown | Get aggregate AnalyticsBundle device, browser, OS, and language breakdowns. | bearerToken, projectId | authState, browser, country, customDimensions, deviceType, environment, from, granularity, language, last, limit, os, referrer, route, service, to, utmCampaign, utmMedium, utmSource |
get_funnel_analysis | Get aggregate AnalyticsBundle funnel conversion and dropoff analysis. | bearerToken, funnelKey, projectId | authState, browser, country, customDimensions, deviceType, environment, from, granularity, language, last, limit, os, referrer, route, service, to, utmCampaign, utmMedium, utmSource |
get_incident_impact | Get aggregate AnalyticsBundle impact metrics for one incident, including linked routes, funnels, segments, journeys, and bundle state. | bearerToken, incidentId, projectId | authState, browser, country, customDimensions, deviceType, environment, from, granularity, language, last, limit, os, referrer, route, service, to, utmCampaign, utmMedium, utmSource |
get_journey_patterns | Get aggregate AnalyticsBundle journey transition patterns for a project. | bearerToken, projectId | authState, browser, country, customDimensions, deviceType, environment, from, granularity, language, last, limit, os, referrer, route, service, to, utmCampaign, utmMedium, utmSource |
get_referrer_metrics | Get aggregate AnalyticsBundle referrer and UTM metrics. | bearerToken, projectId | authState, browser, country, customDimensions, deviceType, environment, from, granularity, language, last, limit, os, referrer, route, service, to, utmCampaign, utmMedium, utmSource |
get_route_metrics | Get aggregate AnalyticsBundle route metrics for a project. | bearerToken, projectId | authState, browser, country, customDimensions, deviceType, environment, from, granularity, language, last, limit, os, referrer, route, service, to, utmCampaign, utmMedium, utmSource |
get_usage_summary | Get aggregate AnalyticsBundle usage summary metrics for a project. | bearerToken, projectId | authState, browser, country, customDimensions, deviceType, environment, from, granularity, language, last, limit, os, referrer, route, service, to, utmCampaign, utmMedium, utmSource |
list_analytics_bundles | List AnalyticsBundle generation records for a project, or across accessible projects when projectId is omitted. | bearerToken | cursor, environment, from, kind, limit, projectId, service, status, to |
list_analytics_journey_samples | List retained redacted AnalyticsBundle journey sample metadata for a project. | bearerToken, projectId | cursor, environment, limit, service, tag |
list_analytics_opportunities | List AnalyticsBundle opportunities for a project, or across accessible projects when projectId is omitted. | bearerToken | bundleStatus, cursor, environment, from, kind, limit, projectId, service, severity, status, to |
list_funnel_metrics | List aggregate AnalyticsBundle funnel conversion summaries for a project. | bearerToken, projectId | authState, browser, country, customDimensions, deviceType, environment, from, granularity, language, last, limit, os, referrer, route, service, to, utmCampaign, utmMedium, utmSource |
Analytics Settings
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
get_analytics_settings | Get AnalyticsBundle settings for a project. | bearerToken, projectId | None |
update_analytics_settings | Update AnalyticsBundle settings for a project. | bearerToken, projectId, update | None |
Analytics Saved Funnels
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
archive_saved_analytics_funnel | Archive a saved AnalyticsBundle funnel definition for a project. | bearerToken, funnelKey, projectId | None |
create_saved_analytics_funnel | Create a reusable AnalyticsBundle funnel definition for a project. | bearerToken, displayName, funnelKey, projectId, steps | None |
list_saved_analytics_funnels | List active saved AnalyticsBundle funnel definitions for a project. | bearerToken, projectId | None |
Capture Policy
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
get_capture_policy | Get the resolved capture policy for a project. | bearerToken, projectId | None |
update_capture_policy | Update the capture policy for a project. | bearerToken, projectId, update | None |
Improvement Settings
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
get_improvement_settings | Get automated improvement settings for a project. | bearerToken, projectId | None |
update_improvement_settings | Update automated improvement settings for a project. | bearerToken, projectId, update | None |
Probes
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
activate_probe | Activate a remote probe on a project. | bearerToken, labelPattern, projectId | environment, service, triggerTtlSeconds, ttlSeconds |
deactivate_probe | Deactivate a probe activation. | activationId, bearerToken, projectId | None |
list_active_probes | List active probe activations for a project. | bearerToken, projectId | None |
Health Checks
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
create_health_check | Create a hosted health check for a project. | bearerToken, intervalSeconds, name, projectId, url | enabled, environment, expectedStatusMax, expectedStatusMin, failureThreshold, method, recoveryThreshold, serviceName, timeoutMs |
delete_health_check | Delete a hosted health check. | bearerToken, checkId, projectId | None |
get_health_check | Get one hosted health check by id. | bearerToken, checkId, projectId | None |
list_health_check_daily_rollups | List retained per-day history for one hosted health check. | bearerToken, checkId, projectId | limit |
list_health_check_results | List recent execution results for one hosted health check. | bearerToken, checkId, projectId | limit |
list_health_checks | List hosted health checks for a project. | bearerToken, projectId | limit |
test_health_check | Run a side-effect-free test for a hosted health-check target. | bearerToken, projectId, url | expectedStatusMax, expectedStatusMin, method, timeoutMs |
update_health_check | Update a hosted health check. | bearerToken, checkId, projectId | enabled, environment, expectedStatusMax, expectedStatusMin, failureThreshold, intervalSeconds, method, name, recoveryThreshold, serviceName, timeoutMs, url |
Billing
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
cancel_capacity_reduction | Cancel a scheduled capacity reduction. | bearerToken | None |
get_billing_summary | Get the billing summary for the organization. | bearerToken | None |
increase_capacity | Increase additional capacity units. | bearerToken, targetAdditionalCapacityUnits | None |
schedule_capacity_reduction | Schedule a capacity reduction at end of billing cycle. | bearerToken, targetAdditionalCapacityUnits | None |
start_trial | Start an eligible no-card trial for the organization. | bearerToken, targetPlan | None |
Members
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
cancel_project_member_invite | Cancel a pending project invite. | bearerToken, inviteId, projectId | None |
invite_project_member | Invite a collaborator to a project. | bearerToken, email, projectId, role | None |
leave_project | Leave a shared project as the authenticated collaborator. | bearerToken, projectId | None |
list_project_member_invites | List pending invites for a project. | bearerToken, projectId | None |
list_project_members | List members for a project. | bearerToken, projectId | None |
remove_project_member | Remove a collaborator from a project. | bearerToken, projectId, userId | None |
update_project_member_role | Update the role of a project collaborator. | bearerToken, projectId, role, userId | None |
Services
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
list_services | List services for a project. | bearerToken, projectId | limit |
Parity rule
These entries are meant to describe the same behavior as the API and CLI equivalents, not a separate MCP-only implementation.