Agent Ready HTML

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

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

KeyScoreEvidenceSource
Content in the initial HTML2, on by defaultPages 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 codes2, on by defaultA 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 generation2, on by defaultCreated 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 linking1, with setupLinking 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 request1, with setupMarkdown 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 output0, not offeredNot 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 exposure2, on by defaultAPI 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 code2, on by defaultMarkdown 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 developerLow: 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.

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, 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, 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, read 4 November 2026.
  • redocly.com/llms.txt was 127,944 bytes with 1,152 links on 2026-11-04. [primary source] source, read 4 November 2026.
  • On 2026-11-04 redocly.com answered Accept: text/markdown with text/markdown. [primary source] source, 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

Sources

  1. Redocly: Make docs AI ready https://redocly.com/docs/realm/ai-ready, read 4 November 2026
  2. redocly.com https://redocly.com/llms.txt, read 4 November 2026
  3. 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