← Back to the report
Agent Readiness

Notion

notion.so · SaaS & Productivity

74
Readiness /100
20
Checks passed
1
Checks failed
72
Checks run

Discoverability

Can agents find your site and its capabilities?

failWebMCP / agent-protocol tools discoveredAgent manifests

The page registers no tools via the WebMCP browser API (navigator.modelContext).

Fix: Expose your actions to AI agents with the WebMCP browser API: register tools via navigator.modelContext.registerTool. Optionally also publish a /.well-known/webmcp.json tool catalog as a discovery signpost.

failllms.txt does not follow recommendationsLighthouse Agentic

If your llms.txt file does not follow recommendations, large language models may not be able to understand how you want your website to be crawled or used for training. The [llms.txt](https://llmstxt.org/) file should be a Markdown file containing at least one H1 header.

warn/llms.txt opens with an H1 titleAgent manifests

Per llmstxt.org, /llms.txt should open with a single "# Project name" H1.

Fix: Make the first line of /llms.txt a "# Your site name" H1.

pass/llms.txt guide for AI agentsAgent manifests

Found https://notion.so/llms.txt.

pass/llms.txt lists key pages as markdown linksAgent manifests

Found at least one "[name](url)" markdown link.

pass/llms.txt has a summary blockquoteAgent manifests

Found a "> summary" blockquote.

passKey pages discoveredKey pages crawl

Crawled 12 of 12 discovered pages beyond the homepage.

infoLighthouse Agentic Browsing runLighthouse Agentic

Lighthouse Agentic Browsing audits ran.

infoWebsite platformplatform

Could not identify a known website platform (custom stack or unrecognised).

Understanding

Can agents understand your content?

warnMarkdown content negotiationOpen agent protocols

Homepage ignored Accept: text/markdown and returned HTML.

Fix: Serve a markdown version of high-value pages when the client asks for text/markdown. AI summarisers, chatbots and IDE agents prefer markdown — fewer tokens, no DOM noise.

passHomepage content is server-renderedCrawlability (Google)

Homepage server response contains 631 words of visible text — content is reachable without executing JavaScript.

passDOM size is reasonableStructured data & HTML

Homepage contains ~1301 elements.

passHeading hierarchy is intactStructured data & HTML

18 headings, no level skips.

pass<html lang> attributeStructured data & HTML

Language declared as "en-us".

passImages have alt textStructured data & HTML

52 of 52 <img> tags have alt attributes.

passImages have explicit dimensionsStructured data & HTML

52/52 images set width and height — no layout shift.

passInternal links on homepageStructured data & HTML

117 internal links found.

passSemantic landmark elementsStructured data & HTML

All four landmark elements present (main, header, footer, nav).

passSingle H1 on homepageStructured data & HTML

Exactly one <h1> on the homepage.

passKey pages have <title> and <h1>Key pages crawl

All 12 reachable key pages have both a <title> and <h1>.

passKey pages are server-renderedKey pages crawl

All 12 pages return ≥80 words of visible text without JavaScript.

Operability

Can agents actually operate the page?

fail`[role]`s do not have all required `[aria-*]` attributesAccessibility

Lighthouse flagged this audit — agents may be unable to perceive or operate the affected elements.

Fix: Add the ARIA attributes each role requires.

failAccessibility tree is not well-formedLighthouse Agentic

A well-formed [accessibility tree](http://goo.gle/lighthouse-agentic-a11y) helps AI agents to navigate and interact with the page.

failWebMCP tools registered with the browserWebMCP tools

The page registers no tools via the navigator.modelContext browser API, so an AI agent has no structured way to operate it.

Fix: Expose your site’s actions to AI agents with the WebMCP browser API: call navigator.modelContext.registerTool({ name, description, inputSchema, execute }) from your page so an agent can invoke them. Implement it directly, or with a library like the @mcp-b polyfill (https://mcp-b.ai). Spec: https://github.com/webmachinelearning/webmcp.

warnAccessibility tree is agent-navigableAccessibility

1 of 13 agent-critical accessibility audits failed (`[role]`s do not have all required `[aria-*]` attributes) — an agent may be unable to identify or operate the affected elements.

Fix: Fix the failing agent-accessibility audits listed below (accessible names on controls, valid ARIA roles/relationships, nothing interactive hidden from the tree).

warnOverall accessibility scoreAccessibility

Lighthouse accessibility score: 89/100. Agents read the page through its accessibility tree, so this is a proxy for how navigable your site is to an AI agent.

Fix: Resolve the failing accessibility audits below — each one removes an element or relationship an agent would otherwise be blind to.

warnTime to First BytePerformance

1.10s (field data from CrUX) — needs improvement.

Fix: Every request an AI agent makes pays this server latency, and agents make many requests per task. Reduce TTFB with edge caching, a CDN, and shipping less server-side work per request.

pass`[aria-*]` attributes match their rolesAccessibility

`[aria-*]` attributes match their roles passed.

pass`[aria-hidden="true"]` is not present on the document `<body>`Accessibility

`[aria-hidden="true"]` is not present on the document `<body>` passed.

pass`[aria-hidden="true"]` elements do not contain focusable descendentsAccessibility

`[aria-hidden="true"]` elements do not contain focusable descendents passed.

passElements with an ARIA `[role]` that require children to contain a specific `[role]` have all required children.Accessibility

Elements with an ARIA `[role]` that require children to contain a specific `[role]` have all required children. passed.

pass`[role]`s are contained by their required parent elementAccessibility

`[role]`s are contained by their required parent element passed.

pass`[role]` values are validAccessibility

`[role]` values are valid passed.

pass`[aria-*]` attributes are valid and not misspelledAccessibility

`[aria-*]` attributes are valid and not misspelled passed.

pass`[aria-*]` attributes have valid valuesAccessibility

`[aria-*]` attributes have valid values passed.

passButtons have an accessible nameAccessibility

Buttons have an accessible name passed.

passDocument has a `<title>` elementAccessibility

Document has a `<title>` element passed.

passARIA IDs are uniqueAccessibility

ARIA IDs are unique passed.

passLinks have a discernible nameAccessibility

Links have a discernible name passed.

passForm fields have labelsStructured data & HTML

1 of 1 visible interactive form fields have labels.

passCumulative Layout ShiftLighthouse Agentic

0.045

passCumulative Layout ShiftPerformance

0.040 (field data from CrUX) — good.

infoWebMCP tools registeredLighthouse Agentic

Lists the [WebMCP tools](http://goo.gle/webmcp-docs) registered at the time of analysis.

infoTool catalog signpost publishedWebMCP tools

No tool catalog was found at /.well-known/webmcp.json (or /.well-known/webmcp). The catalog is a community convention, not part of the WebMCP standard, so this does not affect WebMCP presence.

Fix: Consider also publishing a tool catalog at /.well-known/webmcp.json: a JSON document with a "spec" of "webmcp/0.1" and a "tools" array, where each tool declares a name and a clear description. It is a community convention (optional, not part of the WebMCP standard) that lets crawlers and agents discover your tools without executing JavaScript.

Trust & Security

Can agents safely transact?

warnOAuth authorization server metadataOpen agent protocols

/.well-known/oauth-authorization-server returned 404.

Fix: Publish /.well-known/oauth-authorization-server so AI agents discovering your OAuth setup can negotiate flows automatically. Required if your site offers an authenticated API.

warnOAuth protected-resource metadataOpen agent protocols

/.well-known/oauth-protected-resource returned 404.

Fix: Publish /.well-known/oauth-protected-resource so AI agents discovering your OAuth setup can negotiate flows automatically. Required if your site offers an authenticated API.

warnWeb Bot Auth signature headerOpen agent protocols

No Web Bot Auth signature headers — sites can't verify agent identity.

Fix: Web Bot Auth (IETF HTTP Message Signatures over Signature / Signature-Input) lets you cryptographically verify which agent is hitting you. Several CDNs offer turn-key support; otherwise skip until vendor support matures.

warnMIME-sniff protectionSecurity & trust

No `X-Content-Type-Options: nosniff` header.

Fix: Add `X-Content-Type-Options: nosniff` to prevent browsers (and some agents) from re-interpreting your responses as a different content type.

passCDN detectedSecurity & trust

cf-ray: a1eaabf96e93224e-AMS (Cloudflare); x-vercel-id: fra1::pdx1::rxj5h-1784641796104-d2b9a983 (Vercel); Server: cloudflare

passContent-Security-Policy headerSecurity & trust

CSP header present.

passHTTP Strict-Transport-Security headerSecurity & trust

max-age=31536000, includeSubDomains=true, preload=true.

passSite is served over HTTPSSecurity & trust

Homepage scheme is https:.

passhttp:// redirects to https://Security & trust

http://notion.so → https://www.notion.com/ (3 hops).

passHomepage shows no error outputSecurity & trust

No stack-trace markers in the first 5KB.

passNo mixed-content referencesSecurity & trust

Homepage HTML references no http:// resources.

passReferrer-Policy headerSecurity & trust

Referrer-Policy: strict-origin-when-cross-origin.

passTLS certificate is not near expirySecurity & trust

Valid for 54 more days (Sep 13 23:41:14 2026 GMT, issuer: WE1).

passNo tech-stack disclosure in headersSecurity & trust

Server / X-Powered-By headers don't leak product version.

passClick-jacking protectionSecurity & trust

CSP frame-ancestors directive present.