Credenzo GitHub

mcp-audit is becoming Credenzo, the taste test for agent tools. The command is now credenzo. The old command still works, and the code is still in the mcp-audit-scanner package.

Install and run Credenzo

One package, every command, no account. Current release: 0.33.0, released 2026-11-16.

Install

pip install credenzo

Or 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:

InstallAdds
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

  1. Before you install a server

    credenzo vet @modelcontextprotocol/server-filesystem

    Registry 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 json for the verdict document.

  2. Before you open a cloned repo

    credenzo scan --project ./cloned-repo --include-agent-files

    Walks the repo for MCP configs, agent settings, editor auto-run files and instruction files, and reports what each can do.

  3. On your machine

    credenzo checkcredenzo fixcredenzo fix --apply

    check gives a grade and the top findings with a fix for each. fix shows the safe fixes as a diff; --apply writes them and keeps a .bak copy.

  4. Lock what you approved

    credenzo lockgit add mcp-lock.jsoncredenzo lock --verify

    lock records the approved servers, never secret values. lock --verify exits 1 when anything drifts; lock --accept records a reviewed change.

  5. Find servers nobody approved

    credenzo shadow --allowlist .mcp-audit-allowlist.yml

    Lists every MCP server on the machine as sanctioned or shadow (OWASP MCP09). Add --continuous to emit events when configs change.

  6. Cut the blast radius

    credenzo killchain

    Ranks 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: true

Pin the Action to a release tag. Before 1.0 there is no floating major tag such as @v1.

All 14 inputs
InputDefaultWhat it does
modescanAction mode: scan (default — full static analysis) or diff (MCP-aware diff between two git refs, suitable for PR comments).
config-pathsnoneSpace-separated list of paths to MCP config files or directories to scan.
severity-thresholdhighMinimum severity to fail the build.
sarif-outputmcp-audit.sarifPath to write SARIF output file.
upload-sariftrueUpload SARIF to GitHub Code Scanning automatically.
check-vulnsfalseRun OSV.dev dependency vulnerability scan (Layer 3).
verify-signaturesfalseRun Sigstore signature verification (Layer 2).
run-sastfalseAlso run Credenzo SAST analysis against the path specified by sast-path.
sast-pathsrc/Path to run SAST analysis against.
baseline-namenoneName of a saved baseline to compare against.
fail-on-findingstrueFail the workflow step if findings meet or exceed severity-threshold.
lock-verifyfalseVerify mcp-lock.json (if one exists in the repo) via credenzo lock --verify.
lock-resolvefalseWith lock-verify, also re-resolve floating specs against the registry (network access; produces LOCK-004 for drifted versions).
versionlatestCredenzo 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-verify
  • credenzo: Scan MCP server configuration files for security vulnerabilities (runs credenzo scan --severity-threshold high).
  • credenzo-lock-verify: Block a commit that drifts from the reviewed mcp-lock.json (runs credenzo lock --verify --if-present).
  • credenzo: Scan MCP server configuration files for security vulnerabilities (runs credenzo scan --severity-threshold high).
  • mcp-audit-lock-verify: Block a commit that drifts from the reviewed mcp-lock.json (runs credenzo 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 --format writes terminal, json, sarif, nucleus. SARIF carries OWASP MCP Top 10 codes into GitHub code scanning.
  • dashboard opens a self-contained HTML attack graph; nothing is loaded from a CDN. scan --report pdf writes a PDF report.
  • sbom and snapshot write CycloneDX documents; snapshot --stream emits one finding per line for a SIEM.
  • push-nucleus sends a scan to Nucleus Security through its FlexConnect API, and merge combines scans from many machines into one fleet report.

Every command 45

Read from the source at build time. Run credenzo <command> --help for flags.

CommandWhat it does
credenzo adviseScan TARGET and publish signed, OSV-compatible advisories to ./feed.
credenzo affectedIs this advisory (or package range) in any MCP server on this machine?
credenzo checkOne-command security verdict: grade, top findings, and fix hints.
credenzo dashboardRun a full scan and open an interactive attack-graph dashboard.
credenzo diffMCP-aware diff for PRs and CI gates.
credenzo discoverList all detected MCP clients and server configurations.
credenzo fixApply safe remediations directly to MCP config files.
credenzo killchainFind the 2–3 changes that cut your blast radius.
credenzo lockWrite, verify, or re-accept a committable MCP server lock.
credenzo mergeMerge JSON scan outputs from multiple machines into a fleet report.
credenzo pinRecord current MCP server configurations as the trusted baseline.
credenzo push-nucleusRun a scan and push results to Nucleus Security via FlexConnect API.
credenzo reachWhat can the agents on this machine touch? One card per agent.
credenzo registerOpt-in registration: share contact details for Credenzo project updates.
credenzo runLaunch an MCP server through the Credenzo stdio relay.
credenzo sastScan MCP server source code with Semgrep SAST rules.
credenzo sbomGenerate a CycloneDX 1.5 SBOM for all MCP servers in PATH.
credenzo scanScan MCP configurations for security issues.
credenzo shadowFind your shadow MCP servers — OWASP MCP09.
credenzo snapshotTime-stamped signed forensic snapshots of every MCP server on this host.
credenzo unwrapRestore servers wrapped by credenzo wrap to their original entries.
credenzo update-registryFetch the latest known-server registry from the upstream repository.
credenzo verifyVerify package integrity by comparing hashes against registry pins.
credenzo versionShow version information.
credenzo vetPre-install verdict on a public MCP server package.
credenzo watchContinuously monitor MCP configs and scan on changes.
credenzo wrapLaunch local MCP servers through credenzo run (EPIC-0009).
credenzo agent-files discoverDiscover agent instruction and memory files across supported AI clients.
credenzo agent-files scanScan agent instruction and memory files for security issues.
credenzo baseline saveCapture a baseline snapshot of the current MCP configuration.
credenzo baseline listList all saved baselines.
credenzo baseline compareCompare the current MCP configuration against a saved baseline.
credenzo baseline deleteDelete a saved baseline.
credenzo baseline exportWrite a baseline as raw JSON to stdout (pipeable) or a file.
credenzo extensions discoverDiscover installed IDE extensions across supported AI coding clients.
credenzo extensions scanScan installed IDE extensions for security issues.
credenzo feed verifyRe-canonicalize and verify every signature in a feed directory.
credenzo plugins discoverList installed Claude Code plugins, their source pin, and what they ship.
credenzo plugins scanScan installed Claude Code plugins: pin integrity, mods, skills, MCP servers.
credenzo policy validateValidate a governance policy file (schema check only).
credenzo policy initWrite a commented governance policy template to disk.
credenzo policy checkEvaluate governance policy violations only (no full security scan).
credenzo rule validateValidate a rule file without running a scan.
credenzo rule testTest a rule file against a specific MCP config file.
credenzo rule listList all currently loaded rules (bundled + user-local).

Documentation

The full documentation lives in the repository. Start with the README and the changelog.