# Proofpack

> Proofpack is an open-source MCP server for developer tools. Local read-only acceptance report on what an AI coding change touched and checked. It runs locally on your machine and is started by your AI client.

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

## About

After a coding agent says it is done, Proofpack lays out what Git can see, which checks actually ran and what remains unchecked. It never issues a safe-to-merge verdict, and a passing command counts as evidence of that one invocation only. The report separates observed facts, heuristic review prompts and unchecked work.

The MCP adapter exposes a single read-only tool, proofpack_check, which inspects Git and returns Markdown or JSON. Unlike the CLI, it does not run project commands, write files, open applications, make network requests or call a model. The CLI can run commands you pass with --run, and those run unsandboxed under your shell and privileges.

It runs locally with no account, daemon or upload, and works on branch comparisons with --base. A share-safe option strips paths and command output. Reports can be rendered in Simplified Chinese. The README calls it early development and licenses it under MIT.

## Features

- **Evidence report:** Git change facts, explicit command results and unchecked areas in one report.
- **Single MCP tool:** proofpack_check performs read-only Git inspection.
- **Explicit commands only:** Nothing runs in the CLI unless supplied with --run.
- **Share-safe output:** Omits paths, commit ids and command output for sharing.
- **Base comparison:** Compare against a branch or ref with --base.
- **Markdown and JSON:** Outputs either format; Simplified Chinese is available.

## Good for

- Review what an agent actually changed before merging
- Record that npm test passed after a change
- Produce a shareable summary without file paths
- Spot what lint, build or audit steps were never run

## Install

### Claude Code (Terminal)

```sh
claude mcp add proofpack -- npx -y proofpack-cli
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "proofpack": {
      "command": "npx",
      "args": [
        "-y",
        "proofpack-cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "proofpack": {
      "command": "npx",
      "args": [
        "-y",
        "proofpack-cli"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "proofpack": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "proofpack-cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "proofpack": {
      "command": "npx",
      "args": [
        "-y",
        "proofpack-cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "proofpack": {
      "command": "npx",
      "args": [
        "-y",
        "proofpack-cli"
      ]
    }
  }
}
```

## Tools

- `proofpack_check`: Generates a read-only Markdown or JSON acceptance report from Git inspection.

## FAQ

### Does it say whether a change is safe to merge?

No. It never gives that verdict and only reports evidence.

### Does the MCP tool run my tests?

No. The MCP tool is read-only; only the CLI runs commands passed with --run.

### Is anything uploaded?

No. It runs locally with no account, telemetry or upload.

### What does it need?

Node.js 24 or newer for development; run it with npx.

### Is Proofpack free?

Yes. Proofpack is open source, so you can use and self-host it for free.

### How do I add Proofpack to Claude Code?

Run this command in your terminal: claude mcp add proofpack -- npx -y proofpack-cli

### What are the best alternatives to Proofpack?

The closest alternatives to Proofpack 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/proofpack
