HonestClaw
What is Agent Readiness?

Agent Readiness Score

prefect.io

32 — Limited. Agents will struggle to discover or use this site without human help.

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

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

Dimensions

Discoverability14.1/24
Content Accessibility15.1/24
Bot Access Control0/12
Protocol & Capability Discovery6.3/36
Authentication & Credentials4/19
Documentation Quality5.3/10
Structured Data I/O0/13
Observable State & Reliability2.3/15
Agent Safety & Trust5.5/11

Checks

Discoverability

Subdomain sweepsubdomain-sweepAn agent-relevant subdomain is live and serves its expected content kind (docs.prefect.io).Parseable
Canonical domaincanonical-domainRoot and www converge on www.prefect.io, with a matching canonical tag.Cross-verified
robots.txtrobots-txtrobots.txt at https://prefect.io/robots.txt declares a sitemap. Declared sitemap https://www.prefect.io/sitemap-index.xml resolves as valid XML.Cross-verified
sitemap.xmlsitemap-xmlhttps://www.prefect.io/sitemap.xml is a dated sitemap whose URLs include docs/pricing/api surfaces.Cross-verified
API existenceapi-existenceNo API endpoint found at common paths (only HTML pages or 404s). Blocked by robots.txt for a generic compliant agent (Disallow: /api/).Not detected
API catalogapi-catalogNo RFC 9727 API Catalog found at /.well-known/api-catalog. Blocked by robots.txt for a generic compliant agent (Disallow: /api/).Not detected
API versioningapi-versioningThe API version lifecycle is documented at https://docs.prefect.io/v3/release-notes/versioning, including deprecation/sunset. (source: docs)Cross-verified

Content Accessibility

Markdown twinmarkdown-twinA markdown twin is published at https://docs.prefect.io/v3/get-started.md alongside the docs HTML surface (https://docs.prefect.io/).Parseable
Freshness signalsfreshness-signalsA single freshness signal is present (sitemap lastmod).Parseable
Crawl-cost estimatecrawl-cost-estimateInformational — not scoredA manageable sitemap (104 page URLs) helps agents estimate crawl cost.Useful
Raw content extractabilityraw-content-extractabilityReadable content is extractable without JavaScript on 2 probed surface(s) with substantial visible text.Cross-verified
llms.txtllms-txtA curated llms.txt index is published at https://www.prefect.io/llms.txt: 29 links across 5 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.prefect.io/.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.prefect.io/.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.prefect.io/.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/).Not detected
DNS-AIDdns-aidNo DNS-AID index found at _index._agents.prefect.io.Not detected
MCP supportmcp-supportA first-party MCP support page exists at https://docs.prefect.io/v3/get-started, but it does not identify a concrete HTTPS MCP endpoint or fully establish a company-operated service.Parseable
Auth discoveryauth-discoveryNo standardized authentication-discovery surface found.Not detected
OpenAPI specificationopenapi-specNo OpenAPI/Swagger specification found. Blocked by robots.txt for a generic compliant agent (Disallow: /api/).Not detected
Link headerslink-headersAn agent-relevant Link rel (api-catalog) points at /.well-known/api-catalog.Useful
Rate limit documentationrate-limit-docsA rate-limit documentation page exists at https://docs.prefect.io/v3/concepts/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
SDK availabilitysdk-availabilityCould not conclusively check for SDK or client library documentation (endpoints unreachable, rate-limited, or behind auth).Couldn't verify

Authentication & Credentials

Programmatic auth flowprogrammatic-auth-flowProgrammatic authentication is mentioned at https://docs.prefect.io/v3/how-to-guides/cloud/manage-users/api-keys, but not on a page dedicated to documenting it.Detected
Auth documentationauth-documentationAuthentication is documented at https://docs.prefect.io/v3/how-to-guides/cloud/manage-users/api-keys 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-environmentNo sandbox or test environment documentation found at the standard docs locations an agent would check.Not detected
Credential managementcredential-managementNo credential management documentation found at the standard docs locations an agent would check.Not detected

Documentation Quality

API reference depthapi-reference-depthThe API reference at https://docs.prefect.io/v3/api-ref/rest-api 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 page exists at https://docs.prefect.io/v3/release-notes, but it doesn't list dated entries describing actual changes.Parseable

Structured Data I/O

Structured data I/Ostructured-data-ioNo published structured-data contract found (no typed spec response schemas). Blocked by robots.txt for a generic compliant agent (Disallow: /api/).Not detected
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-healthHealth/status endpoint found at https://status.prefect.io/api/v2/status.json (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: /api/).Not detected
Webhook documentationwebhook-documentationA webhook documentation page exists at https://docs.prefect.io/v3/concepts/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. Blocked by robots.txt for a generic compliant agent (Disallow: /api/).Not detected
Retry & idempotencyretry-and-idempotencyRetry/idempotency is mentioned at https://docs.prefect.io/v3/how-to-guides/workflows/retries, but not on a page dedicated to documenting it.Detected

Agent Safety & Trust

security.txtsecurity-txtNo security.txt found at /.well-known/security.txt or /security.txt.Not detected
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