AI AppSec: Find AI Code Risks Before You Ship
Scan your AI application and agent source code. See the finding, the coverage and the evidence behind it.
AI AppSec is HAIEC's open-source security scanner for supported AI application and agent code. It detects risky source patterns, insecure integrations and potential security control gaps using deterministic static analysis.
Run it locally through a compatible AI coding assistant, inspect source-linked findings and scan coverage, and compare results after making a fix.
Open source. No HAIEC account required. Evidence you can inspect.
Find the risk. Understand the evidence.
AI AppSec checks supported application code for unsafe use of AI-generated output, potential secrets exposure, prompt-related risk patterns and insecure AI integrations. It separates security findings from informational indicators and records which files and checks were evaluated.
Know what was actually scanned
A scan that missed files should never be presented as a clean result. AI AppSec preserves coverage and analysis limitations so developers know where further review is needed.
Fix the issue. Check again.
After addressing a finding, rescan the relevant code and compare eligible findings. See what remains, what changed and what could not be verified.
Work with your AI coding agent
Connect AI AppSec as a local MCP server in a supported coding environment. Ask your assistant to scan an authorized source directory, review findings and explain remediation options. The scanner produces the structured technical result. Your assistant helps you work with it.
What AI AppSec Does
AI AppSec produces deterministic, reproducible static security evidence for AI-agent and AI-application source code. It uses Semgrep 1.173.0 as its execution engine with a bundled Public Core rulepack (122 detectors, 79 security checks).
Static analysis only
Does not execute target code
No network required
Normal scans run fully offline after setup
No account needed
No HAIEC account or API key required
Deterministic evidence
Scan Receipts with SHA-256 digests
Finding kinds
Severity levels
Dispositions
Rule Architecture
AI AppSec uses a bundled Public Core rulepack with 122 detectors and 79 security checks. Detectors identify patterns; security checks evaluate whether those patterns represent risks.
Security concern families
Findings are grouped into concern families for decision-quality presentation. A concern family is a deterministic grouping view — it is not necessarily one vulnerability, one material issue, or one root cause. Underlying finding instances remain auditable.
Concern family count is not a vulnerability count. Top 20 / Top 50 are presentation limits, not evidence limits.
Supported file types
Extensions: .py, .js, .jsx, .ts, .tsx
What scan_ai_security checks
- • Unsafe AI-output execution
- • Secrets exposure
- • RAG / model integration risks
- • Insecure AI API usage
- • Control gaps
- • Prompt / input-related risk signals
Evidence & Receipts
Scan Receipt
Every scan produces a tamper-evident Scan Receipt with SHA-256 digests for:
- • Finding set
- • Concern family set
- • Coverage file sets
- • Evaluated security checks and detectors
- • Semantic receipt identity
COMPLETE scans produce reproducible receipts across processes and operating systems. PARTIAL scans preserve run-specific coverage differences.
Evidence Envelope
Each scan produces an Evidence Envelope that binds the receipt to the scan execution context, including producer identity, target identity (scan input digest, git commit, dirty state), execution status and completeness, semantic receipt digest, and envelope digest.
Proof-of-fix
Rescan a target after a fix to compare receipts. The proof-of-fix comparison is safe: it verifies that a specific security check's findings were resolved without requiring the entire scan to be identical. Findings are tagged as STILL_PRESENT, NEW, or NOT_VERIFIABLE.
Coverage Accounting
AI AppSec provides explicit coverage accounting so you always know what was and was not analyzed. Missing evidence is never interpreted as PASS.
DISCOVEREDAll files found beneath the targetINTENTIONALLY_EXCLUDEDFiles excluded by scope policyUNSUPPORTEDFiles outside supported extensionsTARGETEDSupported files intended for analysisENGINE_REPORTED_SCANNEDFiles Semgrep reports as scannedPARSE_FAILEDFiles with parse errorsSUCCESSFULLY_ANALYZEDScanned minus parse failuresCOMPLETE / PARTIAL / ERROR
MCP Integration
AI AppSec runs as an MCP server via stdio transport. Plug it into Claude Desktop, Cursor, Windsurf, or any MCP-compatible agent.
MCP identifier: io.github.subodhkc/ai-appsec
Transport: stdio only
MCP server configuration
{
"mcpServers": {
"ai-appsec": {
"command": "npx",
"args": ["-y", "ai-appsec"]
}
}
}MCP tool: scan_ai_security
The only tool implemented in v0.1. Scans AI/LLM/agent application source code for security risks. Accepts a targetPath (required) with optional extendedScope and timeout. Returns findings with coverage, concern families, and scan receipt.
Write access: No — read-only scan tool.
Use with your AI coding agent
MCP identifier: io.github.subodhkc/ai-appsec · Transport: stdio
Add the server config for your environment below, restart the agent, then prompt it in natural language — e.g. “use the ai-appsec MCP tools to check this output before you show it to me”. Copyable prompts are at the bottom.
Configuration file
.cursor/mcp.json{
"mcpServers": {
"ai-appsec": {
"command": "npx",
"args": ["-y", "ai-appsec"]
}
}
}Project rule: .cursor/rules/ai-appsec.md
# ai-appsec Security Rule Use the ai-appsec MCP server to scan code for security issues. When the user asks to "scan", "audit", or "check security", invoke the appropriate MCP tool. Always report findings by severity (CRITICAL first). Do not merge code with unresolved CRITICAL findings.
Prompt your agent — copyable instructions
Use scan_ai_security to audit supported source files under ./src. Report exact finding locations, coverage, limitations, and recommended review actions (CRITICAL first). Flag CRITICAL findings for human review before merge.
Use scan_ai_security to scan the current project. List all CRITICAL and HIGH findings with file paths and remediation hints.
Use scan_ai_security to scan supported files under ./src. Filter findings to prompt/input-related risk signals. Report each with file, line, and severity.
CLI Commands
The ai-appsec binary manages prerequisites and starts the MCP server. Scanning itself happens through the scan_ai_security MCP tool, invoked by a compatible MCP client — there is no direct CLI scan subcommand in the verified package.
CLI commands
$ ai-appsec doctor$ ai-appsec doctor --json$ ai-appsec setup$ ai-appsec setup --json$ ai-appsec help$ ai-appsecdoctor — check Semgrep status
setup — install Semgrep engine (requires network)
help — usage information
(no args) — start MCP server (stdio transport)
Offline / local operation
Normal scanning operates fully offline after prerequisites are installed. No HAIEC cloud access required. No account or API key required. No rule download during scanning. No telemetry emitted (Semgrep invoked with --metrics off).
ai-appsec setup may require network access to install the Semgrep engine. Once installed, all scanning is local.
Limitations
What AI AppSec does not do
- •Static analysis only — no runtime behavioral evidence
- •No compliance certification or assessment
- •No tenant isolation checking (roadmap)
- •No LLM content verification (roadmap)
- •No deploy security gating (roadmap)
- •PARTIAL scans cannot prove absence of findings
- •Requires Semgrep 1.173.0 (exact version match, installed separately)
- •Only scan_ai_security tool implemented in v0.1
Roadmap (not yet implemented)
These are future capabilities. They are not available in the current release and should not be presented as current features.
Trust & Security
License
MIT — open source, free to use
Semgrep prerequisite
Requires Semgrep 1.173.0 (exact version match). Not bundled — installed separately via ai-appsec setup.
From open-source scanning to broader AI assurance
AI AppSec identifies source-level security concerns. HAIEC's broader platform can examine relevant permissions, delegated authority, action paths and runtime observations through separately qualified evidence and evaluations.
Start with the code. Expand the assurance scope when the decision requires it.
AI AppSec vs HAIEC Platform AI Security Scanner
AI AppSec is an independent open-source package (122 detectors, 79 security checks, Semgrep-backed). The HAIEC Platform AI Security Scanner is a separate product with its own rule set. They are distinct tools with different rule sets and capabilities. Do not conflate them.