AAK-MCP-OPENAPI-BLOATED-PARAMS-001: OpenAPI operation with more than 12 parameters or more than 24 request-body properties (Hermes BLOATED)
- Severity
- LOW
- Category
- Tool Poisoning (
tool-poisoning) - Scanner
agent_audit_kit/scanners/openapi_smells.py- Auto-fixable
- No.
- SARIF name
OpenApiBloatedParameters
What it detects
An OpenAPI 3.x operation declares more than 12 parameters or more than 24 requestBody schema properties. Per Hermes (arXiv:2605.14312), bloated operations exceed the working-memory budget of mainstream LLM tool-callers (typical context budget per tool: 8-12 fields) and cause partial-argument hallucination or skipped operations. Affects MCP servers that auto-generate tools from a CRUD REST API.
How to fix
Decompose the operation into smaller MCP tools, each owning <=12 parameters, OR split the request body into nested sub-operations. If the breadth is required, expose a structured-output schema that the agent can consult before the call.
To confirm the finding is gone, report only this rule:
agent-audit-kit scan . --rules AAK-MCP-OPENAPI-BLOATED-PARAMS-001
Limitations
Counts the entries of an operation's own parameters list and the properties of an inline request-body schema. A request body whose schema is a $ref into components, and parameters declared once at the path level, are not counted, and the spec must be at the project root or under a top-level api/, openapi/, spec/ or docs/api/ folder (backend/openapi.yaml is not found). A spec over 1 MB is not read.
References
- Incidents and advisories: ARXIV-2605.14312
- 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-MCP-OPENAPI-BLOATED-PARAMS-001.md: the page then shows that text, with the registry reference appended under it.