Audited October 16, 2026 · scoring 100-point-v4

Netlify

Name: Netlify docs: AI Agent Readiness Score 90.7% (A-)
Item: Netlify
Rating: 90.7

A-

Netlify’s public docs score 90.7% (A-): content delivery 50/50, discovery 23.75/25, agent capabilities 17/25. 7 of 10 checks earn full points. Largest gap: API description.

Audited page: docs.netlify.com/ Read as markdown

Netlify Astro Starlight · audited October 16, 2026

A-

90.7% · 90.75/100 · AI Agent Readiness Score

Content delivery · 50/50

Content in server HTML 15/15 PASS

Markdown mirror 15/15 PASS

Page fits one agent fetch 10/10 PASS

AI crawler access 10/10 PASS

Discovery · 23.75/25

llms.txt 15/15 PASS

Sitemap and robots.txt 5/5 PASS

Page metadata 3.75/5 PARTIAL

Agent capabilities · 17/25

MCP server 15/15 PARTIAL

API description 0/5 FAIL

Agent interoperability signals 2/5 PARTIAL

Extra credit · 0/2 · cannot raise the score above 100

llms-full.txt 0/1 FAIL

Docs AI assistant 0/1 FAIL

docs platform: Astro Starlight (unscored) · scoring 100-point-v4

What to fix first

3 checks lose points. They are ranked by the points a fix would add back.

1

+5 API description

Publish an OpenAPI description at a discoverable address when the product has an API.
2

+3 Agent interoperability signals

Add agent discovery signals such as Content Signals, an agent skills index, or an MCP server card.
3

+1.25 Page metadata

Add a canonical link, a meta description, Open Graph tags, and JSON-LD to the server HTML.

Every check, with evidence

Each check shows what the audit found and the points it earned. Evidence links open the exact URL the audit requested.

Content delivery · 50/50

Content in server HTML

15/15 PASS

Agents and crawlers that fetch a page without a browser read only the HTML response. This check looks for the page’s main content in that response.

Found: The server HTML has 5,168 characters of main content; 250 are required.

Markdown mirror

15/15 PASS

Markdown is the cheapest format for an agent to read. This check looks for a Markdown version of this page and confirms that it is the same page.

Found: method: suffix; 2,943 characters

Markdown version of this page (10/10)
Markdown matches the page (5/5)

Evidence: https://docs.netlify.com/index.md (opens in a new tab) · HTTP 200

Page fits one agent fetch

10/10 PASS

Agent tools commonly cut off long responses. This check measures the text an agent receives from this page.

Found: The Markdown version has 2,943 characters.

AI crawler access

10/10 PASS

AI search and user-triggered fetch agents read docs when a person asks a question. This check reads robots.txt rules for those agents.

Found: 0 of 11 AI search and user-triggered fetch agents are blocked in robots.txt.

Discovery · 23.75/25

llms.txt

15/15 PASS

llms.txt is an index that points agents to the documentation. This check validates it, measures it, and samples its links.

Found: 9 sections, 63 links; 25,081 characters; sampled links return Markdown

Valid llms.txt index (7/7)
llms.txt under 50,000 characters (4/4)
llms.txt links return Markdown (4/4)

Evidence: https://docs.netlify.com/llms.txt (opens in a new tab) · HTTP 200

Sitemap and robots.txt

5/5 PASS

A sitemap lists every page, so crawlers do not depend on navigation to find them.

robots.txt present (1/1)
Sitemap declared (2/2)
Sitemap valid XML (2/2)

Page metadata

3.75/5 PARTIAL

Structured page metadata in the server HTML helps machines identify the page and its preferred address.

JSON-LD in raw HTML (0/1.25, missing)
Canonical link (1.25/1.25)
Meta description (1.25/1.25)
Open Graph (1.25/1.25)

Agent capabilities · 17/25

MCP server

15/15 PARTIAL

A Model Context Protocol server lets agents search or use the docs through tools.

Found: present, auth required: Bearer realm="MCP Server", resource_metadata="https://mcp.netlify.com/.well-known/oauth-protected-resource/mcp"

Evidence: https://mcp.netlify.com/mcp (opens in a new tab) · HTTP 401

API description

0/5 FAIL

A machine-readable API description lets coding agents build API calls without guessing from prose.

OpenAPI document (0/3, missing)
API catalog (.well-known) (0/2, missing)

Agent interoperability signals

2/5 PARTIAL

Emerging standards that help agents discover and use a site.

Content Signals (1/1)
Agent skills index (0/1, missing)
OAuth discovery (0/1, missing)
Link headers (0/1, missing)
Web Bot Auth directory (0/1, missing)
MCP server card (1/1)
Agent login instructions (auth.md) (0/1, missing)

Extra credit · 0/2

Extra credit can restore lost points. It cannot raise the score above 100.

llms-full.txt

0/1 FAIL

llms-full.txt combines the docs into one file for tools that load a whole documentation set.

Found: status-404

Evidence: https://docs.netlify.com/llms-full.txt (opens in a new tab) · HTTP 404

Docs AI assistant

0/1 FAIL

An assistant on the docs site answers readers’ questions. It helps people, not external agents.

Found: none detected

Archived reading test

Netlify had a reading test on 2026-09-22, under the method the series used until October 16, 2026. Three AI models read the docs and attempted five first-hour developer jobs. It scored 77.5% (C+). That score is not comparable with this one.

Read the archived reading test report

Show the score

Paste this into a readme:

[![AI Agent Readiness Score 90.7%](https://docsforagents.com/badge/netlify.svg)](https://docsforagents.com/reports/netlify-docs-ai-agent-readiness/)

Method note

This audit requested the public Netlify docs on October 16, 2026 and scored what the server returned. No AI model read the docs or scored anything. The audit did not run JavaScript, sign in, or create an account. Scoring version 100-point-v4.

Read the full methodology

By Sean Knight

Sean Knight is a co-founder of SaturnDocs, the AI agent-first docs product.

He runs Docs for Agents to study where public documentation gives agents clear answers, presents contradictions, or leaves them guessing.

https://www.linkedin.com/in/thatsean