← Back to the report
Agent Readiness

Linear

linear.app · SaaS & Productivity

70
Readiness /100
19
Checks passed
1
Checks failed
66
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://linear.app/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.

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.

warnDOM size is reasonableStructured data & HTML

Homepage contains ~4268 elements — well above the 1500-element budget.

Fix: Trim the homepage DOM: an AI agent has to read all of it before acting, and this page is several times over budget. Long product carousels, hidden modal markup and large tracker scripts are common culprits.

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.

warnKey pages are server-renderedKey pages crawl

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

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

pass<html lang> attributeStructured data & HTML

Language declared as "en".

passImages have alt textStructured data & HTML

32 of 32 <img> tags have alt attributes.

passImages have explicit dimensionsStructured data & HTML

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

passInternal links on homepageStructured data & HTML

71 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>.

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.

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 13 agent-critical accessibility audits failed (Buttons do not have an accessible name, Links do not have a discernible 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: 88/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.

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.

passARIA toggle fields have accessible namesAccessibility

ARIA toggle fields have accessible names 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.

passForm fields have labelsStructured data & HTML

3 of 3 visible interactive form fields have labels.

passCumulative Layout ShiftPerformance

0.000 (field data from CrUX) — good.

passTime to First BytePerformance

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

passCDN detectedSecurity & trust

cf-ray: a1eaeb1b1fec7e8f-AMS (Cloudflare); Server: cloudflare

passContent-Security-Policy headerSecurity & trust

CSP header present.

passHTTP Strict-Transport-Security headerSecurity & trust

max-age=63072000, includeSubDomains=true, preload=false.

passSite is served over HTTPSSecurity & trust

Homepage scheme is https:.

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

http://linear.app → https://linear.app/ (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: same-origin.

passTLS certificate is not near expirySecurity & trust

Valid for 87 more days (Oct 16 14:49:31 2026 GMT, issuer: YE2).

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.