Echoproof
Replays recorded HTTP traffic on old and new builds to flag unintended behavior changes
- Pricing
- Open source
- Platforms
- macOS, Linux, CLI
- Runs
- Locally
- Version
- 0.4.0
- Listing updated
- today
Similar MCP servers
About Echoproof
Echoproof is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Echoproof checks whether a code change altered API behaviour, using real traffic instead of hand-written tests. It runs a reverse proxy that records requests and responses with sensitive data masked, replays them against the old and new builds on the same data, compares JSON field by field and groups the differences by endpoint into breaking, behaviour and additive changes.
Its distinguishing step is judging each change against intent: given a pull request description or task and the code diff, Claude assesses whether a difference was meant, and unexplained changes are flagged as regressions. The README's example is a PR meant to add a currency field that also shifted prices on three of eight menu items, which tests and code review missed. It copes with noise by recognising IDs and timestamps, learns self-changing fields by replaying the old build twice, and avoids replaying write requests unless allowed per endpoint.
It can gate CI through exit codes, write Markdown for PR comments, emit JSON, or run as an MCP server for coding agents. The README is written in Indonesian, with an English edition. Install through Homebrew, release binaries or Cargo; an Anthropic API key is only needed for intent judging.
Install
Run in a terminal
claude mcp add echoproof --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' -- npx -y echoproofAdd to claude_desktop_config.json
{
"mcpServers": {
"echoproof": {
"command": "npx",
"args": [
"-y",
"echoproof"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"echoproof": {
"command": "npx",
"args": [
"-y",
"echoproof"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"echoproof": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"echoproof"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"echoproof": {
"command": "npx",
"args": [
"-y",
"echoproof"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"echoproof": {
"command": "npx",
"args": [
"-y",
"echoproof"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
ANTHROPIC_API_KEYUsed only when a check is given an intent to judge.
What it does
- Traffic recording
- Reverse proxy that records requests with sensitive data masked.
- Semantic diff
- Compares JSON per field and classifies breaking, behaviour and additive changes.
- Noise handling
- Ignores IDs, timestamps and fields that change between runs.
- Intent judging
- Uses Claude to assess changes against a PR description and diff.
- Safe write handling
- Skips write requests unless explicitly allowed per endpoint.
- CI and agent use
- Exit codes, Markdown and JSON reports and an MCP server.
Good for
- Verify an agent-written pull request did not change API behaviour
- Gate merges in CI on unexpected response changes
- Catch partial regressions that unit tests miss
- Comment a change report on a pull request
Pricing
Open source
Open source; Anthropic API key needed only for intent judging
Echoproof FAQ
Does it need an API key?
Only an Anthropic key, and only when checks are given an intent to judge.
How do I install it?
With Homebrew, a release binary or cargo install echoproof.
What do the exit codes mean?
0 means no unexpected change, 1 a regression and 2 an error.
Is it safe for stateful services?
Base and new builds run on the same data with resets between rounds, and writes are not replayed unless allowed.
Is Echoproof free?
Yes. Echoproof is open source, so you can use and self-host it for free.
How do I add Echoproof to Claude Code?
Run this command in your terminal: claude mcp add echoproof --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' -- npx -y echoproof
What are the best alternatives to Echoproof?
The closest alternatives to Echoproof 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.


