Agent Readiness Score
clay.com
47 — Developing. Agents can find parts of this site, but key capabilities are hard to reach.
HonestClaw measured how well clay.com's site and APIs work for AI agents — across 9 dimensions and 45 automated checks.
Dimensions
Discoverability14.3/24
Content Accessibility13.6/24
Bot Access Control0/12
Protocol & Capability Discovery15.1/41
Authentication & Credentials8.8/19
Documentation Quality5.3/10
Structured Data I/O8.1/13
Observable State & Reliability5.3/15
Agent Safety & Trust8.5/11
Checks
Discoverability
Subdomain sweepsubdomain-sweepAn agent-relevant subdomain is live and serves its expected content kind (docs.clay.com).Parseable
Canonical domaincanonical-domainRoot and www converge on www.clay.com, with a matching canonical tag.Cross-verified
robots.txtrobots-txtrobots.txt at https://clay.com/robots.txt declares a sitemap. Declared sitemap https://www.clay.com/guides/sitemap.xml resolves as valid XML.Cross-verified
sitemap.xmlsitemap-xmlhttps://www.clay.com/guides/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://developers.clay.com/openapi.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-versioningAPI versioning is documented at https://university.clay.com/docs/table-versions (the versioning scheme). To reach the top level, it would need a documented deprecation/sunset lifecycle. (source: docs)Useful
Content Accessibility
Markdown twinmarkdown-twinA markdown twin is published at https://developers.clay.com/index.md alongside the docs HTML surface (https://developers.clay.com/).Parseable
Freshness signalsfreshness-signalsA single freshness signal is present (Last-Modified header).Parseable
Crawl-cost estimatecrawl-cost-estimateInformational — not scoredLarge sitemap (16,764 page URLs) signals high crawl cost with limited guidance.Detected
llms.txtllms-txtA curated llms.txt index is published on a non-top subdomain at https://developers.clay.com/llms.txt: 44 links across 2 sections. Its credit is capped at useful because it is not published on the main domain.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-extractabilityReadable content is extractable without JavaScript on 2 probed surface(s) with a strong main-content ratio (99% 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 scoredAn MCP server is described at https://developers.clay.com/.well-known/mcp.json, but the description doesn't include a web address for the server.Parseable
.well-known indexwell-known-indexNo non-owned /.well-known/ descriptors found.Not detected
SDK availabilitysdk-availabilityNo SDK or client library documentation found.Not detected
A2A Agent Carda2a-agent-cardAn A2A Agent Card at https://developers.clay.com/.well-known/agent-card.json declares 1 skill(s) and a connectable endpoint.Useful
MCP Server Cardmcp-server-cardA file exists at https://developers.clay.com/.well-known/mcp/server-card.json, but it doesn't contain the fields that describe an MCP Server Card.Detected
DNS-AIDdns-aidNo DNS-AID index found at _index._agents.clay.com.Not detected
MCP supportmcp-supportA first-party MCP support page exists at https://www.clay.com/blog/clay-mcp, but it does not identify a concrete HTTPS MCP endpoint or fully establish a company-operated service.Parseable
GraphQL surfacegraphql-surfaceNo GraphQL transport surface found at conventional paths (GET-only; no introspection issued).Not detected
Auth discoveryauth-discoveryA drivable auth-discovery descriptor is published.Useful
Link headerslink-headersLink header(s) present with recognized rel values.Parseable
OpenAPI specificationopenapi-specValid OpenAPI 3.1.0 spec at https://developers.clay.com/openapi.json: 13 operations, 48 schemas, 100% response coverage, servers declared.Cross-verified
Rate limit documentationrate-limit-docsA rate-limit documentation page exists at https://developers.clay.com/public-api/rate-limits, but it doesn't state a concrete limit alongside a rate-limit response header.Parseable
WebMCPwebmcpInformational — not scoredWebMCP browser probing is not yet available in this scanner release.Couldn't verify
Authentication & Credentials
Programmatic auth flowprogrammatic-auth-flowA programmatic auth flow is documented at https://developers.clay.com/public-api/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
Credential managementcredential-managementNo credential management documentation found at the standard docs locations an agent would check.Not detected
Auth documentationauth-documentationAuthentication is documented at https://developers.clay.com/public-api/authentication with the specific detail an agent needs — the credential and how it is sent. To reach the top level, it would need to corroborate against another surface or document more than one complete method.Useful
Sandbox environmentsandbox-environmentA sandbox/testing page exists at https://university.clay.com/docs/sandbox-mode, but it doesn't show how to obtain test credentials or a test base URL.Parseable
Documentation Quality
API reference depthapi-reference-depthAn API reference page exists at https://developers.clay.com/api-reference/search/get-the-clay-search-query-reference-beta, but it doesn't show parameters with example requests and responses.Parseable
Changelog presencechangelog-presenceA changelog is published at https://www.clay.com/changelog/2024-12-6 with dated entries describing changes. To reach the top level, it would need multiple recent dated entries showing an ongoing cadence.Useful
Structured Data I/O
Structured data I/Ostructured-data-ioThe spec at https://developers.clay.com/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-pricingA response at https://clay.com/pricing.json looks JSON-like but did not parse as JSON.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-healthNo health or status endpoint found.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://developers.clay.com/public-api/webhooks, but it doesn't list specific event types with their payload shape.Parseable
Error documentationerror-documentationErrors are documented at https://developers.clay.com/public-api/errors with specific codes or a documented response shape. To reach the top level, it would need recovery guidance and a machine-readable error format, or corroboration against the API spec.Useful
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://clay.com/.well-known/security.txt includes Contact, a future Expires date, and Encryption or Policy.Cross-verified
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