---
title: "Astronomer agent readiness score: 64/100 · Agentrail"
description: "The site is strongest in agent discovery, with its brand and developer resources discoverable, but misses checks for an MCP server or manifest and"
canonical: "https://www.agentrail.co/agent-readiness/astronomer.io?h=FVS7J4AMZ5C2100W"
---

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%2Fastronomer.io&utm%5Fcontent=company-report)

Free to start. No card.

Usability

23 to fix

- OAuth 2.0 supportRequiredHow to fix →
- Scoped permissionsRecommendedHow to fix →
- Web Bot Auth directoryEmergingHow to fix →
- OAuth Protected Resource metadata (RFC 9728)RequiredHow to fix →

Fixes unlock with the full report

Where the score comes from

57 of 90 points

How astronomer.io scores on each of the four questions agents ask.

Discovery18/20

Access25/30

Usability14/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 13 more are missing.

14/40

Most to gain

### Access

Content without JavaScript, robots.txt agent-user policy, and 2 more are missing.

25/30

Not scored yet

### Payments ( bonus )

Counts when scoring opens.

—

Agent path

## How an agent moved through the site

We asked an agent a question about astronomer.ioand recorded every request it made.

**A**astronomer.ioAnsweredRan Nov 4, 2026

Question

I want to start using Astronomer (astronomer.io). Find its setup and getting-started guide.

6

Steps

45s

Duration

6

Pages opened

1

Failed

1 of 1 address the agent typed itself didn’t load. Every link it followed loaded.

1. 1astronomer.io /Named in the question _→_ **Read**
2. 2astronomer.io /Typed by the agent _→_ **Didn’t load · 301**
3. 3/docsA link on a page it read _→_ **Read**
4. 4/docs/cli.mdA link on a page it read _→_ **Read**
5. 5/docs/cli/v1.47/get-started-cli.mdA link on a page it read _→_ **Read**
6. 6/docs/cli/v1.47/install-cli.mdA link on a page it read _→_ **Read**

6/6 steps

StepsHow it found itCame back as

Step 6 of 6

`astronomer.io/docs/cli/v1.47/install-cli.md`

How it got here

A link on a page it read

Response

301 → 200

Came back as

Markdown

83%

Pages that loaded

67%

Followed site links

100%

Read as markdown

How it found each page

Named in the question**1**

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

Typed by the agent**1**

A search result**0**

What it reached

Home page**Step 1**

Pricing**Never reached**

Docs**Step 3**

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%2Fastronomer.io&utm%5Fcontent=journey-answer)

Free to start. No card.

Every check

139checks

- Passed**32**
- To fix**21**
- Not in the score**86**

53 checks count toward the score. The other 86 are tracked for later.

Discovery18 of 201 to fix1 partly5 passed

ARD discoveryRequired0 / 1

Wikipedia / Wikidata entity presenceRecommended2 / 4

Developer resource discoverabilityRecommended4 / 4

Brand name discoverabilityRequired3 / 3

robots.txt AI crawler policyRequired1 / 1

NPM/PyPI SDK packageRecommended1 / 1

Homepage not hidden from searchRecommended1 / 1

\+ 8 checks not in the score

AI Catalog discoveryEmergingNot counted

ARD entry validityRecommendedNot counted

ARD trust manifestEmergingNot counted

Listed in MCP registriesRecommendedNot counted

Agent platform configsEmergingNot counted

Agent Plugins manifestEmergingNot counted

Registry brandingEmergingNot counted

ChatGPT app listedRecommendedNot counted

Access25 of 302 to fix2 partly18 passed

Agent instruction / when-to-useRequired0 / 1

Developer portalRecommended0 / 5

Content without JavaScriptRequired3.3 / 5

robots.txt agent-user policyRequired0.5 / 1

Sitemap existsRequired1 / 1

Not blocked by bot detectionRequired2 / 2

llms.txt existsRequired1 / 1

llms.txt formattingRecommended2 / 2

JSON-LD structured dataRequired2 / 2

Pricing info accessibleRequired3 / 3

Public API/docs linked from homepageRequired4 / 4

JSON-LD entity linking (sameAs)Recommended1 / 1

Metadata completenessRequired1 / 1

Organization schema completenessRecommended1 / 1

Trust anchor pagesRequired1 / 1

llms.txt links resolveRecommended2 / 2

Redirect hygieneRecommended1 / 1

