# Webhook Crash Lab

> Webhook Crash Lab is an open-source MCP server for developer tools. Crash-test webhook handlers for retries, duplicates and forged signatures, then re-run. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/krrishkumar125/webhook-crash-lab-mcp
- **MCP Registry name:** io.github.Krrishkumar125/webhook-crash-lab-mcp
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Webhook handlers written by coding agents often pass a single test event and fail in production when a provider retries, sends a duplicate or delivers a forged signature. This server wraps the webhook-crash-lab CLI so an agent can run it, read structured failures with fix hints in fix order, edit the handler and run again until it survives.

Results arrive both as text and as structured content with an output schema, and problems such as a bad config return error results rather than crashes. The package also ships a Claude Code plugin, a portable skill for Codex and other agents, and an AGENTS.md snippet to make the loop a standing rule.

A safety note in the README: run_crash_lab imports your config file, which is code, and sends requests to its target, so only point it at a local server with a test database and test secrets, never production.

## Features

- **Failure loop:** Run, read failures with fix hints, fix and re-run.
- **Built-in demo:** A broken and fixed demo app needs no config.
- **Structured output:** Returns counts, failures in fix order and not-tested items.
- **Report explanation:** Explains a JSON report from CI.
- **Agent skill bundle:** Includes a Claude Code plugin and a portable skill.

## Good for

- Harden a Stripe webhook handler against retries
- Reproduce duplicate-delivery bugs with an agent
- Explain a CI crash-lab report
- Check handlers for forged signatures

## Install

### Claude Code (Terminal)

```sh
claude mcp add webhook-crash-lab-mcp -- npx -y webhook-crash-lab-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "webhook-crash-lab-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "webhook-crash-lab-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "webhook-crash-lab-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "webhook-crash-lab-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "webhook-crash-lab-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "webhook-crash-lab-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "webhook-crash-lab-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "webhook-crash-lab-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "webhook-crash-lab-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "webhook-crash-lab-mcp"
      ]
    }
  }
}
```

## Tools

- `run_crash_lab`: Runs the crash lab against a config and returns failures with fixes.
- `run_demo`: Runs the built-in demo app in broken or fixed mode.
- `explain_report`: Explains a report from a prior run or CI.
- `list_scenarios`: Lists every scenario with what, why and fix.

## FAQ

### Which tools does it expose?

run_crash_lab, run_demo, explain_report and list_scenarios.

### Is it safe to point at production?

No. The README says to use a local server, a test database and test secrets only.

### How do I try it?

Ask your agent to run the webhook crash lab demo.

### What licence?

MIT.

### Is Webhook Crash Lab free?

Yes. Webhook Crash Lab is open source, so you can use and self-host it for free.

### How do I add Webhook Crash Lab to Claude Code?

Run this command in your terminal: claude mcp add webhook-crash-lab-mcp -- npx -y webhook-crash-lab-mcp

### What are the best alternatives to Webhook Crash Lab?

The closest alternatives to Webhook Crash Lab are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/webhook-crash-lab
