Agent Readiness Score
clickhouse.com
31 — Limited. Agents will struggle to discover or use this site without human help.
HonestClaw measured how well clickhouse.com's site and APIs work for AI agents — across 9 dimensions and 45 automated checks.
Dimensions
Discoverability12.9/24
Content Accessibility13/24
Bot Access Control0/12
Protocol & Capability Discovery11.3/41
Authentication & Credentials0/19
Documentation Quality1/10
Structured Data I/O8/13
Observable State & Reliability0.7/15
Agent Safety & Trust6.3/11
Checks
Discoverability
Subdomain sweepsubdomain-sweepAn agent-relevant subdomain is live and serves its expected content kind (docs.clickhouse.com).Parseable
robots.txtrobots-txtrobots.txt at https://clickhouse.com/robots.txt declares a sitemap. Declared sitemap https://clickhouse.com/sitemap.xml resolves as valid XML.Cross-verified
API catalogapi-catalogAPI Catalog found at https://clickhouse.com/.well-known/api-catalog (application/linkset+json).Detected
sitemap.xmlsitemap-xmlhttps://clickhouse.com/sitemap.xml is a dated sitemap whose URLs include docs/pricing/api surfaces.Cross-verified
Canonical domaincanonical-domainRoot and www converge on clickhouse.com, with a matching canonical tag.Cross-verified
API existenceapi-existenceA real API surface is declared at https://raw.githubusercontent.com/hyperdxio/hyperdx/refs/heads/main/packages/api/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://raw.githubusercontent.com/hyperdxio/hyperdx/refs/heads/main/packages/api/openapi.json. (source: spec)Parseable
Content Accessibility
llms.txtllms-txtA curated llms.txt index is published at https://clickhouse.com/llms.txt: 454 links across 6 sections.Cross-verified
Freshness signalsfreshness-signalsFreshness signals present: ETag header, sitemap lastmod.Useful
Crawl-cost estimatecrawl-cost-estimateInformational — not scoredSitemap declares 2014 page URLs — moderate crawl cost; agents should budget accordingly.Parseable
Raw content extractabilityraw-content-extractabilityModerate-to-strong main content (70% of visible text) is extractable from raw HTML on the homepage.Useful
llms-full.txtllms-full-txtNo llms-full.txt file found (HTML pages at .txt paths do not qualify).Not detected
ai.txtai-txtNo ai.txt file found (HTML pages at .txt paths do not qualify).Not detected
Markdown twinmarkdown-twinA twin exists at https://clickhouse.com/docs/index.md but the body is not clearly markdown-structured.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 fully described MCP server is published at https://docs.clickhouse.com/mcp, declaring 3 tools, each with a description and input format. This is the current standard for agent-native MCP.Cross-verified
MCP supportmcp-supportA first-party MCP support page exists at https://clickhouse.com/blog/agentic-analytics-ask-ai-agent-and-remote-mcp-server-beta-launch, but it does not identify a concrete HTTPS MCP endpoint or fully establish a company-operated service.Parseable
MCP Server Cardmcp-server-cardNo MCP Server Card found at the standard locations an agent would check.Not detected
A2A Agent Carda2a-agent-cardAn A2A Agent Card is described at https://docs.clickhouse.com/.well-known/agent-card.json, but it is missing required fields (name, description, version, supportedInterfaces, or skills).Parseable
DNS-AIDdns-aidNo DNS-AID index found at _index._agents.clickhouse.com.Not detected
SDK availabilitysdk-availabilityGetting-started page at https://clickhouse.com/videos/how-building-llm-prompt-sdk-led-us-to-typesafe-clickhouse-queries: 1 GitHub repo, 0 registry links, 0 install commands (1 pointer).Useful
.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).Not detected
Auth discoveryauth-discoveryNo standardized authentication-discovery surface found.Not detected
Link headerslink-headersNo RFC 8288 Link headers found on any probed response.Not detected
OpenAPI specificationopenapi-specValid OpenAPI 3.0.0 spec at https://raw.githubusercontent.com/hyperdxio/hyperdx/refs/heads/main/packages/api/openapi.json: 38 operations, 124 schemas, 100% response coverage, servers declared.Cross-verified
Rate limit documentationrate-limit-docsNo rate limit documentation found at the standard docs locations an agent would check.Not 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-flowNo programmatic authentication documentation found at the standard docs locations an agent would check.Not detected
Auth documentationauth-documentationNo authentication 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 content is mentioned at https://clickhouse.com/resources/engineering/query-rest-api-with-sql, but not on a dedicated reference page.Detected
Changelog presencechangelog-presenceA changelog is mentioned at https://clickhouse.com/blog/pg_clickhouse-whats-new-july-2026, but not on a page dedicated to publishing release history.Detected
Structured Data I/O
Structured data I/Ostructured-data-ioThe spec at https://raw.githubusercontent.com/hyperdxio/hyperdx/refs/heads/main/packages/api/openapi.json declares typed, consistent response schemas (84% 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-healthHealth/status endpoint found at https://status.clickhouse.com/api/v2/status.json (HTTP 200).Detected
Retry & idempotencyretry-and-idempotencyNo retry or idempotency documentation found at the standard docs locations an agent would check.Not detected
Webhook documentationwebhook-documentationWebhooks are mentioned at https://clickhouse.com/blog/clickhouse-webhook-endpoint, but not on a page dedicated to documenting them.Detected
Error documentationerror-documentationNo error documentation found at the standard docs locations an agent would check.Not 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
security.txtsecurity-txtsecurity.txt at https://clickhouse.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-pagesNo terms, privacy, or data-use policy pages found at conventional paths.Not detected