Agent Readiness Score

linear.app

38 — Limited. Agents will struggle to discover or use this site without human help.

45 of 45 checks conclusive · Confidence High · Evidence coverage 100%

HonestClaw measured how well linear.app's site and APIs work for AI agents — across 9 dimensions and 45 automated checks.

Open interactive report →

Dimensions

Discoverability11.9/24

Content Accessibility14.1/24

Bot Access Control0/12

Protocol & Capability Discovery9.7/41

Authentication & Credentials8.5/19

Documentation Quality8.5/10

Structured Data I/O0/13

Observable State & Reliability3.7/15

Agent Safety & Trust7.7/11

Checks

Discoverability

Subdomain sweepsubdomain-sweepBoth an API-family and a docs-family subdomain are live (api.linear.app, docs.linear.app).Useful

robots.txtrobots-txtrobots.txt at https://linear.app/robots.txt declares a sitemap. Declared sitemap https://linear.app/sitemap.xml resolves as valid XML.Cross-verified

sitemap.xmlsitemap-xmlhttps://linear.app/sitemap.xml is a dated sitemap whose URLs include docs/pricing/api surfaces.Cross-verified

Canonical domaincanonical-domainRoot and www converge on linear.app, with a matching canonical tag.Cross-verified

API existenceapi-existenceA real API surface at https://api.linear.app/graphql answered HTTP 400 with non-HTML JSON. (source: live)Parseable

API catalogapi-catalogNo RFC 9727 API Catalog found at /.well-known/api-catalog. Blocked by robots.txt for a generic compliant agent (Disallow: /api/).Not detected

API versioningapi-versioningNo versioning signal found (no spec info.version, version header, /vN API surface, or versioning docs). Blocked by robots.txt for a generic compliant agent (Disallow: /api/).Not detected

Content Accessibility

llms.txtllms-txtA curated llms.txt index is published at https://linear.app/llms.txt: 146 links across 2 sections.Cross-verified

llms-full.txtllms-full-txtNo llms-full.txt file found (HTML pages at .txt paths do not qualify).Not detected

Freshness signalsfreshness-signalsA single freshness signal is present (sitemap lastmod).Parseable

Crawl-cost estimatecrawl-cost-estimateInformational — not scoredA manageable sitemap (999 page URLs) helps agents estimate crawl cost.Useful

Raw content extractabilityraw-content-extractabilityReadable content is extractable without JavaScript on 2 probed surface(s) with a strong main-content ratio (94% on the homepage).Cross-verified

ai.txtai-txtNo ai.txt file found (HTML pages at .txt paths do not qualify).Not detected

Markdown twinmarkdown-twinNo markdown twin found alongside probed docs HTML surfaces.Not detected

Bot Access Control

AI bot rulesai-bot-rulesrobots.txt is readable but declares no AI-bot-specific rules.Not detected

Content signalscontent-signalsrobots.txt is readable but declares no Content-Signal line.Not detected

RSL licensingrslrobots.txt is readable but declares no RSL License directive.Not detected

TDM reservationtdmrepNo TDMRep policy found at /.well-known/tdmrep.json.Not detected

Protocol & Capability Discovery

MCP descriptormcp-descriptorInformational — not scoredNo MCP descriptor found at the standard locations an agent would check.Not detected

MCP supportmcp-supportFirst-party documentation at https://linear.app/changelog/2026-02-05-linear-mcp-for-product-management identifies the MCP endpoint https://mcp.linear.app/sse and explains both its capabilities and how clients connect or authenticate.Cross-verified

.well-known indexwell-known-indexNo non-owned /.well-known/ descriptors found.Not detected

A2A Agent Carda2a-agent-cardNo A2A Agent Card found at the standard well-known locations.Not detected

MCP Server Cardmcp-server-cardNo MCP Server Card found at the standard locations an agent would check.Not detected

DNS-AIDdns-aidNo DNS-AID index found at _index._agents.linear.app.Not detected

GraphQL surfacegraphql-surfaceNo GraphQL transport surface found at conventional paths (GET-only; no introspection issued). Blocked by robots.txt for a generic compliant agent (Disallow: /api/).Not detected

