HonestClaw
What is Agent Readiness?

Agent Readiness Score

helicone.ai

42 — Developing. Agents can find parts of this site, but key capabilities are hard to reach.

44 of 45 checks conclusive · Confidence High · Evidence coverage 98%

HonestClaw measured how well helicone.ai's site and APIs work for AI agents — across 9 dimensions and 45 automated checks.

Dimensions

Discoverability13/24
Content Accessibility7.1/24
Bot Access Control0/12
Protocol & Capability Discovery16.6/36
Authentication & Credentials10/19
Documentation Quality5.5/10
Structured Data I/O5.6/13
Observable State & Reliability5.3/15
Agent Safety & Trust5.5/11

Checks

Discoverability

Subdomain sweepsubdomain-sweepAn agent-relevant subdomain is live and serves its expected content kind (docs.helicone.ai).Parseable
Canonical domaincanonical-domainRoot and www converge on a single canonical host (www.helicone.ai).Parseable
robots.txtrobots-txtrobots.txt at https://helicone.ai/robots.txt declares a sitemap. Declared sitemap https://www.helicone.ai/sitemap.xml resolves as valid XML.Cross-verified
sitemap.xmlsitemap-xmlhttps://docs.helicone.ai/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://docs.helicone.ai/swagger.json: the spec lists servers and paths. (source: spec)Parseable
API catalogapi-catalogNo RFC 9727 API Catalog found at /.well-known/api-catalog. Blocked by robots.txt for a generic compliant agent (Disallow: /api/; Disallow: /v2*; Disallow: /v1*).Not detected
API versioningapi-versioningAPI versioning is documented at https://docs.helicone.ai/rest/prompts/post-v1prompt-2025-query-environment-version (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://docs.helicone.ai/getting-started/quick-start.md alongside the docs HTML surface (https://docs.helicone.ai/).Parseable
Freshness signalsfreshness-signalsA single freshness signal is present (ETag header).Parseable
Crawl-cost estimatecrawl-cost-estimateInformational — not scoredSitemap index declares 2 child sitemap(s) — crawl cost is not directly observable from the index alone.Parseable
Raw content extractabilityraw-content-extractabilityThe homepage is a JS-rendered shell with no meaningful content in the initial HTML — content is behind JavaScript.Not detected
llms.txtllms-txtA curated llms.txt index is published at https://www.helicone.ai/llms.txt: 12 links across 3 sections.Cross-verified
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

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://docs.helicone.ai/.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
MCP Server Cardmcp-server-cardA file exists at https://docs.helicone.ai/.well-known/mcp/server-card.json, but it doesn't contain the fields that describe an MCP Server Card.Detected
A2A Agent Carda2a-agent-cardAn A2A Agent Card is described at https://docs.helicone.ai/.well-known/agent-card.json, but it is missing required fields (name, description, version, supportedInterfaces, or skills).Parseable
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/; Disallow: /v1*).Not detected
DNS-AIDdns-aidNo DNS-AID index found at _index._agents.helicone.ai.Not detected
MCP supportmcp-supportA first-party MCP support page exists at https://docs.helicone.ai/integrations/tools/mcp, but it does not identify a concrete HTTPS MCP endpoint or fully establish a company-operated service.Parseable
SDK availabilitysdk-availabilitySDK libraries page at https://docs.helicone.ai/gateway/integrations/vercel-ai-sdk: 2 GitHub repos, 0 registry links, 0 install commands (2 pointers).Cross-verified
Rate limit documentationrate-limit-docsRate limits are documented at https://docs.helicone.ai/features/advanced-usage/custom-rate-limits with a concrete limit and rate-limit response headers. To reach the top level, it would need 429 handling, Retry-After guidance, and tier/plan differences.Useful
Link headerslink-headersNo RFC 8288 Link headers found on any probed response. Blocked by robots.txt for a generic compliant agent (Disallow: /api/; Disallow: /v2*; Disallow: /v1*).Not detected
OpenAPI specificationopenapi-specValid OpenAPI 3.0.0 spec at https://docs.helicone.ai/swagger.json: 267 operations, 543 schemas, 100% response coverage, servers declared.Cross-verified
WebMCPwebmcpInformational — not scoredWebMCP browser probing is not yet available in this scanner release.Couldn't verify
Auth discoveryauth-discoveryCould not conclusively check for an auth-discovery surface (unreachable, rate-limited, or behind auth).Couldn't verify

Authentication & Credentials

Programmatic auth flowprogrammatic-auth-flowA programmatic auth flow is fully documented at https://www.mintlify.com/docs/deploy/authentication-setup, with a non-interactive grant, token endpoint, scopes, and token expiry/refresh.Cross-verified
Auth documentationauth-documentationAuthentication is fully documented at https://www.mintlify.com/docs/deploy/authentication-setup, naming complete method(s) and how they are sent, corroborated across surfaces or covering multiple methods.Cross-verified
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

Changelog presencechangelog-presenceA changelog is published at https://www.mintlify.com/docs/changelog with multiple recent dated entries, indicating it is actively maintained.Cross-verified
API reference depthapi-reference-depthAPI reference content is mentioned at https://docs.helicone.ai/rest/ai-gateway/get-v1models, but not on a dedicated reference page.Detected

Structured Data I/O

Structured data I/Ostructured-data-ioThe spec at https://docs.helicone.ai/swagger.json declares typed response schemas as a rule (93% of operations) — no structured error envelope. (source: spec)Useful
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

Status & health endpointsstatus-and-healthNo health or status endpoint found. Blocked by robots.txt for a generic compliant agent (Disallow: /api/).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. Blocked by robots.txt for a generic compliant agent (Disallow: /api/; Disallow: /v2*; Disallow: /v1*).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.helicone.ai/features/webhooks, but it doesn't list specific event types with their payload shape.Parseable
Error documentationerror-documentationErrors are documented at https://docs.helicone.ai/gateway/concepts/error-handling 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

Agent Safety & Trust

security.txtsecurity-txtNo security.txt found at /.well-known/security.txt or /security.txt.Not detected
Legal policy pageslegal-pagesBoth privacy and terms policies are discoverable with substantive content.Useful
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