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 property | Why AI agents and MCP bridges need it | Rule |
|---|---|---|
operationId & summary | Map directly to the tool function name and tool selection prompt | ADP-017 |
example / examples | Show exact ID prefixes, ISO 8601 UTC dates, and integer currency units | ADP-019 |
maxLength / maxItems / enum | Prevent hallucinated strings, oversized arrays, and invalid states | ADP-021 |
Idempotency-Key | Make agent retries after network timeouts safe on writes | ADP-012 |
application/problem+json | Give agents machine-readable detail hints to fix invalid calls | ADP-008 |