Skip to content
MCP server

Webhook Crash Lab

Crash-test webhook handlers for retries, duplicates and forged signatures, then re-run

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.2.4
Listing updated
today

Similar MCP servers

About Webhook Crash Lab

Webhook Crash Lab is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "webhook-crash-lab-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "webhook-crash-lab-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "webhook-crash-lab-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "webhook-crash-lab-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

MIT licence

Webhook Crash Lab 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.

How AIPoweredBot checks servers