---
title: "turbopuffer agent readiness score: 60/100 · Agentrail"
description: "Discovery is the strongest area, with brand name and developer resource discoverability passing, while an OpenAPI specification and OAuth support are missed checks."
canonical: "https://www.agentrail.co/agent-readiness/turbopuffer.com"
---

Full report

## See what each check found, and how to fix it.

Evidence, step-by-step fixes and your score over time, for your own site.

[Get started →](https://app.agentrail.co/login?utm%5Fsource=agentrail.co&utm%5Fmedium=website&utm%5Fcampaign=agent-readiness%2Fturbopuffer.com&utm%5Fcontent=company-report)

Free to start. No card.

Usability

22 to fix

- OAuth 2.0 supportRequiredHow to fix →
- Scoped permissionsRecommendedHow to fix →
- Agent onboarding frictionRecommendedHow to fix →
- Web Bot Auth directoryEmergingHow to fix →

Fixes unlock with the full report

Where the score comes from

55 of 90 points

How turbopuffer.com scores on each of the four questions agents ask.

Discovery18/20

Access22/30

Usability15/40

Paymentsnot scored yet

Strongest

### Discovery

ARD discovery and Wikipedia / Wikidata entity presence are missing.

18/20

Most to gain

### Usability

OAuth 2.0 support, Scoped permissions, and 17 more are missing.

15/40

Most to gain

### Access

Content without JavaScript, Agent discovery file, and 10 more are missing.

22/30

Not scored yet

### Payments ( bonus )

4 checks partly met. Counts when scoring opens.

—

Agent path

## How an agent moved through the site

We asked an agent a question about turbopuffer.comand recorded every request it made.

**T**turbopuffer.comAnsweredRan Nov 10, 2026

Question

I want to start using turbopuffer (turbopuffer.com). Find its setup and getting-started guide.

3

Steps

27s

Duration

3

Pages opened

0

Failed

Every link it followed loaded.

1. 1turbopuffer.com /Named in the question _→_ **Read**
2. 2/docsA link on a page it read _→_ **Read**
3. 3/docs/quickstartA link on a page it read _→_ **Read**

3/3 steps

StepsHow it found itCame back as

Step 3 of 3

`turbopuffer.com/docs/quickstart`

How it got here

A link on a page it read

Response

200

Came back as

Web page

100%

Pages that loaded

67%

Followed site links

0%

Read as markdown

How it found each page

Named in the question**1**

A link on a page it read**2**

Typed by the agent**0**

A search result**0**

What it reached

Home page**Step 1**

Pricing**Never reached**

Docs**Step 2**

Its answer

Answers aren’t shown publicly

See what agents answer about your own site.

Run agents on your site and read every answer, with every page they opened.

[Get started →](https://app.agentrail.co/login?utm%5Fsource=agentrail.co&utm%5Fmedium=website&utm%5Fcampaign=agent-readiness%2Fturbopuffer.com&utm%5Fcontent=journey-answer)

Free to start. No card.

Every check

125checks

- Passed**24**
- To fix**37**
- Not in the score**64**

61 checks count toward the score. The other 64 are tracked for later.

Discovery18 of 202 to fix4 passed

ARD discoveryRequired0 / 1

Wikipedia / Wikidata entity presenceRecommended0 / 4

Developer resource discoverabilityRecommended3 / 3

Brand name discoverabilityRequired3 / 3

robots.txt AI crawler policyRequired2 / 2

NPM/PyPI SDK packageRecommended1 / 1

\+ 9 checks not in the score

AI Catalog discoveryRecommendedNot counted

ARD entry validityRecommendedNot counted

ARD trust manifestRecommendedNot counted

Category share of voiceRecommendedNot counted

Listed in MCP registriesRecommendedNot counted

Agent platform configsEmergingNot counted

Agent Plugins manifestEmergingNot counted

Registry brandingEmergingNot counted

ChatGPT app listedRecommendedNot counted

Access22 of 308 to fix4 partly15 passed

Agent discovery fileRequired0 / 2

A2A / agent-cardRecommended0 / 2

MCP well-known discoveryRecommended0 / 2

HTTP Link headers (RFC 8288)Required0 / 1

Schema type breadthRecommended0 / 2

OpenAPI spec publishedRequired0 / 7

API catalog (RFC 9727)Required0 / 2

Markdown content negotiation (acceptmarkdown.com)Recommended0 / 1

Content without JavaScriptRequired2 / 3

Metadata completenessRequired1 / 2

Organization schema completenessRecommended1 / 2

Trust anchor pagesRequired1 / 2

Sitemap existsRequired2 / 2

Not blocked by bot detectionRequired2 / 2

Sitemap freshness (lastmod)Recommended1 / 1

robots.txt agent-user policyRequired2 / 2

llms.txt existsRequired1 / 1

llms.txt formattingRecommended2 / 2

JSON-LD structured dataRequired4 / 4

Pricing info accessibleRequired3 / 3

Public API/docs linked from homepageRequired3 / 3

JSON-LD entity linking (sameAs)Recommended2 / 2

llms.txt links resolveRecommended2 / 2

Redirect hygieneRecommended1 / 1

Page token budgetRecommended1 / 1

Developer portalRecommended6 / 6

Agent crawler reachabilityRecommended2 / 2

\+ 15 checks not in the score

Agent Skills index conformance (v0.2.0)EmergingNot counted

Listed on skills.shEmergingNot counted

pricing.md existsEmergingNot counted

NLWeb Schema FeedsEmergingNot counted

Agent mode viewEmergingNot counted

Markdown URL fallbackEmergingNot counted

Modular llms.txt per product areaEmergingNot counted

Agent instruction / when-to-useRequiredNot counted

Skills.sh skill qualityEmergingNot counted

Markdown alternate linkEmergingNot counted

Markdown frontmatter metadataEmergingNot counted

Code fence validityEmergingNot counted

Content behind authRecommendedNot counted

Markdown agent docsEmergingNot counted

Bot-UA markdown servingEmergingNot counted

Usability15 of 4018 to fix1 partly5 passed

OAuth 2.0 supportRequired0 / 5

Scoped permissionsRecommended0 / 5

Agent onboarding frictionRecommended0 / 2

OAuth Protected Resource metadata (RFC 9728)Required0 / 2

auth.md existsRequired0 / 2

auth.md structureRecommended0 / 2

Agent auth discovery metadataRecommended0 / 3

Agent auth WWW-Authenticate hintRecommended0 / 1

agent\_auth endpoints reachableRecommended0 / 2

MCP server / manifestRequired0 / 6

Rate limit response headersRecommended0 / 2

Idempotency-Key supportRecommended0 / 3

REST typed error modelRecommended0 / 3

REST async-job patternRecommended0 / 2

REST batch / bulk endpointRecommended0 / 2

Accessible document structureRecommended0 / 3

API schema complexity analysisRecommended0 / 2

Function calling compatibilityRecommended0 / 2

Agent-friendly 404sRecommended1 / 2

Public API with reachable endpointsRequired7 / 7

JSON error responsesRequired4 / 4

CLI tool availableRecommended3 / 3

Sandbox / test environmentRecommended2 / 2

Accessible names on controlsRecommended2 / 2

\+ 38 checks not in the score

MCP tool descriptionsRecommendedNot counted

MCP parameter schemasRecommendedNot counted

MCP server identityRecommendedNot counted

MCP tool listingRecommendedNot counted

MCP tool namingRecommendedNot counted

MCP auth mechanismRecommendedNot counted

MCP OAuth metadataRecommendedNot counted

MCP PKCE S256 supportRecommendedNot counted

Web Bot Auth directoryEmergingNot counted

auth.md walkthrough simulationRecommendedNot counted

MCP error handlingRecommendedNot counted

MCP modern transportRecommendedNot counted

WebMCP supportRequiredNot counted

REST versioning / deprecation policyRecommendedNot counted

REST pagination patternRecommendedNot counted

Multi-language SDK packagesRecommendedNot counted

NLWeb /ask endpointEmergingNot counted

NLWeb streaming supportEmergingNot counted

REST response schema coverageRecommendedNot counted

MCP tool annotationsRecommendedNot counted

MCP server-card.jsonRecommendedNot counted

Product + docs MCP coverageRecommendedNot counted

MCP resources exposedRecommendedNot counted

GraphQL typed error modelRecommendedNot counted

GraphQL versioning / deprecation policyRecommendedNot counted

GraphQL pagination patternRecommendedNot counted

GraphQL async-job patternRecommendedNot counted

GraphQL schema description coverageRecommendedNot counted

GraphQL batch mutationsRecommendedNot counted

Native interactive controlsRecommendedNot counted

Form control labelingRecommendedNot counted

Accessibility-tree injection safety (bonus)RecommendedNot counted

MCP Apps supportRecommendedNot counted

A2UI / generative UI supportEmergingNot counted

MCP Apps UI qualityRecommendedNot counted

MCP App view reachableRecommendedNot counted

MCP App view CSPRecommendedNot counted

MCP resource qualityRecommendedNot counted

PaymentsNot scored yet4 partly

MPP payment protocolRequired0 / 2

x402 payment protocolRequired0 / 2

UCP - Universal Commerce ProtocolRequired0 / 3

AP2 - Agent Payments ProtocolRecommended0 / 3

\+ 2 checks not in the score

ACP - Agentic Commerce ProtocolRequiredNot counted

ACP delegate paymentRecommendedNot counted
