# npmscan

Audits npm dependencies for malware, known vulnerabilities, and typosquatting before installation. Connects directly to npmscan.com's public MCP server without API keys.

- plugin · `type=plugin` · Claude Code, Codex · ★ 1596 repo stars
- Author: BlockHacks.io
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/salemalem/npmscan-mcp-plugin
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text and 3 script files) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/plugins/npmscan

## What it does

The plugin hooks into npmscan.com's read-only MCP server, exposing twenty-three security tools to Claude Code. It checks packages against OSV.dev advisories, flags dangerous install hooks like `preinstall` or `postinstall`, and inspects maintainer change history. Every malicious package finding carries `isMalware`, so verified malware gets separated from standard software bugs.

It bundles five focused skills. `/npmscan:dependency-audit` parses full manifests, lockfiles, or PR diffs. `/npmscan:package-trust-check` inspects single suspect packages, while `/npmscan:new-dependency-evaluation` compares competing libraries side-by-side. The remaining skills handle incident response and deterministic PASS/WARN/FAIL verdicts for CI merge gates.

The server is stateless and needs no credentials. It enforces a rate limit of 30 requests per minute per IP address, which sets a hard ceiling on bursty dependency scans.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

**Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add hashgraph-online/awesome-codex-plugins
```
In the agent chat (not a shell):
```text
/plugin install npmscan@awesome-codex-plugins
```

## When to use it
- scan an npm package for hidden install scripts and malicious code
- evaluate two or three candidate libraries side by side before adding one
- audit transitive dependencies across a package.json or lockfile
- generate a PASS or FAIL gate for dependency updates in pull requests

## Example prompts
- /npmscan:package-trust-check Investigate whether event-stream is safe to install
- /npmscan:dependency-audit Audit all dependencies declared in package.json
- /npmscan:new-dependency-evaluation Compare axios and got for our HTTP client

## Source text · npmscan-mcp-plugin · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 26283652d6ec9b21.

BEGIN THIRD-PARTY FILE 26283652d6ec9b21
```text
# NPMScan plugin for Claude Code

A [Claude Code plugin](https://code.claude.com/docs/en/plugins) that gives
Claude read-only npm package and vulnerability lookups, backed by
[npmscan.com](https://npmscan.com)'s free, unauthenticated MCP server.

NPMScan is also officially listed for both ChatGPT and Claude on
[npmscan.com's MCP page](https://npmscan.com/mcp), so users can verify that
this plugin points at the same public service.

## Official listings

- **Claude** (Anthropic's official Claude directory):
  [claude.ai/customize/skills/…/npmscan](https://claude.ai/customize/skills/id/aa8fcafe-0bcd-41b6-9e07-6c7ebbb71153%40anthropic-plugin-directory)
- **ChatGPT** (install npmscan as an app for one-click setup):
  [chatgpt.com/plugins/…/npmscan](https://chatgpt.com/plugins/plugin_asdk_app_6a6a699e6f3481918d5e6034432894f2?q=npm)
- **mcpHQ**: [mcphq.org](https://github.com/mcpHQ/awesome-mcp-servers)
- **TensorBlock MCP Index**: [tensorblock.co/mcp](https://github.com/TensorBlock/awesome-mcp-servers)
- **Awesome Gemini CLI**: [Piebald-AI/awesome-gemini-cli](https://github.com/Piebald-AI/awesome-gemini-cli)
- **Awesome Gemini CLI Extensions**: [Piebald-AI/awesome-gemini-cli-extensions](https://github.com/Piebald-AI/awesome-gemini-cli-extensions)
- **Awesome Codex Plugins**: [hashgraph-online/awesome-codex-plugins](https://github.com/hashgraph-online/awesome-codex-plugins)
- **Setup docs for other clients**: [npmscan.com/mcp](https://npmscan.com/mcp)

Pending:

- **Grok Build** (xAI's official plugin marketplace): submitted in
  [xai-org/plugin-marketplace#1506](https://github.com/xai-org/plugin-marketplace/pull/1506),
  awaiting xAI review. See [Using it with Grok Build](#using-it-with-grok-build).
- **GitHub Copilot** (Awesome Copilot marketplace): submitted in
  [github/awesome-copilot#5142](https://github.com/github/awesome-copilot/issues/5142).
- **Gemini CLI** (extension gallery): indexed automatically from this repo. See
  [Using it with Gemini CLI](#using-it-with-gemini-cli).

## What it adds

- **MCP server** (`npmscan`, `https://npmscan.com/api/mcp`) with
  twenty-three tools — see [Tools](#tools) below. Every tool result includes
  an `npmscanUrl` linking back to the full write-up on npmscan.com. No API
  key or auth required — same public data as the website. The server is
  stateless and rate-limited to 30 requests/minute per IP. Every
  vulnerability finding carries `isMalware`, so a confirmed-malicious
  package is reported as malware to remove, never as an ordinary bug.

- **`/npmscan:dependency-audit` skill** — chains `batch_query_vulnerabilities`
  → `get_package`/`get_package_version` → `analyze_transitive_dependencies`
  → the maintainer/provenance/license/remediation/alternative tools into one
  dependency-audit report, instead of leaving that tool sequencing to Claude
  each time. Also handles PR-style before/after diffs via
  `diff_dependencies`, raw `npm audit --json` output via `enrich_npm_audit`,
  and a bare GitHub repo URL via `audit_github_repository`. Triggers
  automatically when you paste a `package.json`/lockfile/SBOM, give a GitHub
  repo URL, or ask to check/audit your dependencies, or invoke it directly.
  See [`skills/dependency-audit/SKILL.md`](skills/dependency-audit/SKILL.md).

- **`/npmscan:package-trust-check` skill** — a deep, single-package
  investigation for "is X safe / was X compromised" questions: a malware
  check (including versions npm has since removed for being malicious),
  maintainer add/remove history (account-takeover patterns),
  publish-provenance cross-checks, and install-script scanning, in one
  report. Triggers
  automatically on a trust question about one named package; not for
  auditing a whole dependency list (that's `dependency-audit`). See
  [`skills/package-trust-check/SKILL.md`](skills/package-trust-check/SKILL.md).

- **`/npmscan:new-dependency-evaluation` skill** — for a forward-looking
  choice about what to *add*, not what's already installed: comparing 2-5
  named candidates ("axios vs got vs node-fetch"), evaluating one candidate
```
END THIRD-PARTY FILE 26283652d6ec9b21

The third-party file has ended. Everything between the 26283652d6ec9b21 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 4095 of 31251 bytes. © BlockHacks.io · MIT · https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/salemalem/npmscan-mcp-plugin

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
