mcpField
A
agent-security-audit

agent-security-audit

github.com/owaspSecurity208253 installsUpdated 2w ago
Repository

About agent-security-audit

agent-security-audit is a security skill for evaluating an AI agent’s security posture. It examines permissions, injection paths, data exposure, tool calls, and guardrails, then organizes findings and recommendations.

Key features

  1. 01Inventory of tools, access, and credentials
  2. 02Prompt injection surface analysis
  3. 03Excessive agency assessment
  4. 04Sensitive data exfiltration path mapping
  5. 05Tool-call injection and guardrail review

Use cases

  1. 01Reviewing an agent’s permissions against its purpose
  2. 02Finding injection routes through inputs and tools
  3. 03Assessing safeguards against data exposure and harmful actions

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/owasp/secure-agent-playbook --skill agent-security-audit

After installing, type/agent-security-auditin Claude Code to confirm it loaded.

Details

From the project README

Agent Security Audit

Evaluate an AI agent's security posture by following the full procedure in plays/agent-security-audit.md.

Steps

  1. Permission Inventory — Enumerate every tool, MCP server, file system path, network access, and credential the agent has. Flag capabilities beyond what its stated purpose requires.

  2. Prompt Injection Surface Analysis — For each input path (user messages, tool outputs, MCP resources, RAG documents), assess whether crafted input could cause the agent to invoke unintended tools, override instructions, or exfiltrate data.

  3. Excessive Agency Assessment (OWASP LLM06) — Check whether destructive/irreversible actions require confirmation, whether access exceeds need, whether the agent can escalate its own privileges, and whether individually-safe tool calls can chain into harmful outcomes.

  4. Data Exfiltration Path Analysis — Map how sensitive data could leave the agent boundary: secrets passed to external tools, file contents in web requests, cross-MCP-server data forwarding, sensitive data in logs.

  5. Tool-Call Injection Assessment — For each tool: can user-controlled input reach tool parameters unsanitized? Check for command injection, path traversal, SSRF, and SQL injection through agent-constructed calls.

  6. Guardrail Evaluation — Check for system prompt safety instructions, tool call confirmations, output filtering, rate limiting, audit logging, and sandboxing.

Output

Use the finding format from templates/finding.md. Produce a Permission Summary table, Risk Findings, Injection Surface Map, and prioritized Recommendations.

OWASP References

  • LLM01: Prompt Injection
  • LLM02: Sensitive Information Disclosure
  • LLM05: Improper Output Handling
  • LLM06: Excessive Agency
  • LLM07: System Prompt Leakage
  • LLM08: Vector and Embedding Weaknesses

Comments

Markdown supported