--- title: "Redocly: agent readability profile: Agent Ready HTML" description: "Redocly scores 12 of 16 on the read-layer rubric: initial HTML, status codes, llms.txt, markdown, JSON-LD, OpenAPI and code. Read 2026-11-04." canonical: https://agentreadyhtml.com/platforms/redocly/ site: "Agent Ready HTML" last_updated: 2026-11-04 section: "Platforms" --- # Redocly: agent readability profile: Agent Ready HTML > Redocly scores 12 of 16 on the read-layer rubric: initial HTML, status codes, llms.txt, markdown, JSON-LD, OpenAPI and code. Read 2026-11-04. Source: https://agentreadyhtml.com/platforms/redocly/ Site: Agent Ready HTML Last reviewed: 2026-11-04 # Redocly: what an agent reads In short Redocly does not document Accept-header negotiation on its AI-ready page. Redocly totals 12 of 16 on the eight numeric keys, from a test build of Redocly open CLI @redocly/cli 2.75.0 (pinned with npx @redocly/cli@2.75.0). It also does not document JSON-LD output for agents. **rubric.txt** redocly ```text initial_html_by_default = 2 real_status_codes = 2 llms_txt_generation = 2 llms_txt_linking = 1 markdown_negotiation = 1 jsonld_output = 0 openapi_exposure = 2 fenced_code = 2 total = 12 of 16 ``` Test build of @redocly/cli 2.75.0 (pinned with npx @redocly/cli@2.75.0), 2026-11-05. **Redocly** Docs platform, Redocly API docs platform (Realm) that creates an llms.txt with a clean markdown version of each page, plus an MCP server for docs and API descriptions. Work left to the developer: Low: configure llms.txt sections under SEO config. ## The nine scores | Key | Score | Evidence | Source | | --- | --- | --- | --- | | Content in the initial HTML | 2, on by default | Pages render content server-side; markdown copies exist. Not test-built: the hosted Redocly product needs an account (the open CLI was built, see below). Score from the documentation page cited, read 2026-11-04. Redocly CLI 2.75.0 build-docs (open source, tested 2026-11-05) wrote one 254,744-byte (249 KiB) HTML file with the title as a prerendered H1 and no llms.txt, robots.txt or JSON-LD. Redocly CLI 2.75.0 build-docs (open source, tested 2026-11-05) wrote one 254,744-byte (249 KiB) HTML file with the title as a prerendered H1 and no llms.txt, robots.txt or JSON-LD. | redocly.com/docs/realm/ai-ready, 2026-11-04 | | Real status codes | 2, on by default | A made-up path on redocly.com returned 404. Observed on the vendor's own site with a plain fetch on 2026-11-04; the vendor's own site may not use default settings. | GET redocly.com/agent-ready-html-missing-path-check: 404 as observed, 2026-11-04 | | llms.txt generation | 2, on by default | Created for every site. Not test-built: the hosted Redocly product needs an account (the open CLI was built, see below). Score from the documentation page cited, read 2026-11-04. | redocly.com/docs/realm/ai-ready, 2026-11-04 | | llms.txt linking | 1, with setup | Linking from pages is not documented on the page read. Not test-built: the hosted Redocly product needs an account (the open CLI was built, see below). Score from the documentation page cited, read 2026-11-04. | redocly.com/docs/realm/ai-ready, 2026-11-04 | | Markdown on request | 1, with setup | Markdown copies documented; negotiation observed on redocly.com but not documented on the page read. Not test-built: the hosted Redocly product needs an account (the open CLI was built, see below). Score from the documentation page cited, read 2026-11-04. | redocly.com/docs/realm/ai-ready, 2026-11-04 | | JSON-LD output | 0, not offered | Not documented on the page read. Not test-built: the hosted Redocly product needs an account (the open CLI was built, see below). Score from the documentation page cited, read 2026-11-04. | redocly.com/docs/realm/ai-ready, 2026-11-04 | | OpenAPI exposure | 2, on by default | API descriptions are core output and served over MCP. Not test-built: the hosted Redocly product needs an account (the open CLI was built, see below). Score from the documentation page cited, read 2026-11-04. | redocly.com/docs/realm/ai-ready, 2026-11-04 | | Fenced, tagged code | 2, on by default | Markdown copies keep code blocks. Not test-built: the hosted Redocly product needs an account (the open CLI was built, see below). Score from the documentation page cited, read 2026-11-04. | redocly.com/docs/realm/ai-ready, 2026-11-04 | | Work left to the developer | | Low: configure llms.txt sections under SEO config. Configurable. Not test-built: the hosted Redocly product needs an account (the open CLI was built, see below). Score from the documentation page cited, read 2026-11-04. | redocly.com/docs/realm/ai-ready, 2026-11-04 | ## Test build Redocly open CLI @redocly/cli 2.75.0 (pinned with npx @redocly/cli@2.75.0), built on 5 November 2026. npx @redocly/cli@2.75.0 build-docs on a short OpenAPI file (7 lines, published below), re-run on 5 November 2026 pinned to the version npm published on 4 November. The hosted Redocly product needs an account and was not built. What it emitted: - build-docs wrote one 254,744-byte (249 KiB) index.html with the title as an H1 in the prerendered HTML. - It wrote no llms.txt, robots.txt or JSON-LD. The exact input, saved as `openapi.yaml`. The size of the output depends on it, so the figure above is for this file only: openapi: 3.0.3 info: { title: Test API, version: 1.0.0, description: "A tiny API used to see what the docs build emits." } paths: /ping: get: summary: Ping responses: { '200': { description: pong } } Run `npx @redocly/cli@2.75.0 build-docs openapi.yaml -o out/index.html` to reproduce it; the output here was 254,744 bytes. Scoring rules for every key are on the [method page](https://agentreadyhtml.com/method/). ## What the documentation says Each statement below carries its source and the date read. Statements a vendor makes about itself are labelled as vendor claims. - Redocly creates an llms.txt for each site that lists pages and links a clean markdown version of each, in the llmstxt.org format. \[primary source\] [source](https://redocly.com/docs/realm/ai-ready), read 4 November 2026. - Redocly serves documentation and API descriptions to AI clients through an MCP server with access control and custom tools. \[primary source\] [source](https://redocly.com/docs/realm/ai-ready), read 4 November 2026. - llms.txt title, description and sections are configurable under the SEO config, and the file can be turned off. \[primary source\] [source](https://redocly.com/docs/realm/ai-ready), read 4 November 2026. - redocly.com/llms.txt was 127,944 bytes with 1,152 links on 2026-11-04. \[primary source\] [source](https://redocly.com/llms.txt), read 4 November 2026. - On 2026-11-04 redocly.com answered Accept: text/markdown with text/markdown. \[primary source\] [source](https://redocly.com/), read 4 November 2026. ## What it does not do - Does not document Accept-header negotiation on its AI-ready page. - Does not document JSON-LD output for agents. ## Compare and replace - [Redocly against Scalar](https://agentreadyhtml.com/compare/redocly-vs-scalar/) - [Redocly against Stoplight](https://agentreadyhtml.com/compare/redocly-vs-stoplight/) - [Alternatives to Redocly](https://agentreadyhtml.com/platforms/redocly/alternatives/) - [Redocly: vendor profile](https://agentreadyhtml.com/vendors/redocly/) - [Redocly home page](https://redocly.com/) ## Sources 1. [Redocly: Make docs AI ready](https://redocly.com/docs/realm/ai-ready) https://redocly.com/docs/realm/ai-ready, read 4 November 2026 2. [redocly.com](https://redocly.com/llms.txt) https://redocly.com/llms.txt, read 4 November 2026 3. [redocly.com](https://redocly.com/) https://redocly.com/, read 4 November 2026 4. redocly.com https://redocly.com/agent-ready-html-missing-path-check (a probe path that answers 404 on purpose), read 4 November 2026 Last reviewed 4 November 2026 Edition Crawl 2026-11-04 Page updated 2026-11-04 Method How the viewer reads a page, how a file is graded and how a platform is scored: [the method page](https://agentreadyhtml.com/method/).