AAK-POISON-005: Excessive tool description length
- Severity
- MEDIUM
- Category
- Tool Poisoning (
tool-poisoning) - Scanner
agent_audit_kit/scanners/tool_poisoning.py- Auto-fixable
- No.
- SARIF name
ToolDescExcessiveLength
What it detects
Tool description exceeds 500 characters, which increases the surface area for hidden instructions.
How to fix
Keep tool descriptions concise and under 500 characters.
To confirm the finding is gone, report only this rule:
agent-audit-kit scan . --rules AAK-POISON-005
Limitations
The 500-character limit is applied to each description string on its own. A tool whose description and parameter descriptions each stay under it is not reported, however much instruction text they add up to.
References
- OWASP MCP Top 10: MCP03:2025 (Tool Poisoning)
- OWASP Agentic Top 10: ASI02 (Tool Misuse and Exploitation), ASI04 (Agentic Supply Chain Vulnerabilities)
- Adversa AI MCP Top 25 (AAK-defined ids): ADV-POISON-05 (Excessive Description)
- CSA AI Controls Matrix (AICM): AIS-07
All rules. This page is generated from the rule registry when the documentation is built; to change it, change the rule in agent_audit_kit/rules/builtin.py. To give the rule a hand-written write-up, add docs/rules/AAK-POISON-005.md: the page then shows that text, with the registry reference appended under it.