How Your AI Readiness Score Is Calculated
2026-05-17
Your score is a weighted sum across five signal groups that AI agents rely on when they visit a site. Each group can contribute a fixed share of the total 100 points; within a group, individual checks are pass/fail or partial.
The five signal groups
- Discoverability — Can an agent find the edges of your site? We look at `robots.txt` for an `Allow` rule covering common AI crawlers, a reachable `sitemap.xml`, and a `<link rel="sitemap">` header on your homepage.
- Content negotiation — Does your server return clean Markdown when a client sends `Accept: text/markdown`? Agents that receive raw HTML must spend tokens stripping boilerplate; sites that skip this step score lower here.
- LLM hints — Is an `llms.txt` file present and parseable at the root? We check for the file, validate its structure, and confirm it points to at least one canonical resource.
- Agent metadata — Do standard `/.well-known/` paths exist? We probe for `mcp.json`, `agent.json`, and `ai-plugin.json`. None are required today; each one present raises your score.
- Security posture — HTTPS is a baseline requirement, not a bonus. We additionally check for `HSTS` headers and a `Content-Security-Policy`, both of which signal to agents that the host is production-grade.
What the number does not tell you
A high score means your public surface is legible to automated visitors—it does not mean your content is accurate, your product is good, or that any specific AI platform will cite you. Scores are heuristic snapshots, not audits.
> Think of it the way you think of a Lighthouse performance score: useful signal, not a contract.
How to read the recommendations
Each failing check comes with a specific fix, not a general suggestion. If `llms.txt` is missing, the recommendation includes a minimal valid template you can drop into your repo root and ship in a single commit. Start with the Discoverability group—those fixes have the widest impact and usually require no code changes, only a file or two.
We re-scan on demand. Once you have shipped a fix, paste your URL again and the score updates immediately.