Skip to main content

agentconfig-audit-lite: audit MCP config for secrets, unpinned servers and unsafe Claude Code settings

agentconfig-audit-lite helps with auditing MCP config for secrets and a quick check of the AI agent setup in one project: it lists the MCP server configs and agent rule files it finds, and flags plaintext tokens, npx/uvx MCP servers with no version pin, and Claude Code settings that don't keep the agent away from .env files and migrations. One file, Python 3.9+ standard library only, read-only, MIT.

  • Optional pip install, or just download the one file. No config, no state, no network calls.
  • Secrets are shown as masked previews only (ghp_****(40 chars)), never in full.
  • Flags: --file, --version. After pip install, use agentconfig-audit-lite in place of python3 agentconfig_audit_lite.py.

Install

pip install agentconfig-audit-lite
agentconfig-audit-lite --help

Or download the single file (Python 3.9+, stdlib only, no extra packages):

curl -fsSLO https://raw.githubusercontent.com/alessio1999xx-debug/agentconfig-audit-lite/main/agentconfig_audit_lite.py
python3 agentconfig_audit_lite.py --help

Scan a project's MCP config and CLAUDE.md / AGENTS.md rules

python3 agentconfig_audit_lite.py ~/code/my-app
# agentconfig-audit-lite 0.1.0: /home/me/code/my-app
#
# Found 3 agent config / rule file(s):
#   settings  .claude/settings.json
#   mcp       .mcp.json
#   rules     CLAUDE.md
#
# 3 finding(s):
#   FAIL  [unpinned-server] .mcp.json: server 'github' runs `npx @modelcontextprotocol/server-github` with no version pin (pin e.g. pkg@1.2.3 or pkg==1.2.3)
#   FAIL  [plaintext-secret] .mcp.json: server 'github' env GITHUB_PERSONAL_ACCESS_TOKEN = ghp_****(40 chars) (GitHub token)
#   FAIL  [migrations-not-denied] .claude/settings.json: project has a migrations dir but no Edit and Write deny rules for it and no PreToolUse hook

# also check a config that lives outside the project
python3 agentconfig_audit_lite.py . --file ~/.cursor/mcp.json --file ~/.claude/settings.json

Which MCP configs and agent rule files it checks

Files (searched in the project dir, skipping .git, node_modules, virtualenvs and build dirs):

  • MCP configs: .mcp.json, .cursor/mcp.json, .vscode/mcp.json, mcp.json, claude_desktop_config.json, mcp_config.json
  • Agent rule files: CLAUDE.md, CLAUDE.local.md, AGENTS.md, GEMINI.md, .cursorrules, .windsurfrules, .cursor/rules/*, copilot-instructions.md
  • Claude Code settings: .claude/settings.json, .claude/settings.local.json (any .claude/settings*.json)

Checks:

Check What it flags
plaintext-secret Known token formats (GitHub, OpenAI/Anthropic-style sk-, AWS, Slack, GitLab, Google, Stripe live, Bearer, private keys) in MCP env/headers/args and rule files, plus hardcoded values under names like *_TOKEN or *_PASSWORD. ${VAR} references are fine.
unpinned-server npx, uvx or bunx MCP servers with no exact version (pkg, pkg@latest, pkg@^1.2). pkg@1.2.3 and pkg==1.2.3 pass.
env-not-denied The project has a .env file (not .env.example) and Claude Code settings have no Read(...env...) deny rule and no PreToolUse hook.
migrations-not-denied The project has a migrations dir and settings don't deny both Edit and Write on it, and there's no PreToolUse hook.
secret-in-allow-rule A token pasted into a permissions.allow rule in .claude/settings*.json (this happens when you approve a command that had a key in it).

The two Claude Code settings checks only run when the project uses Claude Code (a CLAUDE.md or .claude/settings*.json exists). A PreToolUse hook is counted as protection, but the lite version doesn't check what the hook actually does. A rule in CLAUDE.md saying "don't touch .env" is not counted: it's an instruction, not a permission.

JSON with comments can't be parsed by the standard library; those files get a NOTE and a plain-text token scan only.

Exit codes for CI or cron

Exit code Meaning
0 No findings
1 At least one finding
2 Bad arguments, project dir or --file not found

agentconfig-audit-lite vs AgentConfig Audit

agentconfig-audit-lite checks one project dir and prints a plain text list. That's it.

The full AgentConfig Audit helps with:

  • finding the MCP configs installed on the machine (Claude Desktop, Cursor, VS Code, Windsurf, Codex, ~/.claude.json) on macOS, Linux and Windows
  • MCP servers given the whole filesystem (/, ~, /home, C:\) and remote MCP endpoints with no auth header or plain http://
  • hidden Unicode (zero-width and bidi override characters) and prompt-injection phrases in rule files
  • JSON and SARIF 2.1.0 reports, written to a file if you want
  • a suggested fix or command for each finding, severity levels and a --strict mode for HIGH/CRITICAL only

One-time payment, yours to keep. No subscription.

Or get every PyForge tool, current and future, with the All-Access Pass.

Tests

python3 test_agentconfig_audit_lite.py

The tests are offline and build their fixtures in temp dirs. Fake tokens are generated at runtime.

License

MIT (this lite version). The full AgentConfig Audit is sold separately under its own license.

Metadata

Release files for agentconfig-audit-lite 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agentconfig-audit-lite 0.1.0
File Size Uploaded Provenance Actions
agentconfig_audit_lite-0.1.0.tar.gz 12.0 kB With provenance Details for agentconfig_audit_lite-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for agentconfig-audit-lite 0.1.0
File Interpreter ABI Platform Actions
agentconfig_audit_lite-0.1.0-py3-none-any.whl Python 3 none any Details for agentconfig_audit_lite-0.1.0-py3-none-any.whl

Total release size: 22.3 kB

Release files / agentconfig_audit_lite-0.1.0.tar.gz

Download URL agentconfig_audit_lite-0.1.0.tar.gz
Size 12.0 kB
Tags Source
SHA-256 checksum
How to use checksums
8bc38d62545ec7ef5da8adeeeca0b778073977beb12bec003c33ee519f7448c4
BLAKE2b-256 checksum
How to use checksums
7a97bdf3a997ccc06fe244d1941386d165ea04fb0814ad3d8f6c839cc093084a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / agentconfig_audit_lite-0.1.0-py3-none-any.whl

Download URL agentconfig_audit_lite-0.1.0-py3-none-any.whl
Size 10.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5f205df663dcb0416d2ea9f58969c853113306f7eb216fa30d482e206ce2cfe3
BLAKE2b-256 checksum
How to use checksums
a67e081330b7ee89b45676c24a235f57287cd730dcc11963808bfbe41ec90777
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Security for agentconfig-audit-lite 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for agentconfig_audit_lite-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page