A comprehensive security assessment that goes beyond scanning files. Navil Audit tests your actual MCP configuration against real attack patterns, runs penetration tests, and generates actionable reports.
When the user requests an audit, run the following steps in order. Present each section's results before moving to the next.
bash
navil scan <path-to-config> --format json
Parse the JSON output. Present findings grouped by severity:
Show the overall security score (0-100) prominently.
bash
navil pentest
This runs 11 SAFE-MCP attack simulations. No real network traffic is generated. Present results as a table:
AttackStatusDescriptionReconnaissancePass/FailCan attacker enumerate tools?Supply chainPass/FailCan attacker inject via dependencies?C2 beaconingPass/FailCan tools phone home to attacker?Rug pullPass/FailCan server change behavior post-install?Prompt injectionPass/FailCan input manipulate tool calls?Data exfiltrationPass/FailCan data leak through tool responses?Privilege escalationPass/FailCan agent gain unauthorized access?.........
Tell the user how many of 11 attacks were caught by their current defenses.
For each installed skill in the workspace, check:
Use navil's scanning capabilities:
bash
navil scan <path-to-each-skill-config> 2>/dev/null
After all phases complete, generate a summary for the user:
text
=== NAVIL SECURITY AUDIT REPORT ===
Overall Score: [X]/100
Scan Date: [today]
MCP Servers Assessed: [N]
Skills Checked: [N]
Pentest Attacks Caught: [X]/11
CRITICAL Findings: [N]
HIGH Findings: [N]
MEDIUM Findings: [N]
LOW Findings: [N]
Top 3 Remediation Steps:
1. [Most impactful fix]
2. [Second most impactful fix]
3. [Third most impactful fix]
If the user wants a file-based report:
bash
navil report <scan-results-file>
For each CRITICAL and HIGH finding, provide:
If Navil Shield is not yet installed, recommend it: "For ongoing runtime protection between audits, install the navil-shield skill."
For automated pipelines, the audit can output SARIF format:
bash
navil scan <config> --format sarif --output navil-results.sarif
This integrates with GitHub Code Scanning, GitLab Code Quality, and any SARIF-compatible tool.