Agent Readiness Score
vercel.com
40 — Developing. Agents can find parts of this site, but key capabilities are hard to reach.
HonestClaw measured how well vercel.com's site and APIs work for AI agents — across 9 dimensions and 45 automated checks.
Dimensions
Discoverability10.9/24
Content Accessibility16.2/24
Bot Access Control2/12
Protocol & Capability Discovery16.2/41
Authentication & Credentials6.2/19
Documentation Quality1.8/5
Structured Data I/O0/13
Observable State & Reliability5.6/15
Agent Safety & Trust7.3/11
Checks
Discoverability
Subdomain sweepsubdomain-sweepBoth an API-family and a docs-family subdomain are live (api.vercel.com, docs.vercel.com).Useful
robots.txtrobots-txtrobots.txt at https://vercel.com/robots.txt declares a sitemap. Declared sitemap https://vercel.com/sitemap.xml resolves as valid XML.Cross-verified
API catalogapi-catalogAPI Catalog found at https://vercel.com/.well-known/api-catalog (application/linkset+json).Detected
sitemap.xmlsitemap-xmlhttps://vercel.com/crawled-sitemap.xml is a dated sitemap whose URLs include docs/pricing/api surfaces.Cross-verified
Canonical domaincanonical-domainRoot and www converge on vercel.com, with a matching canonical tag.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 versioningapi-versioningVersioning is mentioned at https://vercel.com/blog/version-skew-protection, but not on a page dedicated to documenting it. (source: docs)Detected
Content Accessibility
llms.txtllms-txtA curated llms.txt index is published at https://vercel.com/llms.txt: 1836 links across 21 sections.Cross-verified
Raw content extractabilityraw-content-extractabilityReadable content is extractable without JavaScript on 2 probed surface(s) with substantial visible text.Cross-verified
Freshness signalsfreshness-signalsFreshness signals present: ETag header, sitemap lastmod.Useful
Crawl-cost estimatecrawl-cost-estimateInformational — not scoredSitemap declares 6219 page URLs — moderate crawl cost; agents should budget accordingly.Parseable
Markdown twinmarkdown-twinA markdown twin is published at https://vercel.com/docs.md alongside the docs HTML surface (/docs).Parseable
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 declares 3 recognized Content Signal(s) with a valid value: search, ai-input, ai-train.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 supportmcp-supportFirst-party documentation at https://vercel.com/docs/agent-resources/vercel-mcp identifies the MCP endpoint https://mcp.vercel.com/ and explains both its capabilities and how clients connect or authenticate.Cross-verified
MCP descriptormcp-descriptorInformational — not scoredNo MCP descriptor found at the standard locations an agent would check.Not detected
A2A Agent Carda2a-agent-cardNo A2A Agent Card found at the standard well-known locations.Not detected
MCP Server Cardmcp-server-cardNo MCP Server Card found at the standard locations an agent would check.Not detected
DNS-AIDdns-aidNo DNS-AID index found at _index._agents.vercel.com.Not detected
.well-known indexwell-known-indexNo non-owned /.well-known/ descriptors found.Not detected
Auth discoveryauth-discoveryAgent-native auth discovery: a valid RFC 9728 PRM (via challenge) or a PRM plus a valid AS/OIDC descriptor.Cross-verified
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
SDK availabilitysdk-availabilityGetting-started page at https://vercel.com/ai-sdk: 3 GitHub repos, 0 registry links, 1 install command (4 pointers).Cross-verified
Link headerslink-headersLink header(s) present with recognized rel values.Parseable
OpenAPI specificationopenapi-specNo OpenAPI/Swagger specification found. Blocked by robots.txt for a generic compliant agent (Disallow: /api/).Not detected
Rate limit documentationrate-limit-docsRate limiting is mentioned at https://vercel.com/blog/vercel-waf-upgrade-brings-persistent-actions-rate-limiting-and-api-control, but not on a page dedicated to documenting it.Detected
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://vercel.com/docs, but not on a page dedicated to documenting it.Detected
Credential managementcredential-managementCredential management is mentioned at https://vercel.com/changelog/secure-marketplace-credentials-with-production-only-access, but not on a page dedicated to documenting it.Detected
Auth documentationauth-documentationAuthentication is documented at https://vercel.com/docs/rest-api 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://vercel.com/docs/sandbox, 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://vercel.com/docs/rest-api, but it doesn't show parameters with example requests and responses.Parseable
Changelog presencechangelog-presenceCould not conclusively check for a changelog or release notes (endpoints unreachable, rate-limited, or behind auth).Couldn't verify
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
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
Webhook documentationwebhook-documentationA webhook documentation page exists at https://vercel.com/docs/webhooks, but it doesn't list specific event types with their payload shape.Parseable
Error documentationerror-documentationErrors are documented at https://vercel.com/docs/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
Retry & idempotencyretry-and-idempotencyRetry/idempotency is mentioned at https://vercel.com/i/what-is-idempotency, but not on a page dedicated to documenting it.Detected
Agent Safety & Trust
security.txtsecurity-txtsecurity.txt at https://vercel.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-pagesAt least one legal policy page is discoverable.Detected