← Back to the report
Agent Readiness

Hugging Face

huggingface.co · Developer, Cloud & Tech

73
Readiness /100
17
Checks passed
2
Checks failed
64
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.

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?

fail<html lang> attributeStructured data & HTML

No lang attribute on <html>.

Fix: Add lang to the <html> root (e.g. lang="en") so screen readers and AI translation engines pick the right voice / model.

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.

warnHeading hierarchy is intactStructured data & HTML

Detected 5 heading level skips (e.g. h2 → h4).

Fix: Tighten the heading order so each level only steps down by one. Skipped levels confuse both screen-readers and AI structural extractors.

warnImages have explicit dimensionsStructured data & HTML

Only 0/28 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.

passHomepage content is server-renderedCrawlability (Google)

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

passDOM size is reasonableStructured data & HTML

Homepage contains ~985 elements.

passImages have alt textStructured data & HTML

28 of 28 <img> tags have alt attributes.

passInternal links on homepageStructured data & HTML

93 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?

failButtons do not have an accessible nameAccessibility

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

Fix: Give every <button> discernible text or an aria-label so agents can identify it.

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 8 agent-critical accessibility audits failed (Buttons do not have an accessible name) — 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: 78/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.

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`[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.

passDocument has a `<title>` elementAccessibility

Document has a `<title>` element 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.032

passCumulative Layout ShiftPerformance

0.000 (field data from CrUX) — good.

passTime to First BytePerformance

554ms (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?

failHTTP Strict-Transport-Security headerSecurity & trust

No Strict-Transport-Security header on the homepage.

Fix: Add `Strict-Transport-Security: max-age=15768000; includeSubDomains` so browsers and agents refuse to downgrade to http for at least six months.

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.

warnContent-Security-Policy headerSecurity & trust

No Content-Security-Policy header on the homepage.

Fix: Add a Content-Security-Policy. Even a strict default-src directive cuts XSS blast radius dramatically. Start in report-only mode to find violations.

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.

passOAuth authorization server metadataOpen agent protocols

/.well-known/oauth-authorization-server returns parseable JSON.

passOAuth protected-resource metadataOpen agent protocols

/.well-known/oauth-protected-resource returns parseable JSON.

passCDN detectedSecurity & trust

x-amz-cf-id: e6gWyyAc58iuo7MDnB25zWi9W8JTFxEm7yr56dxV (AWS CloudFront)

passSite is served over HTTPSSecurity & trust

Homepage scheme is https:.

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

http://huggingface.co → https://huggingface.co/ (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: strict-origin-when-cross-origin.

passTLS certificate is not near expirySecurity & trust

Valid for 68 more days (Sep 27 23:59:59 2026 GMT, issuer: Amazon RSA 2048 M04).

passNo tech-stack disclosure in headersSecurity & trust

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

passClick-jacking protectionSecurity & trust

X-Frame-Options: DENY.