Agent Readiness Score
readme.com
20 — Limited. Agents will struggle to discover or use this site without human help.
HonestClaw measured how well readme.com's site and APIs work for AI agents — across 9 dimensions and 45 automated checks.
Dimensions
Discoverability8.3/24
Content Accessibility12.3/24
Bot Access Control0/12
Protocol & Capability Discovery6.8/41
Authentication & Credentials1.8/19
Documentation Quality0.5/10
Structured Data I/O0/13
Observable State & Reliability0.7/15
Agent Safety & Trust4.3/11
Checks
Discoverability
Subdomain sweepsubdomain-sweepAn agent-relevant subdomain is live and serves its expected content kind (docs.readme.com).Parseable
robots.txtrobots-txtrobots.txt at https://readme.com/robots.txt declares a sitemap. Declared sitemap https://readme.com/sitemap.xml resolves as valid XML.Cross-verified
sitemap.xmlsitemap-xmlhttps://readme.com/sitemap.xml is a dated sitemap whose URLs include docs/pricing/api surfaces.Cross-verified
Canonical domaincanonical-domainRoot and www converge on a single canonical host (readme.com).Parseable
API existenceapi-existenceNo API endpoint found at common paths (only HTML pages or 404s).Not detected
API catalogapi-catalogNo RFC 9727 API Catalog found at /.well-known/api-catalog.Not detected
API versioningapi-versioningVersioning is mentioned at https://readme.com/blog/api-versioning-best-practices, but not on a page dedicated to documenting it. (source: docs)Detected
Content Accessibility
llms.txtllms-txtA curated llms.txt index is published on a non-top subdomain at https://docs.readme.com/llms.txt: 29 links across 2 sections. Its credit is capped at useful because it is not published on the main domain.Useful
Markdown twinmarkdown-twinA markdown twin is published at https://docs.readme.com/main/docs/index.md alongside the docs HTML surface (https://docs.readme.com/docs).Parseable
Freshness signalsfreshness-signalsFreshness signals present: ETag header, sitemap lastmod.Useful
Crawl-cost estimatecrawl-cost-estimateInformational — not scoredA manageable sitemap (150 page URLs) helps agents estimate crawl cost.Useful
llms-full.txtllms-full-txtNo llms-full.txt file found (HTML pages at .txt paths do not qualify).Not detected
Raw content extractabilityraw-content-extractabilitySubstantial visible text (13,659 chars) is readable without JavaScript on at least one probed page.Useful
ai.txtai-txtNo ai.txt file found (HTML pages at .txt paths do not qualify).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
.well-known indexwell-known-indexNo non-owned /.well-known/ descriptors found.Not detected
MCP Server Cardmcp-server-cardNo MCP Server Card found at the standard locations an agent would check.Not detected
A2A Agent Carda2a-agent-cardNo A2A Agent Card found at the standard well-known locations.Not detected
GraphQL surfacegraphql-surfaceNo GraphQL transport surface found at conventional paths (GET-only; no introspection issued).Not detected
DNS-AIDdns-aidNo DNS-AID index found at _index._agents.readme.com.Not detected
MCP supportmcp-supportA first-party MCP support page exists at https://docs.readme.com/main/changelog/mcp-password-authentication-expanded-ai-agent-capabilities, but it does not identify a concrete HTTPS MCP endpoint or fully establish a company-operated service.Parseable
Auth discoveryauth-discoveryNo standardized authentication-discovery surface found.Not detected
SDK availabilitysdk-availabilitySDK libraries page at https://docs.readme.com/main/docs/sdks: 3 GitHub repos, 5 registry links, 0 install commands (8 pointers).Cross-verified
Rate limit documentationrate-limit-docsNo rate limit documentation found at the standard docs locations an agent would check.Not detected
Link headerslink-headersNo RFC 8288 Link headers found on any probed response.Not detected
OpenAPI specificationopenapi-specNo OpenAPI/Swagger specification found.Not detected
WebMCPwebmcpInformational — not scoredWebMCP browser probing is not yet available in this scanner release.Couldn't verify
Authentication & Credentials
Programmatic auth flowprogrammatic-auth-flowNo programmatic authentication documentation found at the standard docs locations an agent would check.Not detected
Auth documentationauth-documentationAn authentication documentation page exists at https://docs.readme.com/main/changelog/mcp-password-authentication-expanded-ai-agent-capabilities, but it doesn't name a specific method or show how a request is authenticated.Parseable
Credential managementcredential-managementNo credential management documentation found at the standard docs locations an agent would check.Not detected
Sandbox environmentsandbox-environmentNo sandbox or test environment documentation found at the standard docs locations an agent would check.Not detected
Documentation Quality
API reference depthapi-reference-depthAPI reference documentation lacks depth or was not found.Not detected
Changelog presencechangelog-presenceA changelog is mentioned at https://docs.readme.com/main/docs/about-readme, but not on a page dedicated to publishing release history.Detected
Structured Data I/O
Structured data I/Ostructured-data-ioNo published structured-data contract found (no typed spec response schemas).Not detected
Machine-readable pricingmachine-readable-pricingNo machine-readable pricing endpoint found (HTML pricing pages do not qualify).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-healthStatus page found at https://www.readmestatus.com/ (HTTP 200).Detected
Webhook documentationwebhook-documentationNo webhook or event documentation found at the standard docs locations an agent would check.Not detected
Retry & idempotencyretry-and-idempotencyNo retry or idempotency documentation found at the standard docs locations an agent would check.Not detected
Error documentationerror-documentationError handling is mentioned at https://readme.com/resources/combining-api-metrics-with-api-errors, but not on a page dedicated to documenting it.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.Couldn't verify
Agent Safety & Trust
Org identity signalsorg-identityHomepage exposes two org-identity signal types (support_email, social).Parseable
Metadata consistencymetadata-consistencyHomepage metadata (canonical, Open Graph, schema) is present and consistent.Cross-verified
security.txtsecurity-txtNo security.txt found at /.well-known/security.txt or /security.txt.Not detected
Legal policy pageslegal-pagesAt least one legal policy page is discoverable.Detected