← Back to the report
Agent Readiness

DEV Community

dev.to · Developer, Cloud & Tech

66
Readiness /100
16
Checks passed
2
Checks failed
61
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 8 of 12 discovered pages beyond the homepage.

infoWebsite platformplatform

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

Understanding

Can agents understand your content?

failImages have alt textStructured data & HTML

Only 56 of 108 images have alt attributes (52%).

Fix: Add alt text to every <img>. Screen readers and AI vision models both rely on it to caption images.

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.

warnDOM size is reasonableStructured data & HTML

Homepage contains ~1886 elements — heavy.

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

warnHeading hierarchy is intactStructured data & HTML

Detected 1 heading level skip (e.g. h1 → h3).

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

100/108 images have explicit width+height.

Fix: Add width and height to every <img>. Without them the browser doesn't know the aspect ratio and reflows the page on load (CLS).

passHomepage content is server-renderedCrawlability (Google)

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

passCookie banner does not block crawlersStructured data & HTML

Detected 1 cookie-banner element but none look agent-hostile (small, dismissible, or offer a reject option).

pass<html lang> attributeStructured data & HTML

Language declared as "en".

passInternal links on homepageStructured data & HTML

353 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 8 reachable key pages have both a <title> and <h1>.

passKey pages are server-renderedKey pages crawl

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

Operability

Can agents actually operate the page?

fail`[aria-*]` attributes do not have valid valuesAccessibility

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

Fix: Fix invalid values on aria-* attributes.

failLinks do not have a discernible nameAccessibility

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

Fix: Give every link discernible text (avoid bare icons / "click here") so agents know where it goes.

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

2 of 11 agent-critical accessibility audits failed (Links do not have a discernible name, `[aria-*]` attributes do not have valid values) — 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`[role]`s have all required `[aria-*]` attributesAccessibility

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

passButtons have an accessible nameAccessibility

Buttons have an accessible name passed.

passDocument has a `<title>` elementAccessibility

Document has a `<title>` element passed.

pass`<frame>` or `<iframe>` elements have a titleAccessibility

`<frame>` or `<iframe>` elements have a title passed.

passForm fields have labelsStructured data & HTML

1 of 1 visible interactive form fields have labels.

passCumulative Layout ShiftPerformance

0.010 (field data from CrUX) — good.

passTime to First BytePerformance

600ms (field data from CrUX) — good.

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.

warnHTTP Strict-Transport-Security headerSecurity & trust

HSTS configured (max-age=31557600) but missing includeSubDomains.

Fix: Add `includeSubDomains` so subdomains inherit the policy.

passCDN detectedSecurity & trust

x-served-by: cache-den-kden1300099-DEN, cache-rtm-ehr (Fastly / Varnish)

passContent-Security-Policy headerSecurity & trust

CSP header present.

passSite is served over HTTPSSecurity & trust

Homepage scheme is https:.

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

http://dev.to → https://dev.to/ (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 144 more days (Dec 12 22:06:30 2026 GMT, issuer: GlobalSign Atlas R3 DV TLS CA 2025 Q4).

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

CSP frame-ancestors directive present.