Score your OpenAPI spec in seconds. Find out what LLMs struggle with — and fix it before your users do.
Do your operations and schemas include request/response examples? LLMs learn from examples more than descriptions.
Are descriptions meaningful (not just "Gets a thing")? Agents need context to pick the right endpoint.
Do you document 4xx/5xx responses? Agents need to handle failures gracefully. Bonus for RFC 9457 Problem Detail.
Are operationIds descriptive? Are endpoints tagged? Agents use these to understand what an endpoint does.
Are query params described? "limit" is obvious — "q" is not. Agents need to know what values to pass.
Can agents paginate through list endpoints? Missing pagination means truncated data or infinite loops.