AI-agent and MCP ready APIs

Deterministic OpenAPI contracts for LLM tools and MCP adapters (ADP-017, ADP-032).

OpenAPI properties for tool calling

Keep schemas deterministic so agents do not guess parameters or retry unsafe writes.

OpenAPI propertyWhy AI agents and MCP bridges need itRule
operationId & summaryMap directly to the tool function name and tool selection promptADP-017
example / examplesShow exact ID prefixes, ISO 8601 UTC dates, and integer currency unitsADP-019
maxLength / maxItems / enumPrevent hallucinated strings, oversized arrays, and invalid statesADP-021
Idempotency-KeyMake agent retries after network timeouts safe on writesADP-012
application/problem+jsonGive agents machine-readable detail hints to fix invalid callsADP-008