# Echoproof

> Echoproof is an open-source MCP server for developer tools. Replays recorded HTTP traffic on old and new builds to flag unintended behavior changes. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Linux, CLI
- **Repository:** https://github.com/est57/echoproof
- **MCP Registry name:** io.github.est57/echoproof
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add echoproof --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' -- npx -y echoproof
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "echoproof": {
      "command": "npx",
      "args": [
        "-y",
        "echoproof"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "echoproof": {
      "command": "npx",
      "args": [
        "-y",
        "echoproof"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "echoproof": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "echoproof"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "echoproof": {
      "command": "npx",
      "args": [
        "-y",
        "echoproof"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "echoproof": {
      "command": "npx",
      "args": [
        "-y",
        "echoproof"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
      }
    }
  }
}
```

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

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/echoproof
