OpenAPI describes an API. Agent Readiness describes whether an agent can actually use it.
Your API has a complete OpenAPI spec. Every endpoint, schema, and response code is documented. Yet when an AI agent tries to use it, the agent fails — not because the spec is wrong, but because the spec describes an interface, not an agent's experience.
This isn't about OpenAPI being bad. OpenAPI is a necessary foundation. But it's not a complete Agent Readiness layer.
The Provocation
"Our API has OpenAPI. Why does an AI agent still fail to use it?"
