---
title: "Gitpod agent readiness score: 26/100 · Agentrail"
description: "Developer resources and the brand name are discoverable, but checks for a published OpenAPI specification and an MCP server or manifest were missed."
canonical: "https://www.agentrail.co/agent-readiness/gitpod.io?h=25YYYGX7FK14A002"
---

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

Free to start. No card.

Access

21 to fix

- Agent discovery fileEmergingHow to fix →
- Agent Skills index conformance (v0.2.0)EmergingHow to fix →
- A2A / agent-cardEmergingHow to fix →
- Listed on skills.shEmergingHow to fix →

Fixes unlock with the full report

Where the score comes from

24 of 90 points

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

Discovery17/20

Access2/30

Usability5/40

Paymentsnot scored yet

Strongest

### Discovery

ARD discovery, Wikipedia / Wikidata entity presence, and 1 more are missing.

17/20

Most to gain

### Usability

Scoped permissions, MCP server / manifest, and 7 more are missing.

5/40

Most to gain

### Access

robots.txt agent-user policy, JSON-LD structured data, and 7 more are missing.

2/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 gitpod.ioand recorded every request it made.

**G**gitpod.ioAnsweredRan Nov 20, 2026

Question

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

8

Steps

1m 36s

Duration

7

Pages opened

2

Failed

1 of 3 addresses the agent typed itself didn’t load.

1. 1gitpod.io /Named in the question _→_ **Didn’t load · 308**
2. 2gitpod.io /Named in the question _→_ **Read**
3. 3/docsTyped by the agent _→_ **Didn’t load · 308**
4. 4/docsTyped by the agent _→_ **Read**
5. 5“site:gitpod.io getting started documentation”Searched the web _→_ **Results**
6. 6ona.com/docs/classic/user/introduction/getting-started/overviewA search result _→_ **Read**
7. 7ona.com/docs/classic/user/introduction/getting-started/quickstart/overviewA search result _→_ **Read**
8. 8ona.com/docs/classic/user/introduction/getting-startedTyped by the agent _→_ **Read**

8/8 steps

StepsHow it found itCame back as

Step 8 of 8

`ona.com/docs/classic/user/introduction/getting-started · not gitpod.io`

How it got here

Typed by the agent

Response

307 → 200

Came back as

Markdown

71%

Pages that loaded

0%

Followed site links

60%

Read as markdown

How it found each page

Named in the question**2**

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

Typed by the agent**3**

A search result**2**

What it reached

Home page**Step 2**

Pricing**Never reached**

Docs**Step 4**

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

Free to start. No card.

Every check

139checks

- Passed**7**
- To fix**21**
- Not in the score**111**

28 checks count toward the score. The other 111 are tracked for later.

Discovery17 of 201 to fix2 partly3 passed

robots.txt AI crawler policyRequired0 / 1

ARD discoveryRequired0 / 1

Wikipedia / Wikidata entity presenceRecommended2 / 4

Developer resource discoverabilityRecommended4 / 4

Brand name discoverabilityRequired3 / 3

NPM/PyPI SDK packageRecommended1 / 1

\+ 9 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

Homepage not hidden from searchRecommendedNot counted

Access2 of 309 to fix2 passed

robots.txt agent-user policyRequired0 / 1

JSON-LD structured dataRequired0 / 2

Pricing info accessibleRequired0 / 3

JSON-LD entity linking (sameAs)Recommended0 / 1

Metadata completenessRequired0 / 1

Organization schema completenessRecommended0 / 1

Trust anchor pagesRequired0 / 1

OpenAPI spec publishedRequired0 / 8

Markdown content negotiation (acceptmarkdown.com)Recommended0 / 1

Redirect hygieneRecommended1 / 1

Page token budgetRecommended1 / 1

\+ 29 checks not in the score

Sitemap existsRequiredNot counted

Content without JavaScriptRequiredNot counted

Not blocked by bot detectionRequiredNot counted

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

llms.txt existsRequiredNot counted

llms.txt formattingRecommendedNot counted

Public API/docs linked from homepageRequiredNot counted

Agent instruction / when-to-useRequiredNot counted

Skills.sh skill qualityEmergingNot counted

llms.txt links resolveRecommendedNot counted

Markdown alternate linkEmergingNot counted

Markdown frontmatter metadataEmergingNot counted

Code fence validityEmergingNot counted

Content behind authRecommendedNot counted

Developer portalRecommendedNot counted

API catalog (RFC 9727)EmergingNot counted

Markdown agent docsEmergingNot counted

Bot-UA markdown servingEmergingNot counted

Agent crawler reachabilityRecommendedNot counted

Content starts near the topEmergingNot counted

Usability5 of 409 to fix2 passed

Scoped permissionsRecommended0 / 5

MCP server / manifestRequired0 / 10

Rate limit response headersRecommended0 / 2

Idempotency-Key supportRecommended0 / 3

JSON error responsesRequired0 / 3

REST typed error modelRecommended0 / 3

REST async-job patternRecommended0 / 2

API schema complexity analysisRecommended0 / 2

Function calling compatibilityRecommended0 / 2

OAuth 2.0 supportRequired5 / 5

CLI tool availableRecommended3 / 3

\+ 68 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

Public API with reachable endpointsRequiredNot counted

MCP auth mechanismRecommendedNot counted

MCP OAuth metadataRecommendedNot counted

MCP PKCE S256 supportRecommendedNot counted

Agent onboarding frictionRecommendedNot counted

Web Bot Auth directoryEmergingNot counted

OAuth Protected Resource metadata (RFC 9728)RequiredNot 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

WebMCP supportRequiredNot counted

REST versioning / deprecation policyRecommendedNot counted

REST pagination patternRecommendedNot counted

NLWeb /ask endpointEmergingNot counted

NLWeb streaming supportEmergingNot counted

REST response schema coverageRecommendedNot counted

MCP tool annotationsRecommendedNot counted

MCP server-card.jsonEmergingNot counted

Product + docs MCP coverageRecommendedNot counted

Sandbox / test environmentRecommendedNot 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

Agent-friendly 404sRecommendedNot 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 schema validityRecommendedNot counted

WebMCP schema detailRecommendedNot counted

WebMCP real toolsRecommendedNot counted

WebMCP entry pointRecommendedNot counted

WebMCP tool namesRecommendedNot counted

WebMCP read-only hintsRecommendedNot counted

WebMCP honest hintsRecommendedNot counted

WebMCP untrusted content hintRecommendedNot counted

WebMCP consequential 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
