Skip to content

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


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.