# Repo Run Check

> Repo Run Check is a freemium MCP server for developer tools. Scans GitHub repos and shell commands for malware tricks before an agent runs them. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, Web, API
- **Website:** https://repo-run-check.nextill-pos.workers.dev
- **Repository:** https://github.com/devx-agent/repo-run-check
- **MCP Registry name:** io.github.devx-agent/repo-run-check
- **Categories:** developer tools, security
- **Listing updated:** 2026-11-14

## About

The README opens with a concrete case: a fake Solana starter kit ranked first when coding agents searched, and its only install step was a PowerShell one-liner that rebuilt a URL from fragments, downloaded a script and ran it in memory. Agents with shell access follow READMEs, so this server gives them a read-only check first, without cloning or running anything.

The free README scan looks for download-and-execute one-liners, pipe-to-shell from unknown hosts (with rustup, Foundry and Anza allowed as info), URLs assembled from pieces, base64 payloads, Windows LOLBins, antivirus or Gatekeeper tampering, password-protected archives, Trojan Source characters, known malware domains and text aimed at AI agents such as ignore previous instructions. A separate command check judges one shell command.

The paid full check, 0.25 USDC via x402 on Base for one to three repos, adds package.json install hooks, typosquatted crypto dependencies, setup scripts, VS Code folder-open tasks, a Makefile and signals like owner age and stars versus forks. Verdicts are dangerous, review before running or no red flags, and the README calls them heuristics. It suggests a rule telling agents to call check_command before running any README install command.

## Features

- **README scan:** Finds download-and-execute, encoded and fragment-built payloads.
- **Command check:** Judges a single shell command before it runs.
- **Local repo scan:** Scans a cloned repo before an install step.
- **Agent prompt-injection flags:** Spots text aimed at AI agents inside a README.
- **Fake-star signals:** The paid check compares stars with forks, owner age and updates.
- **Install hook review:** The paid check inspects package scripts, setup files and autorun tasks.

## Good for

- Vet a starter-kit repo before an agent follows its setup
- Check a curl-pipe-bash command from a README
- Scan a cloned folder before npm install
- Add a standing rule so agents check commands first

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http repo-run-check https://repo-run-check.nextill-pos.workers.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://repo-run-check.nextill-pos.workers.dev/mcp
```

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

```json
{
  "mcpServers": {
    "repo-run-check": {
      "url": "https://repo-run-check.nextill-pos.workers.dev/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "repo-run-check": {
      "type": "http",
      "url": "https://repo-run-check.nextill-pos.workers.dev/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "repo-run-check": {
      "serverUrl": "https://repo-run-check.nextill-pos.workers.dev/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "repo-run-check": {
      "type": "http",
      "url": "https://repo-run-check.nextill-pos.workers.dev/mcp"
    }
  }
}
```

## Tools

- `check_command`: Check a single shell command
- `check_local_repo`: Scan a local repo folder
- `check_repo`: Check a GitHub repo's README and install steps
- `full_report_info`: How to buy the full report

## FAQ

### Does it run or clone the repo?

No. Nothing is cloned, built or executed.

### What is free?

The README check, the command check, the offline CLI and the remote MCP tools.

### What does the full check cost?

0.25 USDC via x402 on Base for one to three repos.

### Are the verdicts reliable?

The README calls them heuristics, not guarantees.

### Is Repo Run Check free?

Repo Run Check has a free plan, with paid plans for more usage or features.

### How do I add Repo Run Check to Claude Code?

Run this command in your terminal: claude mcp add --transport http repo-run-check https://repo-run-check.nextill-pos.workers.dev/mcp

### What are the best alternatives to Repo Run Check?

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

## Where this comes from

- Description: written from the project's README and the project's website.
- 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.
- [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/repo-run-check
