Install and run Credenzo
One package, every command, no account. Current release: 0.33.0, released 2026-11-16.
Install
pip install credenzoOr with uv: uv tool install credenzo. credenzo installs mcp-audit-scanner, the package that holds the code; the command is credenzo (the old name, mcp-audit, still works). It needs Python 3.11 or later. Standalone binaries for macOS (Apple silicon), macOS (Intel), Linux (x86-64) and Windows (x86-64) are on GitHub Releases.
Optional extras add features that need more dependencies:
| Install | Adds |
|---|---|
credenzo[attestation] | Sigstore provenance checks: scan --verify-signatures. |
credenzo[mcp] | Live connections: scan --connect and lock --connect. |
credenzo[sbom] | CycloneDX SBOM output: credenzo sbom. |
First run, by job
Before you install a server
credenzo vet @modelcontextprotocol/server-filesystemRegistry status, recorded advisories, capabilities and lookalike names for a public package. Exits 1 for an advisory with no fix or a lookalike name. Add
--format jsonfor the verdict document.Before you open a cloned repo
credenzo scan --project ./cloned-repo --include-agent-filesWalks the repo for MCP configs, agent settings, editor auto-run files and instruction files, and reports what each can do.
On your machine
credenzo checkcredenzo fixcredenzo fix --applycheckgives a grade and the top findings with a fix for each.fixshows the safe fixes as a diff;--applywrites them and keeps a.bakcopy.Lock what you approved
credenzo lockgit add mcp-lock.jsoncredenzo lock --verifylockrecords the approved servers, never secret values.lock --verifyexits 1 when anything drifts;lock --acceptrecords a reviewed change.Find servers nobody approved
credenzo shadow --allowlist .mcp-audit-allowlist.ymlLists every MCP server on the machine as sanctioned or shadow (OWASP MCP09). Add
--continuousto emit events when configs change.Cut the blast radius
credenzo killchainRanks the few changes that break the most attack paths between your servers.
In CI
GitHub Action
The Action installs Credenzo, scans the MCP configs and Claude Code settings in the checked-out repository, uploads SARIF to GitHub code scanning, and fails the job at the severity you choose. With lock-verify, it also fails when the repo drifts from mcp-lock.json.
name: mcp-audit
on: [push, pull_request]
jobs:
mcp-audit:
runs-on: ubuntu-latest
permissions:
contents: read
security-events: write
steps:
- uses: actions/checkout@v4
- uses: adudley78/credenzo@v0.33.0
with:
severity-threshold: high
lock-verify: truePin the Action to a release tag. Before 1.0 there is no floating major tag such as @v1.
All 14 inputs
| Input | Default | What it does |
|---|---|---|
mode | scan | Action mode: scan (default — full static analysis) or diff (MCP-aware diff between two git refs, suitable for PR comments). |
config-paths | none | Space-separated list of paths to MCP config files or directories to scan. |
severity-threshold | high | Minimum severity to fail the build. |
sarif-output | mcp-audit.sarif | Path to write SARIF output file. |
upload-sarif | true | Upload SARIF to GitHub Code Scanning automatically. |
check-vulns | false | Run OSV.dev dependency vulnerability scan (Layer 3). |
verify-signatures | false | Run Sigstore signature verification (Layer 2). |
run-sast | false | Also run Credenzo SAST analysis against the path specified by sast-path. |
sast-path | src/ | Path to run SAST analysis against. |
baseline-name | none | Name of a saved baseline to compare against. |
fail-on-findings | true | Fail the workflow step if findings meet or exceed severity-threshold. |
lock-verify | false | Verify mcp-lock.json (if one exists in the repo) via credenzo lock --verify. |
lock-resolve | false | With lock-verify, also re-resolve floating specs against the registry (network access; produces LOCK-004 for drifted versions). |
version | latest | Credenzo release tag to install (e.g. "v0.10.0") or "latest" to resolve the current latest release automatically. |
pre-commit
Add to .pre-commit-config.yaml:
repos:
- repo: https://github.com/adudley78/credenzo
rev: v0.33.0
hooks:
- id: credenzo
- id: credenzo-lock-verify
- id: mcp-audit
- id: mcp-audit-lock-verifycredenzo: Scan MCP server configuration files for security vulnerabilities (runscredenzo scan --severity-threshold high).credenzo-lock-verify: Block a commit that drifts from the reviewed mcp-lock.json (runscredenzo lock --verify --if-present).credenzo: Scan MCP server configuration files for security vulnerabilities (runscredenzo scan --severity-threshold high).mcp-audit-lock-verify: Block a commit that drifts from the reviewed mcp-lock.json (runscredenzo lock --verify --if-present).
Pull request comments
credenzo diff <base> <head> --format pr-comment summarises what a pull request changes in MCP configs: servers, tools, credentials and endpoints, with a risk level. The Action's mode: diff input posts it for you.
In your editor
The Credenzo extension on Open VSX (mcp-audit.mcp-audit-vscode) shows findings as you edit an MCP config in VS Code-compatible editors such as Cursor: underlines on the server, hover cards with the fix, and the grade in the status bar. It calls the credenzo command, so install the package first.
Output and integrations
scan --formatwritesterminal,json,sarif,nucleus. SARIF carries OWASP MCP Top 10 codes into GitHub code scanning.dashboardopens a self-contained HTML attack graph; nothing is loaded from a CDN.scan --report pdfwrites a PDF report.sbomandsnapshotwrite CycloneDX documents;snapshot --streamemits one finding per line for a SIEM.push-nucleussends a scan to Nucleus Security through its FlexConnect API, andmergecombines scans from many machines into one fleet report.
Every command 45
Read from the source at build time. Run credenzo <command> --help for flags.
| Command | What it does |
|---|---|
credenzo advise | Scan TARGET and publish signed, OSV-compatible advisories to ./feed. |
credenzo affected | Is this advisory (or package range) in any MCP server on this machine? |
credenzo check | One-command security verdict: grade, top findings, and fix hints. |
credenzo dashboard | Run a full scan and open an interactive attack-graph dashboard. |
credenzo diff | MCP-aware diff for PRs and CI gates. |
credenzo discover | List all detected MCP clients and server configurations. |
credenzo fix | Apply safe remediations directly to MCP config files. |
credenzo killchain | Find the 2–3 changes that cut your blast radius. |
credenzo lock | Write, verify, or re-accept a committable MCP server lock. |
credenzo merge | Merge JSON scan outputs from multiple machines into a fleet report. |
credenzo pin | Record current MCP server configurations as the trusted baseline. |
credenzo push-nucleus | Run a scan and push results to Nucleus Security via FlexConnect API. |
credenzo reach | What can the agents on this machine touch? One card per agent. |
credenzo register | Opt-in registration: share contact details for Credenzo project updates. |
credenzo run | Launch an MCP server through the Credenzo stdio relay. |
credenzo sast | Scan MCP server source code with Semgrep SAST rules. |
credenzo sbom | Generate a CycloneDX 1.5 SBOM for all MCP servers in PATH. |
credenzo scan | Scan MCP configurations for security issues. |
credenzo shadow | Find your shadow MCP servers — OWASP MCP09. |
credenzo snapshot | Time-stamped signed forensic snapshots of every MCP server on this host. |
credenzo unwrap | Restore servers wrapped by credenzo wrap to their original entries. |
credenzo update-registry | Fetch the latest known-server registry from the upstream repository. |
credenzo verify | Verify package integrity by comparing hashes against registry pins. |
credenzo version | Show version information. |
credenzo vet | Pre-install verdict on a public MCP server package. |
credenzo watch | Continuously monitor MCP configs and scan on changes. |
credenzo wrap | Launch local MCP servers through credenzo run (EPIC-0009). |
credenzo agent-files discover | Discover agent instruction and memory files across supported AI clients. |
credenzo agent-files scan | Scan agent instruction and memory files for security issues. |
credenzo baseline save | Capture a baseline snapshot of the current MCP configuration. |
credenzo baseline list | List all saved baselines. |
credenzo baseline compare | Compare the current MCP configuration against a saved baseline. |
credenzo baseline delete | Delete a saved baseline. |
credenzo baseline export | Write a baseline as raw JSON to stdout (pipeable) or a file. |
credenzo extensions discover | Discover installed IDE extensions across supported AI coding clients. |
credenzo extensions scan | Scan installed IDE extensions for security issues. |
credenzo feed verify | Re-canonicalize and verify every signature in a feed directory. |
credenzo plugins discover | List installed Claude Code plugins, their source pin, and what they ship. |
credenzo plugins scan | Scan installed Claude Code plugins: pin integrity, mods, skills, MCP servers. |
credenzo policy validate | Validate a governance policy file (schema check only). |
credenzo policy init | Write a commented governance policy template to disk. |
credenzo policy check | Evaluate governance policy violations only (no full security scan). |
credenzo rule validate | Validate a rule file without running a scan. |
credenzo rule test | Test a rule file against a specific MCP config file. |
credenzo rule list | List all currently loaded rules (bundled + user-local). |
Documentation
The full documentation lives in the repository. Start with the README and the changelog.
- docs-usage.md Getting started, every command and flag
- clients.md Supported clients and the config files read for each
- check.md
check: the one-page verdict - scoring.md Score and grade method
- severity-framework.md Severity, CVSS and OWASP mapping for every finding ID
- owasp-mcp-top-10.md Coverage of the OWASP MCP Top 10
- privacy.md What Credenzo collects (nothing by default)