# RugSnare

> RugSnare is an open-source MCP server for security. Pin MCP tool descriptions by hash and fail CI when an approved tool silently changes. It runs locally on your machine and is started by your AI client.

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

## About

RugSnare is a command-line tool rather than a server your assistant calls. It reads your MCP client configs, records each tool's name, description and input schema as a canonical SHA-256 hash, and later re-checks the live servers. If anything has changed since you approved it, the diff command exits with an error, so a build can fail on a quiet edit to a tool description.

The README frames this as the gap between pre-install scanners and what happens afterwards, and reports an audit it ran in October 2026 that found 218 silent contract changes across popular npm MCP servers. Findings are graded as breaking, loosened, expanded or notation-only, so formatting churn is separated from a real parameter change.

Beyond the one-line GitHub Action it offers a live proxy for stdio servers with observe and enforce modes, signed pin files and a verification step against an on-chain release log. It has no npm dependencies and needs Node 18 or newer.

## Features

- **Hash pinning:** Canonicalises and hashes each tool's name, description and schema, ignoring cosmetic reordering.
- **Drift grading:** Labels changes as breaking, loosened, expanded or notation-only.
- **CI gate:** A GitHub Action fails the build when a pinned contract changes.
- **Live proxy:** Wraps a stdio server in observe or enforce mode to quarantine drifted tools.
- **Signed pins:** Signs pins.json with Ed25519 and shows a badge reflecting the signature state.
- **Zero dependencies:** Runs on Node 18 or newer without npm packages.

## Good for

- Catch a tool description that changes after you approved it
- Add an MCP drift check to a pull request pipeline
- Review a field-level diff when a server updates
- Quarantine a changed tool during a live session

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## FAQ

### How do I start?

Run npx rugsnare init, then scan to pin the current contracts and diff to check them.

### What does it hash?

Each tool's name, description and input schema, plus prompts and resources.

### What is the licence?

The README badge points to Apache-2.0.

### What does it need?

Node 18 or newer; there are no npm dependencies.

### Is RugSnare free?

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

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

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

### What are the best alternatives to RugSnare?

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