
BugProof
Wraps the BugProof CLI for capturing, replaying, and analyzing executable bug artifacts inside Claude and other MCP hosts. Exposes 10 tools including capture (wrap failing commands), replay (run .bug files and verify failures), inspect (read artifact metadata), and diff (compare two captures). Also surfaces Resources for reading raw .bug contents and Prompts for workflows like "replay and analyze root cause." Useful when you're debugging flaky tests or environment-specific failures and want the agent to capture the exact failure state, replay it deterministically, or compare artifacts from CI versus local runs. Communicates over stdio and shells out to the local bugproof CLI with JSON output.
- tools
- 10
- transport
- STDIO
- last updated
- May 31, 2026
Tools
10 toolsPublic tool metadata for what this MCP can expose to an agent.
captureRun a command, capture as .bug artifact
Run a command, capture as .bug artifact
No parameter schema in public metadata yet.
replayReplay a .bug file, return verdict
Replay a .bug file, return verdict
No parameter schema in public metadata yet.
inspectShow artifact metadata
Show artifact metadata
No parameter schema in public metadata yet.
diffCompare two artifacts
Compare two artifacts
No parameter schema in public metadata yet.
doctorCheck sandbox capabilities
Check sandbox capabilities
No parameter schema in public metadata yet.
shareShare artifact via GitHub Gist
Share artifact via GitHub Gist
No parameter schema in public metadata yet.
pullDownload artifact from Gist
Download artifact from Gist
No parameter schema in public metadata yet.
watchAuto-capture on command failure
Auto-capture on command failure
No parameter schema in public metadata yet.
listList .bug artifacts in directory
List .bug artifacts in directory
No parameter schema in public metadata yet.
cleanRemove .bug artifacts
Remove .bug artifacts
No parameter schema in public metadata yet.
Sponsors
Readme
BugProof
Executable bugs, not bug reports.
Capture a failing command into a portable .bug artifact that anyone can replay on their machine — same code, same env, same failure. Cryptographically signable. Cross-platform. Zero containers required.
https://github.com/user-attachments/assets/2315cfee-3ccf-40d7-830e-3a3d23731ab8
Why BugProof
"Works on my machine" is not a bug report.
Details
- Repository
- github.com/sidinsearch/bugproof
- Website
- github.com/sidinsearch/BugProof
- Package
bugproof- Transport
- STDIO
- Registry
- MCP registry, active