# io.github.Baneado98/npm-guardian (npm · npm-guardian-mcp)

npm supply-chain audit: known CVEs (OSV), typosquatting, malicious scripts — before npm install.

- Trust score: 0/100 (low)
- Registry status: deleted
- Liveness: dead
- Owner verified: no
- Last scored: 2026-08-05

> **Malware flagged**: A supply-chain scanner flagged a high-severity malware risk in this package. Treat it as unsafe to install until the finding is cleared.

> **Deleted**: this server was marked deleted in the MCP registry on 2026-08-04. Its details are retained for reference.

## Components

- npm · `npm-guardian-mcp`: 0/100 (this document), [markdown](https://verifymcp.io/servers/baneado98-npm-guardian/npm-guardian-mcp.md), [page](https://verifymcp.io/servers/baneado98-npm-guardian/npm-guardian-mcp)

## Channel facts

- Registry: `npm`
- Package: `npm-guardian-mcp`
- Version: `0.3.2`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-05.

- **Supply Chain Security**: 41/100
  - Malware check failed: a supply-chain vendor flagged a high-severity malware risk.
  - Known CVEs were checked across the 94 of 98 dependencies we could resolve, so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Dependency health was assessed across the 94 of 98 dependencies we could resolve, so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 19/100
  - Repository check failed: the declared repository URL returned HTTP 404.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 42 days ago).
  - Security-disclosure policy not yet verified: we couldn't inspect the source repository.
- **Schema Quality & AI Usability**: 77/100
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 285 tokens (~142/item across 2 items; 2 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add baneado98-npm-guardian -- npx -y npm-guardian-mcp
```

### Codex

```bash
codex mcp add baneado98-npm-guardian -- npx -y npm-guardian-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "baneado98-npm-guardian": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "npm-guardian-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add baneado98-npm-guardian --command npx --arg -y --arg npm-guardian-mcp
```

### Hermes

```yaml
mcp_servers:
  baneado98-npm-guardian:
    command: "npx"
    args: ["-y", "npm-guardian-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "baneado98-npm-guardian": {
      "command": "npx",
      "args": [
        "-y",
        "npm-guardian-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-05 (score 0, −16)

- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] MCP protocol: unverified → pass
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: excellent
- [functional] First check of Schema quality: pass
- [functional] First check of Tool coverage: 100

### 2026-08-04 (score 16)

First indexed and scored.

## MCP tools (2)

### `audit_npm_package` (~233 tokens)

Run a supply-chain security audit on an npm package BEFORE installing it. Cross-references the exact version against published CVE/GHSA vulnerability advisories (via OSV.dev) and tells you the fixed version to upgrade to, AND detects typosquatting, malicious install/postinstall scripts, credential & crypto-key exfiltration markers, freshly-published low-trust packages and missing source repos. Returns a SAFE / SUSPICIOUS / DANGEROUS verdict with a risk score and explained findings. Use this whenever you are about to run 'npm install <pkg>' or add a dependency you are not 100% sure about.

Input parameters:

- `deep` (boolean): When true, also downloads and statically inspects the REAL published tarball (source files + index/tarball tampering), not just registry metadata. Slower but catches payloads hidden in source. Recomm…
- `name` (string, required): The npm package name, e.g. 'lodash' or '@scope/pkg'.
- `version` (string): Optional specific version to audit. Defaults to latest.

### `audit_many` (~52 tokens)

Audit several npm packages at once (e.g. an entire dependency list). Returns one verdict per package. Useful to vet a package.json before installing.

Input parameters:

- `names` (array, required): List of npm package names to audit.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/baneado98-npm-guardian/npm-guardian-mcp#diagnostics

## Score history

- 2026-08-05: 0
- 2026-08-04: 16

## Links

- npm package: https://www.npmjs.com/package/npm-guardian-mcp
- Socket report: https://socket.dev/npm/package/npm-guardian-mcp
- Changelog RSS feed: https://verifymcp.io/servers/baneado98-npm-guardian/npm-guardian-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/baneado98-npm-guardian/npm-guardian-mcp.json
- HTML version of this page: https://verifymcp.io/servers/baneado98-npm-guardian/npm-guardian-mcp