← Back to the report
Agent Readiness

GitHub

github.com · Developer, Cloud & Tech

64
Readiness /100
20
Checks passed
1
Checks failed
71
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.

pass/llms.txt guide for AI agentsAgent manifests

Found https://github.com/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.

pass/llms.txt opens with an H1 titleAgent manifests

First line is a top-level "# Title" heading.

passKey pages discoveredKey pages crawl

Crawled 12 of 12 discovered pages beyond the homepage.

passllms.txt follows 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.

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 returned 406 for Accept: text/markdown.

warnDOM size is reasonableStructured data & HTML

Homepage contains ~1967 elements — heavy.

Fix: Aim for under 1500 elements on the homepage. Heavier DOMs slow first paint and overflow some AI crawlers' parse buffers.

warnImages have explicit dimensionsStructured data & HTML

Only 0/24 images have width+height — large CLS risk.

Fix: Set width and height on every <img> so the browser reserves space before the image loads. A layout that shifts while loading makes an AI agent mis-click the element it targeted.

warnSingle H1 on homepageStructured data & HTML

Found 4 <h1> tags. Most AI summarisers expect exactly one.

Fix: Demote the secondary H1s to H2 — keep H1 reserved for the page title.

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

1 of 12 pages are missing <title> and/or <h1>: /contact.

Fix: Make sure every page sets a unique <title> and exactly one <h1>. The title is how an AI agent confirms it landed on the right page after navigating.

warnKey pages are server-renderedKey pages crawl

1 of 12 pages return <80 words of visible text — agents without JavaScript see an empty page: /contact (15w).

Fix: Pre-render or server-render these pages so AI crawlers (which usually don't execute JS) can read them. Frameworks: Next.js Server Components, Nuxt SSR, Astro, or build-time prerendering.

passHomepage content is server-renderedCrawlability (Google)

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

passHeading hierarchy is intactStructured data & HTML

30 headings, no level skips.

pass<html lang> attributeStructured data & HTML

Language declared as "en".

passImages have alt textStructured data & HTML

24 of 24 <img> tags have alt attributes.

passInternal links on homepageStructured data & HTML

103 internal links found.

passSemantic landmark elementsStructured data & HTML

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

Operability

Can agents actually operate 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.

warnForm fields have labelsStructured data & HTML

6 of 7 visible interactive form fields have labels.

Fix: Associate every input with a label — either wrap it in <label>, link via for/id, or set aria-label / aria-labelledby.

warnForms mark required fieldsStructured data & HTML

0/2 data-collecting forms mark required fields.

Fix: Add the `required` attribute (or `aria-required="true"`) to mandatory inputs. Form-filling agents skip optional fields by default — without markers they over-fill.

warnForm fields publish validation hintsStructured data & HTML

No HTML5 validation hints (pattern / minlength / maxlength / min / max) on any data-collecting form input.

Fix: Publish input constraints via HTML attributes so agents and browsers can validate client-side.

warnTime to First BytePerformance

1.21s (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.

passAccessibility tree is agent-navigableAccessibility

All 12 agent-critical accessibility audits passed — an agent can perceive and operate the page through its accessibility tree.

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.

pass`[role]`s have all required `[aria-*]` attributesAccessibility

`[role]`s have all required `[aria-*]` attributes 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.

passLinks have a discernible nameAccessibility

Links have a discernible name passed.

passOverall accessibility scoreAccessibility

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

passForms use autocomplete attributesStructured data & HTML

All 2 data-collecting forms set autocomplete on at least one field.

passForm errors are accessibleStructured data & HTML

All 2 data-collecting forms reference errors via aria-describedby / aria-invalid.

passAccessibility tree is well-formedLighthouse Agentic

All audits passed

passCumulative Layout ShiftLighthouse Agentic

0

passCumulative Layout ShiftPerformance

0.080 (field data from CrUX) — good.

infoWebMCP form coverageLighthouse Agentic

5 forms missing annotations

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.

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://github.com → https://github.com/ (1 hop).

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: origin-when-cross-origin, strict-origin-when-cross-origin.

passTLS certificate is not near expirySecurity & trust

Valid for 71 more days (Sep 30 23:59:59 2026 GMT, issuer: Sectigo Public Server Authentication CA DV E36).

passNo tech-stack disclosure in headersSecurity & trust

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

passMIME-sniff protectionSecurity & trust

X-Content-Type-Options: nosniff.

passClick-jacking protectionSecurity & trust

X-Frame-Options: deny.