DebugBundle

by debugbundle

313 downloads

Not rated

GitHub

About

DebugBundle turns runtime failures, critical-path issues, and availability checks into incidents with full context, alerts, remote probes, and deterministic debug bundles for humans and AI agents.

Details

Author: debugbundle
Downloads: 313
Categories: Other, Developer Tools, AI

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name DebugBundle

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "debugbundle": {
            "debugbundle": {
                "command": "npx",
                "args": [
                    "-y",
                    "@debugbundle/mcp"
                ],
                "env": {
                    "DEBUGBUNDLE_MEMBER_TOKEN": "<YOUR_OWN_DEBUGBUNDLE_MEMBER_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "debugbundle": {
            "debugbundle": {
                "command": "npx",
                "args": [
                    "-y",
                    "@debugbundle/mcp"
                ],
                "env": {
                    "DEBUGBUNDLE_MEMBER_TOKEN": "<YOUR_OWN_DEBUGBUNDLE_MEMBER_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "debugbundle": {
            "debugbundle": {
                "command": "npx",
                "args": [
                    "-y",
                    "@debugbundle/mcp"
                ],
                "env": {
                    "DEBUGBUNDLE_MEMBER_TOKEN": "<YOUR_OWN_DEBUGBUNDLE_MEMBER_TOKEN>"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "debugbundle": {
            "debugbundle": {
                "command": "npx",
                "args": [
                    "-y",
                    "@debugbundle/mcp"
                ],
                "env": {
                    "DEBUGBUNDLE_MEMBER_TOKEN": "<YOUR_OWN_DEBUGBUNDLE_MEMBER_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "debugbundle": {
            "debugbundle": {
                "command": "npx",
                "args": [
                    "-y",
                    "@debugbundle/mcp"
                ],
                "env": {
                    "DEBUGBUNDLE_MEMBER_TOKEN": "<YOUR_OWN_DEBUGBUNDLE_MEMBER_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "debugbundle": {
            "debugbundle": {
                "command": "npx",
                "args": [
                    "-y",
                    "@debugbundle/mcp"
                ],
                "env": {
                    "DEBUGBUNDLE_MEMBER_TOKEN": "<YOUR_OWN_DEBUGBUNDLE_MEMBER_TOKEN>"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "debugbundle": {
            "debugbundle": {
                "command": "npx",
                "args": [
                    "-y",
                    "@debugbundle/mcp"
                ],
                "env": {
                    "DEBUGBUNDLE_MEMBER_TOKEN": "<YOUR_OWN_DEBUGBUNDLE_MEMBER_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "debugbundle": {
            "debugbundle": {
                "command": "npx",
                "args": [
                    "-y",
                    "@debugbundle/mcp"
                ],
                "env": {
                    "DEBUGBUNDLE_MEMBER_TOKEN": "<YOUR_OWN_DEBUGBUNDLE_MEMBER_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "debugbundle": {
            "debugbundle": {
                "command": "npx",
                "args": [
                    "-y",
                    "@debugbundle/mcp"
                ],
                "env": {
                    "DEBUGBUNDLE_MEMBER_TOKEN": "<YOUR_OWN_DEBUGBUNDLE_MEMBER_TOKEN>"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "debugbundle": {
            "debugbundle": {
                "command": "npx",
                "args": [
                    "-y",
                    "@debugbundle/mcp"
                ],
                "env": {
                    "DEBUGBUNDLE_MEMBER_TOKEN": "<YOUR_OWN_DEBUGBUNDLE_MEMBER_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "debugbundle": {
            "debugbundle": {
                "command": "npx",
                "args": [
                    "-y",
                    "@debugbundle/mcp"
                ],
                "env": {
                    "DEBUGBUNDLE_MEMBER_TOKEN": "<YOUR_OWN_DEBUGBUNDLE_MEMBER_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "debugbundle": {
            "debugbundle": {
                "command": "npx",
                "args": [
                    "-y",
                    "@debugbundle/mcp"
                ],
                "env": {
                    "DEBUGBUNDLE_MEMBER_TOKEN": "<YOUR_OWN_DEBUGBUNDLE_MEMBER_TOKEN>"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "debugbundle": {
            "debugbundle": {
                "command": "npx",
                "args": [
                    "-y",
                    "@debugbundle/mcp"
                ],
                "env": {
                    "DEBUGBUNDLE_MEMBER_TOKEN": "<YOUR_OWN_DEBUGBUNDLE_MEMBER_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "debugbundle": {
            "debugbundle": {
                "command": "npx",
                "args": [
                    "-y",
                    "@debugbundle/mcp"
                ],
                "env": {
                    "DEBUGBUNDLE_MEMBER_TOKEN": "<YOUR_OWN_DEBUGBUNDLE_MEMBER_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "debugbundle": {
            "debugbundle": {
                "command": "npx",
                "args": [
                    "-y",
                    "@debugbundle/mcp"
                ],
                "env": {
                    "DEBUGBUNDLE_MEMBER_TOKEN": "<YOUR_OWN_DEBUGBUNDLE_MEMBER_TOKEN>"
                }
            }
        }
    }
}

From the repository

Install the server by adding the following configuration to your MCP client, using npx and a DebugBundle member token as the environment variable DEBUGBUNDLE_MEMBER_TOKEN. The server exposes tools for inspection and retrieval of incidents, bundles, health checks, alerts, and project administration.

`doctor`

Run local DebugBundle environment diagnostics.

`validate`

Validate local DebugBundle project setup and optionally apply fixes.

`verify_local`

Run the local verification flow against the current repository.

`verify_cloud`

Verify hosted ingestion or actively prove hosted incident creation.

`smoke`

Run the end-to-end smoke flow for a hosted project.

`analyze`

Run local agent-oriented DebugBundle analysis.

`list_incidents`

List incidents from local storage, cloud storage, or the combined connected view.

`get_incident`

Fetch a single incident by incident id.

`get_incident_context`

Fetch deterministic one-call incident context for explanation and triage.

`resolve_incident`

Resolve an incident by incident id.

`resolve_incidents`

Resolve incidents in bulk by incident id.

`reopen_incident`

Reopen an incident by incident id.

`reopen_incidents`

Reopen incidents in bulk by incident id.

`get_bundle`

Fetch the debug bundle for an incident.

`get_reproduction`

Fetch the reproduction artifact for an incident.

`get_logs`

Fetch log records for an incident from the hosted API.

`list_improvements`

List hosted improvement opportunities for the current workspace or a specific project.

`get_improvement`

Fetch a single hosted improvement opportunity by id.

`get_improvement_bundle`

Fetch the hosted improvement bundle artifact for a project improvement opportunity.

`resolve_improvement`

Resolve a hosted improvement opportunity.

`reopen_improvement`

Reopen a hosted improvement opportunity.

`snooze_improvement`

Snooze a hosted improvement opportunity until an ISO8601 timestamp.

`get_github_status`

Get the project GitHub App installation status and optional project repo assignment.

`list_github_repositories`

List repositories available to the project GitHub App installation for owner/admin callers.

`list_github_dispatch_rules`

List GitHub dispatch automation rules for a project.

`create_github_dispatch_rule`

Create a GitHub dispatch automation rule for a project.

`update_github_dispatch_rule`

Update a GitHub dispatch automation rule.

`delete_github_dispatch_rule`

Delete a GitHub dispatch automation rule.

`list_github_deliveries`

List GitHub dispatch delivery history for a project.

`retry_github_delivery`

Retry a failed GitHub dispatch delivery.

`set_project_github_repo`

Assign a primary GitHub repository to a project.

`remove_project_github_repo`

Remove a project GitHub repository assignment.

`list_project_tokens`

List project tokens for a project.

`create_project_token`

Create a new project token.

`revoke_project_token`

Revoke a project token.

`list_member_tokens`

List member tokens for the authenticated member.

`create_member_token`

Create a new member token.

`revoke_member_token`

Revoke a member token.

`list_webhooks`

List webhooks for a project.

`create_webhook`

Create a webhook endpoint.

`update_webhook`

Update a webhook endpoint.

`delete_webhook`

Delete a webhook endpoint.

`test_webhook`

Queue a synthetic webhook delivery.

`list_webhook_deliveries`

List deliveries for a webhook endpoint.

`retry_webhook_delivery`

Retry a webhook delivery.

`list_slack_destinations`

List reusable connected Slack destinations for a project organization.

`get_slack_connect_url`

Return a browser Slack connect URL for a project.

`test_slack_destination`

Send a test message to a connected Slack destination.

`delete_slack_destination`

Delete a connected Slack destination from a project organization.

`list_weekly_report_channels`

List weekly report delivery channels for a project.

`create_weekly_report_channel`

Create a weekly report delivery channel. Email channel config supports up to 3 recipients in config.to.

`update_weekly_report_channel`

Update a weekly report delivery channel. Email channel config supports up to 3 recipients in config.to.

`delete_weekly_report_channel`

Delete a weekly report delivery channel.

`list_alerts`

List alert rules for a project.

`create_alert`

Create an alert rule, including optional severity-threshold lifecycle scope.

`update_alert`

Update an alert rule, including optional severity-threshold lifecycle scope.

`delete_alert`

Delete an alert rule.

`list_projects`

List projects in the organization.

`create_project`

Create a new project.

`update_project`

Update a project.

`delete_project`

Delete a project.

`list_capture_rules`

List project capture rules.

`create_capture_rule`

Create a project capture rule.

`update_capture_rule`

Update a project capture rule.

`delete_capture_rule`

Delete a project capture rule.

`suggest_capture_rules_from_incident`

Generate deterministic capture rule suggestions from an incident bundle.

`create_capture_rule_from_incident_suggestion`

Create a capture rule from an incident-derived suggestion.

`get_usage_summary`

Get aggregate AnalyticsBundle usage summary metrics for a project.

`get_route_metrics`

Get aggregate AnalyticsBundle route metrics for a project.

`get_journey_patterns`

Get aggregate AnalyticsBundle journey transition patterns for a project.

`list_analytics_journey_samples`

List retained redacted AnalyticsBundle journey sample metadata for a project.

`get_analytics_journey_sample`

Get one retained redacted AnalyticsBundle journey sample artifact for a project.

`get_device_breakdown`

Get aggregate AnalyticsBundle device, browser, OS, and language breakdowns.

`get_referrer_metrics`

Get aggregate AnalyticsBundle referrer and UTM metrics.

`get_action_metrics`

Get aggregate AnalyticsBundle action, marker, and conversion metrics.

`list_funnel_metrics`

List aggregate AnalyticsBundle funnel conversion summaries for a project.

`get_funnel_analysis`

Get aggregate AnalyticsBundle funnel conversion and dropoff analysis.

`get_incident_impact`

Get aggregate AnalyticsBundle impact metrics for one incident, including linked routes, funnels, segments, journeys, and bundle state.

`list_analytics_opportunities`

List AnalyticsBundle opportunities for a project, or across accessible projects when projectId is omitted.

`get_analytics_opportunity`

Get an AnalyticsBundle opportunity for a project.

`list_analytics_bundles`

List AnalyticsBundle generation records for a project, or across accessible projects when projectId is omitted.

`generate_analytics_bundle`

Request an AnalyticsBundle generation for a project analysis window and focus.

`get_analytics_bundle`

Get a generated AnalyticsBundle artifact or its pending/failed generation state.

`get_analytics_settings`

Get AnalyticsBundle settings for a project.

`update_analytics_settings`

Update AnalyticsBundle settings for a project.

`list_saved_analytics_funnels`

List active saved AnalyticsBundle funnel definitions for a project.

`create_saved_analytics_funnel`

Create a reusable AnalyticsBundle funnel definition for a project.

`update_saved_analytics_funnel`

Update the name or ordered steps of a saved AnalyticsBundle funnel.

`archive_saved_analytics_funnel`

Archive a saved AnalyticsBundle funnel definition for a project.

`get_capture_policy`

Get the resolved capture policy for a project.

`update_capture_policy`

Update the capture policy for a project.

`get_improvement_settings`

Get automated improvement settings for a project.

`update_improvement_settings`

Update automated improvement settings for a project.

`activate_probe`

Activate a remote probe on a project.

`list_active_probes`

List active probe activations for a project.

`deactivate_probe`

Deactivate a probe activation.

`list_health_checks`

List hosted health checks for a project.

`get_health_check`

Get one hosted health check by id.

`create_health_check`

Create a hosted health check for a project.

`update_health_check`

Update a hosted health check.

`delete_health_check`

Delete a hosted health check.

`test_health_check`

Run a side-effect-free test for a hosted health-check target.

`list_health_check_results`

List recent execution results for one hosted health check.

`list_health_check_daily_rollups`

List retained per-day history for one hosted health check.

`get_billing_summary`

Get the billing summary for the organization.

`start_trial`

Start an eligible no-card trial for the organization.

`increase_capacity`

Increase additional capacity units.

`schedule_capacity_reduction`

Schedule a capacity reduction at end of billing cycle.

`cancel_capacity_reduction`

Cancel a scheduled capacity reduction.

`list_project_members`

List members for a project.

`list_project_member_invites`

List pending invites for a project.

`invite_project_member`

Invite a collaborator to a project.

`cancel_project_member_invite`

Cancel a pending project invite.

`update_project_member_role`

Update the role of a project collaborator.

`remove_project_member`

Remove a collaborator from a project.

`leave_project`

Leave a shared project as the authenticated collaborator.

`list_services`

List services for a project.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "debugbundle": {
            "debugbundle": {
                "command": "npx",
                "args": [
                    "-y",
                    "@debugbundle/mcp"
                ],
                "env": {
                    "DEBUGBUNDLE_MEMBER_TOKEN": "<YOUR_OWN_DEBUGBUNDLE_MEMBER_TOKEN>"
                }
            }
        }
    }
}

McpServers

{
    "debugbundle": {
        "command": "npx",
        "args": [
            "-y",
            "@debugbundle/mcp"
        ],
        "env": {
            "DEBUGBUNDLE_MEMBER_TOKEN": "<YOUR_OWN_DEBUGBUNDLE_MEMBER_TOKEN>"
        }
    }
}

Production debugging bundles for AI agents.

DebugBundle turns production incidents into deterministic debug bundles for AI agents. Agents can inspect incidents, bundles, reproductions, probes, hosted health checks, alerts, webhooks, projects, and setup state through API, CLI, or MCP.

Install

json

{

  "mcpServers": {

    "debugbundle": {

      "command": "npx",

      "args": ["-y", "@debugbundle/mcp"],

      "env": {

        "DEBUGBUNDLE_MEMBER_TOKEN": "<YOUR_OWN_DEBUGBUNDLE_MEMBER_TOKEN>"

      }

    }

  }

}





Authentication






- Use a DebugBundle member token for MCP access.

- Do not use a project token for MCP management or retrieval.

- Local users can also reuse existing CLI auth state at

~/.debugbundle/auth.json`.

Links

- Docs: https://debugbundle.com/docs/mcp
- GitHub: https://github.com/debugbundle/debugbundle
- MCP package: https://www.npmjs.com/package/@debugbundle/mcp
- MCP source folder: https://github.com/debugbundle/debugbundle/tree/main/apps/mcp

What it exposes

- Incident listing and inspection
- Bundle and reproduction retrieval
- Health checks and probes
- Alerts and webhooks
- Project, member, token, billing, and setup tools

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

doctor

validate

verify_local

verify_cloud

smoke

analyze

list_incidents

get_incident

get_incident_context

resolve_incident

resolve_incidents

reopen_incident

reopen_incidents

get_bundle

get_reproduction

get_logs

list_improvements

get_improvement

get_improvement_bundle

resolve_improvement

reopen_improvement

snooze_improvement

get_github_status

list_github_repositories

list_github_dispatch_rules

create_github_dispatch_rule

update_github_dispatch_rule

delete_github_dispatch_rule

list_github_deliveries

retry_github_delivery

set_project_github_repo

remove_project_github_repo

list_project_tokens

create_project_token

revoke_project_token

list_member_tokens

create_member_token

revoke_member_token

list_webhooks

create_webhook

update_webhook

delete_webhook

test_webhook

list_webhook_deliveries

retry_webhook_delivery

list_slack_destinations

get_slack_connect_url

test_slack_destination

delete_slack_destination

list_weekly_report_channels

create_weekly_report_channel

update_weekly_report_channel

delete_weekly_report_channel

list_alerts

create_alert

update_alert

delete_alert

list_projects

create_project

update_project

delete_project

list_capture_rules

create_capture_rule

update_capture_rule

delete_capture_rule

suggest_capture_rules_from_incident

create_capture_rule_from_incident_suggestion

get_usage_summary

get_route_metrics

get_journey_patterns

list_analytics_journey_samples

get_analytics_journey_sample

get_device_breakdown

get_referrer_metrics

get_action_metrics

`doctor`

`validate`

`verify_local`

`verify_cloud`

`smoke`

`analyze`

`list_incidents`

`get_incident`

`get_incident_context`

`resolve_incident`

`resolve_incidents`

`reopen_incident`

`reopen_incidents`

`get_bundle`

`get_reproduction`

`get_logs`

`list_improvements`

`get_improvement`

`get_improvement_bundle`

`resolve_improvement`

`reopen_improvement`

`snooze_improvement`

`get_github_status`

`list_github_repositories`

`list_github_dispatch_rules`

`create_github_dispatch_rule`

`update_github_dispatch_rule`

`delete_github_dispatch_rule`

`list_github_deliveries`

`retry_github_delivery`

`set_project_github_repo`

`remove_project_github_repo`

`list_project_tokens`

`create_project_token`

`revoke_project_token`

`list_member_tokens`

`create_member_token`

`revoke_member_token`

`list_webhooks`

`create_webhook`

`update_webhook`

`delete_webhook`

`test_webhook`

`list_webhook_deliveries`

`retry_webhook_delivery`

`list_slack_destinations`

`get_slack_connect_url`

`test_slack_destination`

`delete_slack_destination`

`list_weekly_report_channels`

`create_weekly_report_channel`

`update_weekly_report_channel`

`delete_weekly_report_channel`

`list_alerts`

`create_alert`

`update_alert`

`delete_alert`

`list_projects`

`create_project`

`update_project`

`delete_project`

`list_capture_rules`

`create_capture_rule`

`update_capture_rule`

`delete_capture_rule`

`suggest_capture_rules_from_incident`

`create_capture_rule_from_incident_suggestion`

`get_usage_summary`

`get_route_metrics`

`get_journey_patterns`

`list_analytics_journey_samples`

`get_analytics_journey_sample`

`get_device_breakdown`

`get_referrer_metrics`

`get_action_metrics`

`list_funnel_metrics`

`get_funnel_analysis`

`get_incident_impact`

`list_analytics_opportunities`

`get_analytics_opportunity`