MCP Tools Reference
Complete catalog of DebugBundle MCP tools with parameters and examples.
This page documents every tool the DebugBundle MCP server exposes. Hosted tools can authenticate
with DEBUGBUNDLE_MEMBER_TOKEN in the MCP server environment, CLI auth state from
~/.debugbundle/auth.json, or an optional per-call bearerToken parameter. bearerToken is
omitted from parameter tables below for brevity.
Setup & Diagnostics
doctor
Run a full connectivity and configuration check.
| Parameter | Type | Description |
|---|---|---|
| (none) | — | Validates local setup, checks API reachability, verifies auth state. |
Returns a diagnostic report with pass/fail status for each check.
validate
Validate your local DebugBundle configuration files.
| Parameter | Type | Description |
|---|---|---|
fix | boolean | Optional. Recreate missing generated setup files when true. |
verify_local
Verify local-mode setup (CLI installed, log directory writable, parser available).
| Parameter | Type | Description |
|---|---|---|
| (none) | — | Checks local-only prerequisites. |
verify_cloud
Verify cloud connectivity (API reachable, token valid, project accessible) or actively prove hosted incident creation.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. Cloud project ID. |
service | string | Optional service filter for passive checks and synthetic verification events. |
environment | string | Optional environment filter for passive checks and synthetic verification events. |
maxAgeMinutes | number | Optional lookback window for passive incident checks. |
trigger5xx | boolean | Optional. Send a synthetic 503 request event and verify hosted incident plus bundle visibility. |
trigger4xxStatus | number | Optional. Send a synthetic 400-499 client-error request event and verify hosted incident plus bundle visibility. |
trigger4xxStatus succeeds only when the target project's capture policy promotes that status. It is mutually exclusive with trigger5xx.
smoke
Run a quick smoke test that sends a test event and verifies end-to-end processing.
| Parameter | Type | Description |
|---|---|---|
project_id | string | Optional. Target project for the test event. |
Incident Retrieval
list_incidents
List incidents for the active project.
| Parameter | Type | Description |
|---|---|---|
source | string | Filter by source: local, cloud, or all. Default: all. |
projectId | string | Optional project filter. |
environment | string | Optional environment filter. |
service | string | Filter by service name. |
status | string | Filter: active, open, resolved, regressed, or all. Default: active; active means open or regressed. |
severity | string | Filter by severity: low, medium, high, or critical. |
firstSeenAfter | string | Optional ISO-8601 lower bound for first_seen_at. |
attentionAfter | string | Optional ISO-8601 lower bound for incidents opened or regressed after this time. |
cursor | string | Optional pagination cursor. |
limit | number | Max results. Default: 20. |
get_incident
Get full details of a specific incident.
| Parameter | Type | Description |
|---|---|---|
incident_id | string | Required. The incident ID. |
resolve_incident
Mark an incident as resolved.
| Parameter | Type | Description |
|---|---|---|
incidentId | string | Required. The incident ID. |
resolve_incidents
Mark incidents as resolved in bulk.
| Parameter | Type | Description |
|---|---|---|
incidentIds | string[] | Required. Incident IDs to resolve. |
reopen_incident
Reopen a previously resolved incident.
| Parameter | Type | Description |
|---|---|---|
incidentId | string | Required. The incident ID. |
reopen_incidents
Reopen incidents in bulk.
| Parameter | Type | Description |
|---|---|---|
incidentIds | string[] | Required. Incident IDs to reopen. |
get_bundle
Retrieve the debug bundle for an incident.
| Parameter | Type | Description |
|---|---|---|
incident_id | string | Required. The incident ID. |
format | string | Output format: json (default) or summary. |
get_reproduction
Get the reproduction artifact for an incident.
| Parameter | Type | Description |
|---|---|---|
incident_id | string | Required. The incident ID. |
Returns reproduction commands (cURL, HTTPie) and JSON specifications when available.
get_logs
Retrieve raw log entries associated with an incident.
| Parameter | Type | Description |
|---|---|---|
incident_id | string | Required. The incident ID. |
limit | number | Max log entries. Default: 100. |
Token Management
list_project_tokens
List project tokens (SDK/ingestion tokens).
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. Project that owns the tokens. |
limit | number | Optional maximum number of tokens to return. |
create_project_token
Create a new project token for SDK ingestion.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. Project that owns the token. |
label | string | Required. Human-readable token label. |
allowedOrigins | string[] | Optional origin allowlist for direct/static browser ingestion. |
Returns the token plaintext once — store it immediately. Use allowedOrigins only for public write-only project tokens intentionally embedded in static browser apps. Allowlisted tokens reject requests without a matching Origin, so do not reuse them for server SDKs or relay forwarding. This reduces normal browser-origin abuse but is not a secret boundary.
revoke_project_token
Revoke a project token.
| Parameter | Type | Description |
|---|---|---|
token_id | string | Required. The token ID to revoke. |
list_member_tokens
List member tokens (CLI/API/MCP tokens).
| Parameter | Type | Description |
|---|
create_member_token
Create a new member token.
| Parameter | Type | Description |
|---|---|---|
label | string | Required. Human-readable token label. |
Returns the token plaintext once — store it immediately.
revoke_member_token
Revoke a member token.
| Parameter | Type | Description |
|---|---|---|
token_id | string | Required. The token ID to revoke. |
Webhook Management
list_webhooks
List configured webhook endpoints.
| Parameter | Type | Description |
|---|---|---|
project_id | string | Optional. Defaults to active project. |
create_webhook
Create a new webhook endpoint.
| Parameter | Type | Description |
|---|---|---|
project_id | string | Optional. Defaults to active project. |
url | string | Required. The webhook delivery URL. |
events | string[] | Event types to subscribe to. Default: all events. |
secret | string | Optional signing secret for HMAC verification. |
update_webhook
Update an existing webhook.
| Parameter | Type | Description |
|---|---|---|
webhook_id | string | Required. The webhook ID. |
url | string | New delivery URL. |
events | string[] | Updated event subscriptions. |
is_active | boolean | Enable or disable the webhook. |
delete_webhook
Delete a webhook endpoint.
| Parameter | Type | Description |
|---|---|---|
webhook_id | string | Required. The webhook ID. |
test_webhook
Send a test delivery to a webhook endpoint.
| Parameter | Type | Description |
|---|---|---|
webhook_id | string | Required. The webhook ID. |
list_webhook_deliveries
List recent deliveries for a webhook.
| Parameter | Type | Description |
|---|---|---|
webhook_id | string | Required. The webhook ID. |
limit | number | Max results. Default: 20. |
retry_webhook_delivery
Retry a failed webhook delivery.
| Parameter | Type | Description |
|---|---|---|
delivery_id | string | Required. The delivery ID. |
Alert Management
list_alerts
List configured alert rules.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. Project that owns the alert rules. |
limit | number | Optional maximum number of alerts to return. |
create_alert
Create a new alert rule.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. Project that owns the alert rule. |
serviceId | string | Optional service scope. |
channel | string | Required. Alert channel: email, slack, discord, webhook. |
conditionType | string | Required. Trigger: new_incident, incident_regressed, error_spike, severity_threshold, regression_after_deploy. |
severityMin | string | Minimum severity filter. |
cooldownSeconds | number | Optional notification cooldown in seconds. Defaults to 0, accepts 0 to disable suppression, max 604800 (7 days). |
config | object | Required. Channel-specific configuration. |
isEnabled | boolean | Optional enabled state. Defaults to true. |
severityMin: "high" does not match low-confidence opaque browser-native captures by
default: opaque window_error infers low, and opaque resource_error infers
medium.
update_alert
Update an existing alert rule.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. Project that owns the alert rule. |
alertId | string | Required. The alert ID. |
serviceId | string | null | Update or clear service scope. |
channel | string | Updated channel type. |
conditionType | string | Updated trigger condition. |
severityMin | string | null | Updated or cleared severity filter. |
cooldownSeconds | number | Updated notification cooldown in seconds. Use 0 to disable suppression. |
isEnabled | boolean | Enable or disable the alert. |
config | object | Updated channel configuration. |
delete_alert
Delete an alert rule.
| Parameter | Type | Description |
|---|---|---|
alert_id | string | Required. The alert ID. |
Slack Destinations
list_slack_destinations
List connected Slack destinations for a project organization.
Saved destinations remain readable after a downgrade to Free so agents can inspect the paused setup before the owner upgrades again.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. Project whose organization owns the destinations. |
get_slack_connect_url
Return a browser URL for Slack OAuth and channel selection.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. Project to return to after connection. |
returnTo | string | Optional app-relative return path. |
test_slack_destination
Send a test message to a connected Slack destination.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. Project whose organization owns the destination. |
destinationId | string | Required. Slack destination ID. |
delete_slack_destination
Delete a connected Slack destination when no alert rule or weekly report still references it. This cleanup action remains available after downgrade.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. Project whose organization owns the destination. |
destinationId | string | Required. Slack destination ID. |
Weekly Reports
list_weekly_reports
List available weekly reports.
| Parameter | Type | Description |
|---|---|---|
project_id | string | Optional. Defaults to active project. |
limit | number | Max results. Default: 10. |
get_weekly_report
Get a specific weekly report with full analysis.
| Parameter | Type | Description |
|---|---|---|
report_id | string | Required. The report ID. |
generate_weekly_report
Trigger generation of a new weekly report.
| Parameter | Type | Description |
|---|---|---|
project_id | string | Optional. Defaults to active project. |
configure_weekly_reports
Configure weekly report settings.
| Parameter | Type | Description |
|---|---|---|
project_id | string | Optional. Defaults to active project. |
is_enabled | boolean | Enable or disable weekly reports. |
recipients | string[] | Email addresses to receive reports. |
Services
list_services
List all services discovered from ingested events.
| Parameter | Type | Description |
|---|---|---|
project_id | string | Optional. Defaults to active project. |
Projects
list_projects
List projects in the organization.
| Parameter | Type | Description |
|---|---|---|
limit | number | Max results to return. |
create_project
Create a new project.
| Parameter | Type | Description |
|---|---|---|
name | string | Required. Human-readable project name. |
slug | string | Required. URL-friendly identifier (lowercase, hyphens). |
environmentDefault | string | Editable project default environment used in setup snippets and project metadata (for example production). |
update_project
Update an existing project.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. The project ID. |
name | string | New project name. |
slug | string | New URL-friendly identifier. |
environmentDefault | string | New editable project default environment. |
delete_project
Delete a project and all associated data.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. The project ID. |
Health Checks
list_health_checks
List hosted health checks for a project, including current plan limits.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. Project that owns the hosted health checks. |
limit | number | Optional maximum number of checks to return. |
get_health_check
Get one hosted health check by id.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. Project that owns the check. |
checkId | string | Required. Health check ID. |
create_health_check
Create a hosted health check for a public HTTP endpoint.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. Project that owns the check. |
name | string | Required. Human-readable check name. |
url | string | Required. External http or https URL. |
intervalSeconds | number | Required. Execution interval in seconds, subject to plan minimums. |
method | string | Optional GET or HEAD. Defaults to GET. |
expectedStatusMin | number | Optional lowest successful status. Defaults to 200. |
expectedStatusMax | number | Optional highest successful status. Defaults to 399. |
timeoutMs | number | Optional request timeout in milliseconds. |
failureThreshold | number | Optional consecutive failures required to open or regress an incident. |
recoveryThreshold | number | Optional consecutive successes required to recover. |
environment | string | Optional environment label. |
serviceName | string | null | Optional service label; pass null to clear on update. |
enabled | boolean | Optional enabled state. Disabled checks remain visible but do not execute. |
update_health_check
Update a hosted health check. Use this to change thresholds, status expectations, labels, or enabled state.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. Project that owns the check. |
checkId | string | Required. Health check ID. |
name | string | Optional new name. |
url | string | Optional new target URL. |
intervalSeconds | number | Optional execution interval in seconds. |
method | string | Optional GET or HEAD. |
expectedStatusMin | number | Optional lowest successful status. |
expectedStatusMax | number | Optional highest successful status. |
timeoutMs | number | Optional request timeout in milliseconds. |
failureThreshold | number | Optional consecutive failures required to open or regress an incident. |
recoveryThreshold | number | Optional consecutive successes required to recover. |
environment | string | Optional environment label. |
serviceName | string | null | Optional service label; pass null to clear. |
enabled | boolean | Optional enabled state. |
delete_health_check
Delete a hosted health check.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. Project that owns the check. |
checkId | string | Required. Health check ID. |
test_health_check
Run a side-effect-free target test using the same validation and guarded request execution as saved checks. This does not create incidents, retained result rows, or rollups.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. Project used for authorization and plan context. |
url | string | Required. External http or https URL to test. |
method | string | Optional GET or HEAD. Defaults to GET. |
expectedStatusMin | number | Optional lowest successful status. |
expectedStatusMax | number | Optional highest successful status. |
timeoutMs | number | Optional request timeout in milliseconds. |
list_health_check_results
List recent execution results for one hosted health check.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. Project that owns the check. |
checkId | string | Required. Health check ID. |
limit | number | Optional maximum number of results to return. |
list_health_check_daily_rollups
List retained per-day status history for one hosted health check.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. Project that owns the check. |
checkId | string | Required. Health check ID. |
limit | number | Optional maximum number of rollups to return. |
Probes
activate_probe
Activate a remote debug probe on a project.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. The project ID. |
labelPattern | string | Required. Glob pattern matching incident labels (e.g., auth.*). |
service | string | Scope to a specific service name. |
environment | string | Scope to a specific environment. |
ttlSeconds | number | Probe lifetime in seconds. Default: 3600. Max: 86400. |
triggerTtlSeconds | number | Trigger token validity in seconds. Default: 300. |
Returns the probe object including a one-time trigger_token.
list_active_probes
List active probes for a project.
Saved remote probe activations remain readable after a downgrade to Free so agents can inspect the paused setup before the owner upgrades again.
Probe deactivation remains available as cleanup after downgrade; new remote activation requires the project to return to Solo or Team.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. The project ID. |
deactivate_probe
Deactivate a probe.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. The project ID. |
activationId | string | Required. The probe activation ID. |
Capture Policy
get_capture_policy
Get the resolved capture policy for a project.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. The project ID. |
update_capture_policy
Update the capture policy for a project.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. The project ID. |
update | object | Required. Policy update with optional fields: preset, capture_logs, capture_request_events, capture_breadcrumbs, capture_probe_events, immediate_client_error_statuses, and immediate_client_error_path_rules. Path rules use status_code, path_pattern, and optional methods to promote only matching 4xx combinations, such as 404 under /checkout/*. |
Capture Rules
list_capture_rules
List project capture rules.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. The project ID. |
create_capture_rule
Create a project capture rule.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. The project ID. |
rule | object | Required. Rule payload with action, matcher, and optional sample fields. |
update_capture_rule
Update a project capture rule.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. The project ID. |
ruleId | string | Required. The capture rule ID. |
update | object | Required. Partial rule update. |
delete_capture_rule
Delete a project capture rule.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. The project ID. |
ruleId | string | Required. The capture rule ID. |
suggest_capture_rules_from_incident
Suggest capture rules from an incident bundle without changing project state.
| Parameter | Type | Description |
|---|---|---|
incidentId | string | Required. The incident ID. |
create_capture_rule_from_incident_suggestion
Create a project capture rule from one of the incident suggestions.
| Parameter | Type | Description |
|---|---|---|
incidentId | string | Required. The incident ID. |
suggestionId | string | Required. The suggestion ID returned by suggest_capture_rules_from_incident. |
name | string | Optional override for the rule name. |
description | string | Optional override for the rule description. |
enabled | boolean | Optional initial enabled state. |
expiresAt | string | Optional ISO timestamp for automatic expiry. |
Billing
get_billing_summary
Get the billing summary for the organization.
| Parameter | Type | Description |
|---|---|---|
| (none beyond auth) | — | Returns plan, billing state, trial state, active-project counts, capacity units, and scheduled reduction info. |
start_trial
Start an eligible no-card trial for the organization.
| Parameter | Type | Description |
|---|---|---|
targetPlan | string | Required. solo or team. |
increase_capacity
Add extra capacity units with prorated billing.
| Parameter | Type | Description |
|---|---|---|
targetAdditionalCapacityUnits | number | Required. Target number of additional capacity units. Active no-card trials receive trial_conversion_required. |
schedule_capacity_reduction
Schedule a capacity reduction at the end of the billing cycle.
| Parameter | Type | Description |
|---|---|---|
targetAdditionalCapacityUnits | number | Required. Target number of additional capacity units after reduction. Active no-card trials receive trial_conversion_required. |
cancel_capacity_reduction
Cancel a scheduled capacity reduction.
| Parameter | Type | Description |
|---|---|---|
| (none beyond auth) | — | Cancels the pending reduction, keeping current capacity count. Active no-card trials receive trial_conversion_required. |
Members
list_project_members
List members for a project.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. The project ID. |
list_project_member_invites
List pending invites for a project.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. The project ID. |
invite_project_member
Invite a collaborator to a project.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. The project ID. |
email | string | Required. Email address for the invitation. |
role | string | Required. Member role (e.g., admin, member). |
cancel_project_member_invite
Cancel a pending invitation.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. The project ID. |
inviteId | string | Required. The invite ID to cancel. |
update_project_member_role
Update the role of a project member.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. The project ID. |
userId | string | Required. The user ID. |
role | string | Required. The new role. |
remove_project_member
Remove a member from a project.
| Parameter | Type | Description |
|---|---|---|
projectId | string | Required. The project ID. |
userId | string | Required. The user ID to remove. |
Analysis
analyze
Run deep analysis on an incident, combining bundle data, logs, and reproduction artifacts.
| Parameter | Type | Description |
|---|---|---|
incident_id | string | Required. The incident ID. |
Returns a structured analysis including root cause hypothesis, affected components, severity assessment, and suggested fixes.
Next Steps
- MCP Server — Overview and authentication
- MCP Workflows — Practical agent patterns