mcp-audit is becoming Credenzo, the taste test for agent tools. The package is still mcp-audit-scanner and the command is still mcp-audit.
Part 3 · How · 2 min
Your first 15 minutes
Install, get a grade, fix the easy things, and look at the full list.
Install
You need Python 3.11 or newer. The package is called mcp-audit-scanner; the command it installs is mcp-audit.
$ pip install mcp-audit-scanner
$ mcp-audit version
On a Mac, if pip fails with “bad interpreter”, use python3 -m pip install mcp-audit-scanner. If mcp-audit isn't found afterwards, Python's bin folder isn't on your PATH; the README's macOS notes show the one-line fix. Standalone binaries that need no Python are on the Releases page.
See what you have
$ mcp-audit discover
Most people find more servers than they expected, including ones added by plugins.
Get your grade
$ mcp-audit check
A or B with nothing HIGH or CRITICAL means you're in good shape. Anything else, read the top five and their hints.
Preview the safe fixes, then apply them
$ mcp-audit fix # shows the changes, writes nothing$ mcp-audit fix --apply # writes them, keeps a .bak copy
When fix moves a secret out of your config, it puts a placeholder like ${GITHUB_TOKEN} in its place. Set that environment variable where your AI client can see it.
Read the full list
$ mcp-audit scan
$ mcp-audit check # again, to see the new grade
Tip for vibe codersPaste a finding into your AI assistant and ask “explain this and how to fix it in my setup.” Credenzo redacts secrets in its evidence, but read what you paste before you send it.
One-command verdict
Get started
mcp-audit check
What
Scans every MCP config on your machine and prints a letter grade, a 0–100 score, your top five issues and a fix hint for each.
Why it matters
You get an answer in seconds without reading a long report. Start here.
Rewrites your config to fix the safe, mechanical problems: moves pasted secrets to environment variables, upgrades http:// to https://, replaces a look-alike package with the real one.
Why it matters
Fixes the common mistakes without you editing JSON by hand.
Under the hood: install options and offline behaviour
uv add mcp-audit-scanner also works. Extras: [mcp] for --connect, [attestation] for Sigstore. Standalone binaries are PyInstaller builds (about ten seconds of silent startup) and each release attaches a CycloneDX SBOM per binary.
scan is offline. check is offline unless you have run mcp-audit register, after which each run sends a short ping with the grade. fix, sbom and lock look up package versions online unless you pass --offline. Full list: docs/privacy.md.
Check yourself
1. What's the pip package name?
The name mcp-audit was taken on PyPI. The command is still mcp-audit.
2. What does mcp-audit fix do without --apply?
Dry run by default. --apply writes and keeps a .bak backup.
3. After fix moves a token to ${GITHUB_TOKEN}, what must you do?
The config now references the variable instead of holding the secret.