OpenAPI Overlays for MCP and AI-Agent Enrichment

I have been picking apart the use cases from my earlier post, The Many Use Cases for OpenAPI Overlays, and this is the one that sits closest to my heart right now, because it is where APIs and agents actually meet. Agents and MCP servers do not read your API the way a human does. A developer skims your docs, forms a mental model, and forgives your ambiguity.