# Vouchwell

> Vouchwell is an open-source MCP server for security. Read-only MCP server that lets an agent read and verify its own tamper-evident action log. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://vouchwell.axonscape.com
- **Repository:** https://github.com/vouchwell/vouchwell/tree/HEAD/packages/cli
- **MCP Registry name:** io.github.Vouchwell/vouchwell
- **Categories:** security, developer tools
- **Listing updated:** 2026-11-15

## About

Vouchwell is a guardrail and audit layer, and this MCP server is its read-only part. Running vw mcp serves a log so that an MCP client can answer what an agent did and prove it, without being able to change anything.

The larger project sits in front of an agent. A policy is checked before each tool call, shell command, file edit or fetch. Refusals include destructive commands, secret files, destructive SQL and credentials in arguments. Budgets can cap spending, such as a daily refund limit. Each decision becomes a signed, hash-chained receipt in an RFC 6962 Merkle log, with salted argument commitments. The README lists Ed25519 signatures over RFC 8785 canonical form.

A browser page and the CLI run independent verifiers, and the site shows edited, deleted, re-signed and truncated logs being caught. It is pre-1.0, Apache-2.0 and says it has not been independently reviewed. Verified means the bundle is unaltered, not that the log is complete.

## Features

- **Read-only log server:** vw mcp lets any MCP client query and verify a log without write access.
- **Policy before action:** Commands, edits, fetches and tool calls are checked before they run.
- **Signed receipts:** Every decision is signed and chained to the previous receipt.
- **Merkle anchoring:** An RFC 6962 tree lets a third party check the log from the file alone.
- **MCP proxy:** vw proxy sits in front of any MCP server with a one-line config change.
- **Monitor mode:** Records what a policy would block without blocking anything.

## Good for

- Ask an agent to prove what it did during a session
- Add spending caps to an agent that issues refunds
- Block destructive SQL and leaked keys from reaching a tool
- Give an auditor a log they can check offline

## Install

### Claude Code (Terminal)

```sh
claude mcp add vouchwell -- npx -y vouchwell
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## FAQ

### What does verified mean?

The bundle is unaltered since signing and nothing was left out of a bundle claiming completeness. It does not prove the log covers everything the agent did.

### Which clients are supported?

Claude Code, Codex CLI and Cursor hooks, plus any MCP server through the proxy.

### How do I try it?

Run npx vouchwell demo; nothing is installed or written.

### Is it production ready?

The site marks it pre-1.0 and not yet independently reviewed.

### Is Vouchwell free?

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

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

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

### What are the best alternatives to Vouchwell?

The closest alternatives to Vouchwell are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [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.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

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