Webhook Crash Lab
Crash-test webhook handlers for retries, duplicates and forged signatures, then re-run
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"webhook-crash-lab-mcp": {
"command": "npx",
"args": [
"-y",
"webhook-crash-lab-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"webhook-crash-lab-mcp": {
"command": "npx",
"args": [
"-y",
"webhook-crash-lab-mcp"
]
}
}
}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.


