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.
Projects
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
apply_project_merge | Apply the exact checked request and plan_digest using a stable idempotency_key. Preserve IDs, old credentials, evidence and original scopes. After a timeout look up that key; local adoption and deployed-runtime verification are separate pending gates. | bearerToken, idempotency_key, plan_digest, request | None |
cancel_project_merge | Cancel an operation only before its atomic cutover starts. Cannot undo a committed merge. | bearerToken, operation_id | None |
create_project | Create a new project. | bearerToken, name, slug | colorTag, environmentDefault |
delete_project | Delete a project. | bearerToken, projectId | None |
get_project_merge | Read a durable merge operation by operation_id OR its original idempotency_key, including uncertain apply outcomes. | bearerToken | idempotency_key, operation_id |
list_projects | List projects in the organization. | bearerToken | limit, projectId |
preview_project_merge | Preview consolidation into one project with logical services. Read-only; inspect blockers, resource bounds and suggested_service_mappings, then preview explicit mappings again. Same owner/account and compatible access/settings required. Does not edit repositories or deploy. | bearerToken, request | None |
resume_project_merge | Resume eligible pre-commit work or retry verification after commit without repeating the relational cutover. | bearerToken, operation_id | None |
update_project | Update a project. | bearerToken, projectId | colorTag, environmentDefault, name, slug |
verify_project_merge | Read-only verification of the committed server namespace and service mappings. A failed post-commit check does not imply rollback. Use resume for eligible repair. | bearerToken, operation_id | None |
Services
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
create_service_definition | Create an application/process inside an existing project. Optional repository/root overrides its project default; does not edit a repository or deploy instrumentation. | bearerToken, projectId, service | None |
get_service_definition | Read one logical service and its repository context. Its definition ID is distinct from environment-specific service_id. | bearerToken, projectId, serviceDefinitionId | None |
list_service_definitions | List logical project services, effective repository context and environments. Follow next_cursor to inspect the complete system. | bearerToken, projectId | cursor, limit |
list_services | List services for a project. | bearerToken, projectId | limit, offset |
update_service_definition | Update logical service metadata, preserving its identity and legacy input name. Null repository values restore project defaults. Requires project owner/admin access. | bearerToken, projectId, serviceDefinitionId, update | None |
Notifications
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
get_notification_preferences | Read account defaults or project overrides and effective notification policies. Personal affects your email; shared affects team destinations. | bearerToken | audience, projectId |
pause_notifications | Pause selected channels until a future UTC instant, or null for until resumed. Account pauses win over project settings. Explicitly opt in to health-check alerts during the pause. Personal supports email only. | bearerToken, pause | audience, projectId |
resume_notifications | Resume selected channels at the chosen account/project scope, preserving delivery modes. An account pause still overrides project resume. Suppressed alerts are not replayed. | bearerToken, resume | audience, projectId |
update_notification_preferences | Update channel modes or daily email time and IANA timezone. Project overrides may inherit. Shared settings require account owner or project owner/admin. Monitoring continues; mandatory system emails are separate. | bearerToken, update | audience, projectId |
Public Status
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
get_public_status_page | Read a project's public status settings and share URL. Owners receive configuration; collaborators receive only the published link and title. | bearerToken, projectId | None |
list_public_status_page_options | List a bounded page of same-owner/account projects and checks eligible for status publication. Owner only; continue with next_cursor. | bearerToken, projectId | check_cursor, check_project_id, cursor |
preview_public_status_page | Preview the saved public projection, including unpublished settings. Owner only. Reads existing availability; never executes checks or exposes diagnostic details. | bearerToken, projectId | None |
save_public_status_page | Save or publish/unpublish a public status page. Owner only. Explicit selections expose names and 30-day availability for chosen checks; other projects must share the same owner and account. Anchor project must be first. New checks remain private. | bearerToken, projectId, settings | None |
Analytics Flows
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
archive_analytics_flow | Archive a project flow, stopping new capture while retaining aggregate reports. Owner/admin only. | bearerToken, flowKey, projectId | None |
get_analytics_flow_report | Read aggregate reached steps, drop-off, elapsed time, sources and unlinked coverage for full UTC days. Observations do not prove backend business outcomes. | bearerToken, flowKey, projectId | window |
list_analytics_flows | List this project's named acquisition and activation flows, including archived definitions. | bearerToken, projectId | None |
save_analytics_flow | Create or replace a project flow with two to eight ordered steps and exact origins. Owner/admin only. Edits start a new report version. | bearerToken, definition, projectId | None |
Setup
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
doctor | Run DebugBundle environment diagnostics. Connected mode checks API health and saved member authentication with one incident request restricted to the connected project; incident contents are not returned. | 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_app_event | Wait for a real SDK-driven hosted app incident and verify its bundle using service, traceId, or requestId. Read-only proof; does not create synthetic events. Requires local member authentication. | projectId | authFilePath, environment, maxAgeMinutes, requestId, service, traceId |
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 |
disconnect_github_installation | Disconnect the GitHub installation for the active organization and remove repository assignments across all its projects. Owner only. This does not uninstall the App from GitHub; install/reconnect requires the dashboard browser handoff. | bearerToken | 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, projectScope, services, severityMin |
Tokens
| Tool | Description | Required arguments | Optional arguments |
|---|---|---|---|
create_agent_token | Create a single-project minimized read credential, returned once. Requires owner or project admin. | bearerToken, label, projectId | expiresAt |
create_member_token | Create a new member token. | bearerToken, label | None |
create_project_token | Create a new project token. | bearerToken, label, projectId | allowedOrigins |
list_agent_tokens | List project-scoped read-only agent credentials. Requires owner or project admin. | bearerToken, projectId | None |
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_agent_token | Revoke a project-scoped agent credential. Requires owner or project admin. | bearerToken, projectId, tokenId | None |
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 |
test_webhook_event | Queue a signed synthetic webhook test for any supported lifecycle event. Requires endpoint creator or owner/admin authority; does not create a real incident or bundle. The legacy test_webhook verification contract is retained. | bearerToken, eventType, projectId, webhookId | None |
update_webhook | Update a webhook endpoint. | bearerToken, projectId, webhookId | events, filters, isEnabled, projectScope, 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 |
get_alert_group | Inspect one project-scoped alert group and a paginated page of member incident IDs without raw logs or destination secrets. | bearerToken, groupId, kind, projectId | cursor, limit |
list_alert_groups | List project-scoped alert delivery and email digest groups with bounded incident counts and no payloads or destination secrets. | bearerToken, projectId | cursor, limit |
list_alerts | List alert rules for a project. | bearerToken, projectId | limit |
rotate_alert_webhook_secret | Rotate a custom alert-webhook signing secret and reveal the new secret once. | alertId, bearerToken, projectId | None |
update_alert | Update an alert rule, including optional severity-threshold lifecycle scope. | alertId, bearerToken, projectId | channel, conditionType, config, cooldownSeconds, isEnabled, projectScope, serviceId, severityLifecycleScope, severityMin |
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 |
update_saved_analytics_funnel | Update the name or ordered steps of a saved AnalyticsBundle funnel. | bearerToken, funnelKey, projectId | displayName, steps |
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, sdkProjectId, sdkService, sdkTokenId, 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. Omit failureThreshold to use the plan recommendation. | 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 |
|---|---|---|---|
billing_plan_change | Preview or schedule Team to Solo at renewal on the same subscription, retaining extra capacity. Show the quote and Team feature loss and obtain explicit user confirmation before schedule; send that exact confirmationToken. Cancel releases only the exact scheduleId returned by status. | action, bearerToken | confirmationToken, scheduleId |
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 |
Parity rule
These entries are meant to describe the same behavior as the API and CLI equivalents, not a separate MCP-only implementation.