Agent Readiness Score
github.com
42 — Developing. Agents can find parts of this site, but key capabilities are hard to reach.
HonestClaw measured how well github.com's site and APIs work for AI agents — across 9 dimensions and 45 automated checks.
Dimensions
Discoverability10.9/24
Content Accessibility15.1/24
Bot Access Control0/12
Protocol & Capability Discovery17.1/41
Authentication & Credentials3.5/19
Documentation Quality6.8/10
Structured Data I/O8/13
Observable State & Reliability2/15
Agent Safety & Trust7.7/11
Checks
Discoverability
Subdomain sweepsubdomain-sweepAn agent-relevant subdomain is live and serves its expected content kind (docs.github.com).Parseable
robots.txtrobots-txtrobots.txt at https://github.com/robots.txt is a valid robots file (no Sitemap: declared).Parseable
sitemap.xmlsitemap-xmlNo valid XML sitemap found at the standard locations.Not detected
Canonical domaincanonical-domainRoot and www converge on github.com, with a matching canonical tag.Cross-verified
API existenceapi-existenceA real API surface is declared at https://raw.githubusercontent.com/github/rest-api-description/main/descriptions/api.github.com/api.github.com.json: the spec lists servers and paths. (source: spec)Parseable
API catalogapi-catalogNo RFC 9727 API Catalog found at /.well-known/api-catalog.Not detected
API versioningapi-versioningThe API version lifecycle is documented at https://docs.github.com/en/rest/about-the-rest-api/api-versions, including deprecation/sunset. (source: docs)Cross-verified
Content Accessibility
llms.txtllms-txtA curated llms.txt index is published at https://github.com/llms.txt: 117 links across 12 sections.Cross-verified
Markdown twinmarkdown-twinA markdown twin is published at https://docs.github.com/en.md alongside the docs HTML surface (https://docs.github.com/en).Parseable
Freshness signalsfreshness-signalsA single freshness signal is present (ETag header).Parseable
Crawl-cost estimatecrawl-cost-estimateInformational — not scoredRobots.txt publishes Crawl-delay (1s) but no sitemap was found for URL inventory.Parseable
llms-full.txtllms-full-txtNo llms-full.txt file found (HTML pages at .txt paths do not qualify).Not detected
Raw content extractabilityraw-content-extractabilityReadable content is extractable without JavaScript on 2 probed surface(s) with a strong main-content ratio (63% on the homepage).Cross-verified
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 scoredA file exists at https://github.com/mcp.json, but it doesn't contain the fields that describe an MCP server.Detected
MCP supportmcp-supportFirst-party documentation at https://github.com/github/github-mcp-server explicitly states that the company operates MCP servers and explains both their capabilities and how clients connect or authenticate.Cross-verified
MCP Server Cardmcp-server-cardNo MCP Server Card found at the standard locations an agent would check.Not detected
SDK availabilitysdk-availabilitySDK libraries page at https://github.com/sdks: 27 GitHub repos, 0 registry links, 0 install commands (27 pointers).Cross-verified
A2A Agent Carda2a-agent-cardNo A2A Agent Card found at the standard well-known locations.Not detected
DNS-AIDdns-aidNo DNS-AID index found at _index._agents.github.com.Not detected
.well-known indexwell-known-indexNo non-owned /.well-known/ descriptors found. Blocked by robots.txt for a generic compliant agent (Disallow: /*return_to=*).Not detected
GraphQL surfacegraphql-surfaceA GraphQL transport surface is advertised at https://github.com/graphql (GraphiQL/Playground or Apollo markers).Useful
Auth discoveryauth-discoveryNo standardized authentication-discovery surface found.Not detected
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-specValid OpenAPI 3.0.3 spec at https://raw.githubusercontent.com/github/rest-api-description/main/descriptions/api.github.com/api.github.com.json: 1220 operations, 969 schemas, 100% response coverage, servers declared.Cross-verified
WebMCPwebmcpInformational — not scoredWebMCP browser probing is not yet available in this scanner release.Couldn't verify
Authentication & Credentials
Programmatic auth flowprogrammatic-auth-flowAn authentication page exists at https://docs.github.com/en/authentication, but it doesn't document a programmatic grant with a token endpoint.Parseable
Credential managementcredential-managementNo credential management documentation found at the standard docs locations an agent would check.Not detected
Auth documentationauth-documentationAn authentication documentation page exists at https://docs.github.com/en/authentication, but it doesn't name a specific method or show how a request is authenticated.Parseable
Sandbox environmentsandbox-environmentNo sandbox or test environment documentation found at the standard docs locations an agent would check.Not detected
Documentation Quality
Changelog presencechangelog-presenceA changelog is published at https://github.com/release-notes with multiple recent dated entries, indicating it is actively maintained.Cross-verified
API reference depthapi-reference-depthAn API reference page exists at https://docs.github.com/en/rest/authentication/authenticating-to-the-rest-api, but it doesn't show parameters with example requests and responses.Parseable
Structured Data I/O
Structured data I/Ostructured-data-ioThe spec at https://raw.githubusercontent.com/github/rest-api-description/main/descriptions/api.github.com/api.github.com.json declares typed, consistent response schemas (73% of operations) with a pagination pattern and a structured error envelope. (source: spec)Cross-verified
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.githubstatus.com/ (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: /).Not detected
Retry & idempotencyretry-and-idempotencyNo retry or idempotency documentation found at the standard docs locations an agent would check.Not detected
Webhook documentationwebhook-documentationA webhook documentation page exists at https://docs.github.com/en/webhooks, but it doesn't list specific event types with their payload shape.Parseable
Error documentationerror-documentationNo error documentation found at the standard docs locations an agent would check.Not detected
Agent Safety & Trust
security.txtsecurity-txtsecurity.txt at https://github.com/.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