Agent Readiness Score
circleci.com
50 — Developing. Agents can find parts of this site, but key capabilities are hard to reach.
HonestClaw measured how well circleci.com's site and APIs work for AI agents — across 9 dimensions and 45 automated checks.
Dimensions
Discoverability12.9/24
Content Accessibility17.1/24
Bot Access Control5.5/12
Protocol & Capability Discovery20/41
Authentication & Credentials3.8/19
Documentation Quality8.5/10
Structured Data I/O8/13
Observable State & Reliability1.8/15
Agent Safety & Trust7.6/11
Checks
Discoverability
Subdomain sweepsubdomain-sweepAn agent-relevant subdomain is live and serves its expected content kind (docs.circleci.com).Parseable
robots.txtrobots-txtrobots.txt at https://circleci.com/robots.txt declares a sitemap. Declared sitemap https://circleci.com/sitemap.xml resolves as valid XML.Cross-verified
API catalogapi-catalogAPI Catalog found at https://circleci.com/.well-known/api-catalog (application/linkset+json).Detected
Canonical domaincanonical-domainRoot and www converge on circleci.com, with a matching canonical tag.Cross-verified
sitemap.xmlsitemap-xmlhttps://circleci.com/sitemap.xml is a dated sitemap whose URLs include docs/pricing/api surfaces.Cross-verified
API existenceapi-existenceA real API surface is declared at https://circleci.com/openapi.json: the spec lists servers and paths. (source: spec)Parseable
API versioningapi-versioningThe API version is declared in the spec (info.version) at https://circleci.com/openapi.json. (source: spec)Parseable
Content Accessibility
llms.txtllms-txtA curated llms.txt index is published at https://circleci.com/llms.txt: 37 links across 8 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-signalsMultiple freshness signals present (Last-Modified header, ETag header, sitemap lastmod) with sitemap entries updated within 90 days.Cross-verified
Crawl-cost estimatecrawl-cost-estimateInformational — not scoredA manageable sitemap (212 page URLs) helps agents estimate crawl cost.Useful
ai.txtai-txtNo ai.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 (79% on the homepage).Cross-verified
Markdown twinmarkdown-twinA markdown twin is published at https://circleci.com/docs/index.md alongside the docs HTML surface (https://circleci.com/docs).Parseable
Bot Access Control
AI bot rulesai-bot-rulesrobots.txt declares explicit rules for 2 AI bot(s): chatgpt-user, perplexity-user.Useful
Content signalscontent-signalsrobots.txt declares 3 recognized Content Signal(s) with a valid value: ai-train, search, ai-input.Cross-verified
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://circleci.com/.well-known/mcp, but it doesn't contain the fields that describe an MCP server.Detected
MCP supportmcp-supportFirst-party documentation at https://circleci.com/product/mcp/ identifies the MCP endpoint https://mcp.circleci.com/v1/mcp and explains both its capabilities and how clients connect or authenticate.Cross-verified
MCP Server Cardmcp-server-cardA fully described MCP Server Card is published at https://circleci.com/.well-known/mcp/server-card.json with identity, version, and protocol-versioned remote endpoints.Cross-verified
A2A Agent Carda2a-agent-cardNo A2A Agent Card found at the standard well-known locations.Not detected
SDK availabilitysdk-availabilityGetting-started page at https://circleci.com/docs/guides/getting-started/getting-started/: 1 GitHub repo, 0 registry links, 0 install commands (1 pointer).Useful
DNS-AIDdns-aidNo DNS-AID index found at _index._agents.circleci.com.Not detected
.well-known indexwell-known-indexNo non-owned /.well-known/ descriptors found.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
Auth discoveryauth-discoveryA drivable auth-discovery descriptor is published.Useful
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. Blocked by robots.txt for a generic compliant agent (Disallow: /api/).Not detected
OpenAPI specificationopenapi-specValid OpenAPI 3.0.3 spec at https://circleci.com/fullopenapi.json: 132 operations, 1 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-flowProgrammatic authentication is mentioned at https://circleci.com/changelog/oauth-2-0-api-access-with-dynamic-client-registration/, but not on a page dedicated to documenting it.Detected
Credential managementcredential-managementCredential management is documented at https://circleci.com/docs/guides/security/security/, covering how to rotate or revoke credentials. To reach the top level, it would need rotation, revocation, and scoping/expiry all documented.Useful
Auth documentationauth-documentationAuthentication is mentioned at https://circleci.com/changelog/oauth-2-0-api-access-with-dynamic-client-registration/, but not on a page dedicated to documenting it.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-depthThe API reference at https://circleci.com/docs/reference/configuration-reference/ 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://circleci.com/changelog/ with multiple recent dated entries, indicating it is actively maintained.Cross-verified
Structured Data I/O
Structured data I/Ostructured-data-ioThe spec at https://circleci.com/docs/api/v2/openapi.json declares typed, consistent response schemas (100% 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). 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
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
Status & health endpointsstatus-and-healthNo health or status endpoint found. 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-documentationNo error documentation found at the standard docs locations an agent would check. Blocked by robots.txt for a generic compliant agent (Disallow: /api/).Not detected
Webhook documentationwebhook-documentationA webhook documentation page exists at https://circleci.com/docs/guides/integration/outbound-webhooks/, but it doesn't list specific event types with their payload shape.Parseable
Agent Safety & Trust
security.txtsecurity-txtsecurity.txt at https://circleci.com/.well-known/security.txt publishes a Contact address.Useful
Org identity signalsorg-identityHomepage exposes two org-identity signal types (legal_name, social).Parseable
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