← Back to the report
Agent Readiness

U.S. Department of Veterans Affairs

va.gov · Government & Public Services

54
Readiness /100
12
Checks passed
1
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 12 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?

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.

warnImages have explicit dimensionsStructured data & HTML

6/7 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).

warnInternal links on homepageStructured data & HTML

Only 1 internal link on the homepage.

Fix: Add at least 5-10 internal links pointing to your top product, pricing, docs, blog and about pages so an AI agent can navigate to them from the homepage.

warnSemantic landmark elementsStructured data & HTML

Missing landmark elements: nav.

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

1 of 12 pages are missing <title> and/or <h1>: /session-expired.

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: /503 (68w).

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 424 words of visible text — content is reachable without executing JavaScript.

passDOM size is reasonableStructured data & HTML

Homepage contains ~300 elements.

passHeading hierarchy is intactStructured data & HTML

21 headings, no level skips.

pass<html lang> attributeStructured data & HTML

Language declared as "en".

passImages have alt textStructured data & HTML

7 of 7 <img> tags have alt attributes.

passSingle H1 on homepageStructured data & HTML

Exactly one <h1> on the homepage.

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.

warnCumulative Layout ShiftPerformance

0.140 (field data from CrUX) — needs improvement.

Fix: A layout that shifts while loading makes an AI agent mis-click the element it targeted. Eliminate CLS by setting explicit width/height on images and embeds, avoiding inserted content above existing content, and reserving space for ad slots.

passAccessibility tree is agent-navigableAccessibility

All 11 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]` 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.

passTime to First BytePerformance

550ms (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.

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.

warnReferrer-Policy headerSecurity & trust

No Referrer-Policy header on the homepage.

Fix: Add `Referrer-Policy: strict-origin-when-cross-origin` so outbound links don't leak full URLs (including query strings) to third parties.

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.

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://va.gov → https://www.va.gov/ (2 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.

passTLS certificate is not near expirySecurity & trust

Valid for 181 more days (Jan 18 23:59:59 2027 GMT, issuer: Sectigo Public Server Authentication CA DV R36).

passNo tech-stack disclosure in headersSecurity & trust

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

passClick-jacking protectionSecurity & trust

X-Frame-Options: SAMEORIGIN.