Redocly against Stoplight on what an agent reads
In short
Redocly serves documentation and API descriptions to AI clients through an MCP server with access control and custom tools. Stoplight: docs.stoplight.io returned 404 for /llms.txt on 2026-11-04, and stoplight.io returned 404 for /llms.txt the same day. Redocly leads on llms.txt generation, 2 to 0; Stoplight: No documented generator; none found on docs.stoplight.io.
The sourced difference
Redocly generates llms.txt with markdown copies of each page and an MCP server for docs; docs.stoplight.io and stoplight.io both returned 404 for /llms.txt on 2026-11-04. https://docs.stoplight.io/llms.txt (404 on the read date), read 4 November 2026.
The rubric side by side
| Key | Redocly | Stoplight |
|---|---|---|
| Content in the initial HTML | 2, on by default | 1, with setup |
| Real status codes | 2, on by default | 2, on by default |
| llms.txt generation | 2, on by default | 0, not offered |
| llms.txt linking | 1, with setup | 0, not offered |
| Markdown on request | 1, with setup | 0, not offered |
| JSON-LD output | 0, not offered | 0, not offered |
| OpenAPI exposure | 2, on by default | 2, on by default |
| Fenced, tagged code | 2, on by default | 1, with setup |
| Total | 12 of 16 | 6 of 16 |
The two differ on 5 of the numeric keys: content in the initial HTML, llms.txt generation, llms.txt linking, markdown on request, fenced, tagged code. Evidence for each score is on the profiles of Redocly and Stoplight.
Verdicts by reader
- Technical SEO
- Redocly sites ship the files; Stoplight sites need them added by hand.
- Docs owner
- On Stoplight, plan to host llms.txt elsewhere or at the edge.
- Front-end developer
- Stoplight Elements is a React or web component, so prerender it if agents must read the reference.
What each leaves undone
Redocly
- Does not document Accept-header negotiation on its AI-ready page.
- Does not document JSON-LD output for agents.
Stoplight
- Does not publish an llms.txt on its own docs host as of 2026-11-04.
- Does not document markdown output for agents.
Work left to the developer: Redocly, Low: configure llms.txt sections under SEO config. Stoplight, High: write llms.txt by hand, host it yourself, and prerender any embedded Elements reference.
Sources
- docs.stoplight.io: the difference https://docs.stoplight.io/llms.txt (404 on the read date), read 4 November 2026
- Redocly: documentation https://redocly.com/docs/realm/ai-ready, read 4 November 2026
- Stoplight: documentation https://github.com/stoplightio/elements, read 4 November 2026
Last reviewed 4 November 2026