Skip to content
MCP server

Echoproof

Replays recorded HTTP traffic on old and new builds to flag unintended behavior changes

Runs locallyStatus and history
Install
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 echoproof

Add 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.

How AIPoweredBot checks servers