SDK availabilitysdk-availabilityGetting-started page at https://linear.app/changelog/2021-03-05-linear-sdk: 1 GitHub repo, 0 registry links, 0 install commands (1 pointer).Useful

Auth discoveryauth-discoveryNo standardized authentication-discovery surface found. Blocked by robots.txt for a generic compliant agent (Disallow: /).Not detected

Link headerslink-headersLink header(s) present with recognized rel values.Parseable

OpenAPI specificationopenapi-specNo OpenAPI/Swagger specification found. Blocked by robots.txt for a generic compliant agent (Disallow: /api/).Not detected

Rate limit documentationrate-limit-docsRate limiting is mentioned at https://linear.app/developers/rate-limiting.md, but not on a page dedicated to documenting it.Detected

WebMCPwebmcpInformational — not scoredWebMCP browser probing is not yet available in this scanner release.Couldn't verify

Authentication & Credentials

Credential managementcredential-managementNo credential management documentation found at the standard docs locations an agent would check.Not detected

Programmatic auth flowprogrammatic-auth-flowA programmatic auth flow is documented at https://linear.app/developers/file-storage-authentication, naming a non-interactive grant and a token endpoint. To reach the top level, it would need scopes and token expiry/refresh documented.Useful

Sandbox environmentsandbox-environmentNo sandbox or test environment documentation found at the standard docs locations an agent would check.Not detected

Auth documentationauth-documentationAuthentication is fully documented at https://linear.app/developers/file-storage-authentication, naming complete method(s) and how they are sent, corroborated across surfaces or covering multiple methods.Cross-verified

Documentation Quality

API reference depthapi-reference-depthThe API reference at https://linear.app/developers/graphql documents parameters with example requests and responses. To reach the top level, it would need request and response bodies, authentication, pagination, and error codes.Useful

Changelog presencechangelog-presenceA changelog is published at https://linear.app/changelog with multiple recent dated entries, indicating it is actively maintained.Cross-verified

Structured Data I/O

Structured data I/Ostructured-data-ioNo published structured-data contract found (no typed spec response schemas). Blocked by robots.txt for a generic compliant agent (Disallow: /api/).Not detected

Machine-readable pricingmachine-readable-pricingNo machine-readable pricing endpoint found (HTML pricing pages do not qualify). Blocked by robots.txt for a generic compliant agent (Disallow: /api/).Not detected

Data export APIdata-export-apiNo data export or bulk API documentation found at the standard docs locations an agent would check.Not detected

Observable State & Reliability

Status & health endpointsstatus-and-healthHealth/status endpoint found at https://linearstatus.com/api/v2/status.json (HTTP 200).Detected

Machine payments (x402/MPP)x402-or-mpp-supportInformational — not scoredNo machine-payment signal observed (no HTTP 402, no payment-required response header, and no /.well-known/x402.json manifest). Payment support cannot be ruled out from an unauthenticated probe. Blocked by robots.txt for a generic compliant agent (Disallow: /api/).Not detected

Retry & idempotencyretry-and-idempotencyNo retry or idempotency documentation found at the standard docs locations an agent would check.Not detected

Error documentationerror-documentationAn error documentation page exists at https://linear.app/developers/sdk-errors, but it doesn't enumerate specific error codes or a documented error response shape.Parseable

Webhook documentationwebhook-documentationA webhook documentation page exists at https://linear.app/developers/sdk-webhooks, but it doesn't list specific event types with their payload shape.Parseable

Agent Safety & Trust

security.txtsecurity-txtsecurity.txt at https://linear.app/.well-known/security.txt includes Contact, a future Expires date, and Encryption or Policy.Cross-verified

Org identity signalsorg-identityHomepage exposes one org-identity signal (social).Detected

Metadata consistencymetadata-consistencyHomepage metadata (canonical, Open Graph, schema) is present and consistent.Cross-verified

Legal policy pageslegal-pagesBoth privacy and terms policies are discoverable with substantive content.Useful