# mcpcut

> mcpcut is an open-source MCP server for security. Journal, approve or block, and sandbox every MCP tool call your AI agent makes. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI, macOS, Windows, Linux
- **Website:** https://mcpcut.com
- **Repository:** https://github.com/rostislavmatov/mcpcut
- **MCP Registry name:** io.github.RostislavMatov/mcpcut
- **Categories:** security, developer tools
- **Listing updated:** 2026-11-15

## About

mcpcut sits in front of the MCP servers you already use. The `adopt` command finds them in Claude Code, Cursor and Claude Desktop and rewrites their config, keeping a copy so it can be undone, and a `wrap` command does the same for one server by hand. Every request, response and decision is then written to a journal on your machine with secrets redacted, and can optionally fail closed so that no record means no call.

A JSON policy sets allow, deny or require-approval per tool. A held call waits as long as the agent waits and is approved from the CLI, web UI, terminal console or inside a Claude Code session; if the agent gives up, nothing is sent. New tools, or tools whose schema changed after you trusted them, are quarantined with a diff.

The journal is a hash chain with a signed head that can be exported as an audit report and verified offline, and the site says the head should be anchored somewhere the host cannot rewrite. Built-in file tools only touch folders you declare, with per-agent rights, a restorable trash and optional local semantic search. It needs Node.js 24 or later and is self-hosted under Apache-2.0.

## Features

- **Redacted journal:** Records every call with secrets removed before writing.
- **Per-tool policy:** Allow, deny or require approval for each tool.
- **Approval routes:** Approve from the CLI, web UI, console or inside Claude Code.
- **Tool quarantine:** Holds new or changed tools with a diff.
- **Tamper-evident audit:** Signed hash chain that verifies offline.
- **Folder-scoped files:** Gives agents only the folders you declare, with a restorable trash.

## Good for

- Review exactly what an agent did over MCP
- Make an agent ask before writing files
- Restrict an agent to one project folder
- Export a verifiable audit report
- Spot an MCP tool whose schema changed

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## FAQ

### What does it need to run?

Node.js 24 or later; it has two runtime dependencies.

### Is it hosted?

No, it is self-hosted and runs on your machine.

### What licence is it?

Apache-2.0.

### How do I add it to existing servers?

Run `npx -y mcpcut adopt` and then `--apply` to rewrite client configs.

### Is mcpcut free?

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

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

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

### What are the best alternatives to mcpcut?

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