# PreClone

> PreClone is a freemium MCP server for security. Check what a repository would run on your machine before you clone or open it. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, Chrome extension, API, Web
- **Website:** https://preclone.dev/docs
- **MCP Registry name:** io.github.catsnotdrugs/preclone
- **Categories:** security, developer tools
- **Listing updated:** 2026-11-16

## About

Hostile take-home projects and pull requests often hide things that execute on checkout, and this tool reads repository files without ever running them. It looks at install scripts, folder-open tasks and agent start hooks, scores the result as Malware signs, Read first, Worth a look or Nothing flagged, and never calls anything safe. Findings give the rule, when it fires, severity, evidence with path and line, and whether it runs without a typed command.

Two read-only MCP tools exist: check_repo for a link, owner/repo or a whole git clone line, and check_path for a folder or archive on disk. The same engine powers a CLI, a GitHub Action example, a browser extension and an HTTP API. Reports quote repo text inside random-tagged markers and warn that a hostile repository could still try prompt injection.

The CLI uploads no code, only package names and versions to npm and OSV. Anonymous use allows 12 checks an hour; a free account gets 40 a day, Pro 1,000.

## Features

- **Entry-point scanning:** Finds install scripts, folder-open tasks and agent hooks.
- **Verdict levels:** Four levels, never labelled safe.
- **CI gate:** Fail a job on a severity threshold.
- **Private repos:** Pro supports private repositories.
- **Browser button:** Check before cloning on GitHub.
- **Defanged evidence:** URLs and credentials are neutralised.

## Good for

- Vet a take-home before opening it in an editor
- Gate unknown pull requests in CI
- Let an agent check a repo before following setup steps
- Review a downloaded zip

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `check_repo`: Check a repository link, owner/repo or clone line
- `check_path`: Check a folder or archive on disk

## FAQ

### Does it run the code?

No, it only reads files.

### Does it upload my code?

The CLI does not; it sends only package names and versions to npm and OSV.

### What are the limits?

12 checks an hour anonymously, 40 a day on a free account, 1,000 on Pro.

### Is any result called safe?

No, the best verdict is Nothing flagged.

### Is PreClone free?

PreClone has a free plan, with paid plans for more usage or features.

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

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

### What are the best alternatives to PreClone?

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