Page token budgetRecommended1 / 1

Content behind authRecommended1 / 1

OpenAPI spec publishedRequired8 / 8

Markdown content negotiation (acceptmarkdown.com)Recommended1 / 1

Agent crawler reachabilityRecommended1 / 1

\+ 18 checks not in the score

Agent discovery fileEmergingNot counted

Agent Skills index conformance (v0.2.0)EmergingNot counted

A2A / agent-cardEmergingNot counted

Listed on skills.shEmergingNot counted

pricing.md existsEmergingNot counted

NLWeb Schema FeedsEmergingNot counted

MCP well-known discoveryEmergingNot counted

HTTP Link headers (RFC 8288)EmergingNot counted

Markdown URL fallbackEmergingNot counted

Modular llms.txt per product areaEmergingNot counted

Skills.sh skill qualityEmergingNot counted

Markdown alternate linkEmergingNot counted

Markdown frontmatter metadataEmergingNot counted

Code fence validityEmergingNot counted

API catalog (RFC 9727)EmergingNot counted

Markdown agent docsEmergingNot counted

Bot-UA markdown servingEmergingNot counted

Content starts near the topEmergingNot counted

Usability14 of 4012 to fix3 partly9 passed

OAuth 2.0 supportRequired0 / 5

Scoped permissionsRecommended0 / 5

OAuth Protected Resource metadata (RFC 9728)Required0 / 2

MCP server / manifestRequired0 / 10

Rate limit response headersRecommended0 / 2

JSON error responsesRequired0 / 3

REST versioning / deprecation policyRecommended0 / 3

REST pagination patternRecommended0 / 2

REST response schema coverageRecommended0 / 2

Sandbox / test environmentRecommended0 / 2

API schema complexity analysisRecommended0 / 2

Function calling compatibilityRecommended0 / 2

WebMCP supportRequired7.2 / 8

REST typed error modelRecommended1 / 3

WebMCP consequential hintRecommended0 / 0

Public API with reachable endpointsRequired8 / 8

Agent onboarding frictionRecommended2 / 2

CLI tool availableRecommended3 / 3

Agent-friendly 404sRecommended2 / 2

WebMCP schema validityRecommended0 / 0

WebMCP schema detailRecommended0 / 0

WebMCP tool namesRecommended0 / 0

WebMCP read-only hintsRecommended0 / 0

WebMCP honest hintsRecommended0 / 0

\+ 55 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 existsEmergingNot counted

auth.md structureEmergingNot counted

auth.md walkthrough simulationEmergingNot counted

Agent auth discovery metadataEmergingNot counted

Agent auth WWW-Authenticate hintEmergingNot counted

agent\_auth endpoints reachableEmergingNot counted

MCP error handlingRecommendedNot counted

MCP modern transportRecommendedNot counted

Idempotency-Key supportRecommendedNot counted

REST async-job patternRecommendedNot counted

NLWeb /ask endpointEmergingNot counted

NLWeb streaming supportEmergingNot counted

MCP tool annotationsRecommendedNot counted

MCP server-card.jsonEmergingNot 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

Accessible document structureEmergingNot counted

Native interactive controlsEmergingNot counted

Accessible names on controlsEmergingNot counted

Form control labelingEmergingNot counted

Accessibility-tree injection safety (bonus)EmergingNot 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

MCP server instructionsRecommendedNot counted

MCP tools are distinguishableRecommendedNot counted

MCP tool output schemasRecommendedNot counted

MCP Apps checkout viewEmergingNot counted

WebMCP real toolsRecommendedNot counted

WebMCP entry pointRecommendedNot counted

WebMCP untrusted content hintRecommendedNot counted

WebMCP coverageRecommendedNot counted

Personal Agent Protocol discovery fileEmergingNot counted

PAP issuer bindingEmergingNot counted

PAP sign-in and extension configEmergingNot counted

PAP API and agent entriesEmergingNot counted

PAP endpoints reject unauthenticated agentsEmergingNot counted

PAP agrees with ARD and auth.mdEmergingNot counted

PaymentsNot scored yet

\+ 5 checks not in the score

MPP payment protocolRequiredNot counted

x402 payment protocolRequiredNot counted

UCP - Universal Commerce ProtocolRequiredNot counted

ACP - Agentic Commerce ProtocolRequiredNot counted

Agent wallet checkoutRequiredNot counted
