Hidden while we check this listing

Our automated checks found a problem, so this listing is out of search, browse and the API until it clears. It comes back on its own once the problem is fixed.

  • The install package comes from a different repo than this listing's
Own this project? Claim it
Safeinstall logo

Safeinstall

Local-first supply-chain security gate for npm/pnpm/bun: typosquat, release age, provenance checks

Install Safeinstall

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "safeinstall": {
      "command": "npx",
      "args": [
        "-y",
        "create-next-app"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

21/25 checks healthy over the last 99d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 11d ago via OSV.dev · create-next-app (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars3Stargazers on the source repository.
Last commit3d agoMost recent push to the default branch.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

From the project README

SafeInstall
Supply-chain security for the AI-agent era.

npm version license stars TypeScript docs trust surface

The artifact-bound install gate for npm and pnpm — for the humans who type install, the AI agents that run it for them, and the config that programs those agents.
Policy runs first. Then your package manager. Not the other way around.

Local-first · No cloud · No account · MIT · Free forever


What it does

SafeInstall runs your policy before your package manager — locally, blocking by default. One tool, three layers of defense:

  • 🧑‍💻 For the humans who install — prefix supported install commands: safeinstall pnpm add axios. Policy runs first; the resolved lockfile is then checked against the approved version and SHA-512 before the frozen install. Release age, install scripts, untrusted sources, typo-squats, and cryptographic provenance are policy checks.
  • 🤖 For the AI agents that install for you — an MCP tool agents can call, plus a shell guard that intercepts install commands in Claude Code, Codex, and Cursor before they run. Best-effort shell interception — one defense layer that fires even when the agent isn't cooperating, not a lossless guarantee.
  • đź”’ For the files that program the agents — the Agent Trust Surface: a committed hash baseline of your config, hooks, rules, and MCP files, reconciled locally and re-verified in CI, so tampering with the rules surfaces as drift instead of silently owning every future session — with a fully consistent rewrite caught by human review of the diff, not the automated check alone.

Why SafeInstall

AI coding tools suggest packages in seconds. They don't check publish dates. They don't read install scripts. They don't verify the source. You type "yes" and move on.

SafeInstall is the gate between suggestion and execution.

Code
$ safeinstall pnpm add compromised-pkg@9.9.9

Install blocked.
- compromised-pkg@9.9.9
  Blocked: release too new (published 3 hours ago; minimum is 72 hours).
  Blocked: install script present (has postinstall).

No dashboard. No account. No cloud. One command prefix — policy runs locally, blocks by default, then invokes the real tool.


Catching a maintainer-compromise attack

A valid Sigstore signature is not enough. An attacker who compromises an npm maintainer account can publish a malicious version of a package you already trust, and the attestation on that malicious version will cryptographically verify — signed by a GitHub Actions workflow the attacker controls in a fork of the real repository.

SafeInstall catches this. Pin the expected source repository with provenance.trustedPublishers and any build that comes from anywhere else is blocked, even if the signature is valid:

Code
$ safeinstall check
Using config: ./safeinstall.config.json
Check blocked.
- axios@1.99.0
  Blocked: publisher mismatch for axios (expected axios/axios, got evil-org/axios).
  Suggestion: Verify the package source. Update provenance.trustedPublishers only if the change is intentional.

This is the only check of its kind in an install-time policy gate. CVE scanners look for known vulnerabilities. Content analyzers look for suspicious code. SafeInstall enforces that the cryptographic chain of trust points at the repository you agreed to trust — and refuses anything else, no matter how legitimate it looks.

SafeInstall itself is published with a Sigstore attestation. You can eat your own dog food: enable provenance verification, pin safeinstall-cli to Mickdownunder/SafeInstall, and watch SafeInstall verify its own trust chain against the public Sigstore transparency log.

Code
$ safeinstall check
Using config: ./safeinstall.config.json
Info: safeinstall-cli: provenance verified from Mickdownunder/SafeInstall via .github/workflows/release.yml.
Check passed: no direct dependency policy violations found.

Install

Terminal
npm install -g safeinstall-cli

Node.js >=20 · macOS, Linux, Windows · Command: safeinstall

Quickstart

bash
safeinstall init                      # config + agent guard hooks + trust lock, in one command
safeinstall pnpm add axios            # policy runs, then pnpm
safeinstall npm install               # lockfile-aware project install
safeinstall check                     # audit direct deps against policy

How it works

Code
Resolve → Policy → Lockfile-only preparation → Verify artifact binding → Frozen install
                      Any failed policy or binding check → Exit 2 (blocked)
  1. Resolves the requested version and captures the registry's tarball URL and SHA-512
  2. Fetches registry metadata (publish time, declared scripts)
  3. Evaluates policy rules
  4. For explicit package additions, pins the evaluated version and runs a scripts-disabled, lockfile-only preparation
  5. Checks every direct registry dependency in the affected lockfile scope against its evaluated version, SHA-512, and tarball URL where recorded; applies configured transitive checks
  6. Runs npm ci or pnpm install --frozen-lockfile with scripts disabled and the configured registry enforced; rejects manifest/lockfile changes during evaluation or installation

No registry proxy. No tarball rewriting. No cloud dependency.


Policy defaults

RuleDefaultBlock message
Release age72 hours minimumBlocked: release too new
Lifecycle scriptspreinstall, install, postinstall blockedBlocked: install script present
Source typesregistry, workspace, file, directory allowed. First-party workspace packages (workspace:, or a path matched by the workspace globs) are always allowed; any other local directory counts as directory and a local tarball as fileBlocked: untrusted source
Trust downgradeFlags a dependency that was registry in the committed manifest and is now git/url/tarball or any local source (file:, link:, directory, workspace:). A dependency that was already local at the baseline is not flagged. decisions authorize compares against the base commit's manifest (never the config); check and installs compare against the manifest at git HEAD. sourceBaselines applies only when there is no HEAD manifest (no git, unborn HEAD, untracked manifest), and then missing history fails closedBlocked: trust level dropped
Typo-squat detectionOff by default; opt in via typoSquat.modeBlocked: suspected typo-squat
Provenance verificationOff by default; opt in via provenance.modeBlocked: attestation missing/invalid/publisher mismatch
Lockfile sourcesEvery entry of an npm or pnpm lockfile, direct or transitive, must come from a source in allowedSourcesBlocked: transitive dependency resolves from an untrusted source
Transitive install scriptsOff by default; opt in via transitive.modeBlocked: transitive install script
Provenance continuityOff by default; opt in via continuity.modeBlocked: provenance downgrade / identity discontinuity

All rules are configurable. Ambiguous or incomplete metadata blocks instead of allowing.

Provenance continuity — catching what npm defaults can't

This is SafeInstall's most distinctive check, and the one no other consumer-side tool does. npm verifies provenance at publish time and binds a package to a source repository — but it does not enforce continuity between versions. A compromised maintainer account can publish a new version with no attestation (from a stolen token), or from a different repository, and npm raises no alarm. This is the signature of the 2026 attack wave (Mastra, the dormant-account republishes).

Continuity learns a per-package trust baseline from the provenance identity of recent versions, then blocks deviations:

  • provenance-downgrade — recent versions were attested, this one isn't. The fingerprint of an account-compromise publish from a personal token. (This is the Mastra case.)
  • identity-discontinuity — this version is attested from a different source repository than the established baseline.

Because the baseline is learned per package, there are no false positives on the large majority of packages that never adopted provenance — they simply have no baseline and the check stays silent. No global "require provenance" sledgehammer.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Safeinstall

safeinstall is an MCP server that provides a local-first supply-chain security gate for npm, pnpm, and bun workflows. It checks package installs for typosquats, release age, install scripts, untrusted sources, and cryptographic provenance before package-manager execution. It runs without a cloud service or account and blocks by default.

safeinstall checks for typosquatted packages, newly published releases, install scripts, untrusted sources, and cryptographic provenance. It can also verify the resolved lockfile against an approved version and SHA-512 before a frozen install.

No, safeinstall is designed to run locally without a cloud service or account. Its policy checks run before the package manager and block by default.

Yes, safeinstall provides an MCP tool for AI agents and a shell guard that can intercept install commands in Claude Code, Codex, and Cursor before execution. The shell interception is best-effort and is not a lossless guarantee.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewSafeinstall AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/safeinstall?style=directory)](https://allmcps.com/mcp/safeinstall)
HTML Embed
<a href="https://allmcps.com/mcp/safeinstall"><img src="https://allmcps.com/api/badge/safeinstall?style=directory" alt="Safeinstall on AllMCPs" /></a>