---
title: "Sourcegraph agent readiness score: 53/100 · Agentrail"
description: "The site’s strengths are agent discovery, developer resource discoverability, and Wikipedia or Wikidata entity presence, but it missed checks for a published OpenAPI specification and WebMCP support."
canonical: "https://www.agentrail.co/agent-readiness/sourcegraph.com?h=1NZTR8TSTW4Q500F"
---

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

Free to start. No card.

Access

25 to fix

- Content without JavaScriptRequiredHow to fix →
- Not blocked by bot detectionRequiredHow to fix →
- Agent discovery fileEmergingHow to fix →
- A2A / agent-cardEmergingHow to fix →

Fixes unlock with the full report

Where the score comes from

48 of 90 points

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

Discovery19/20

Access11/30

Usability18/40

Paymentsnot scored yet

Strongest

### Discovery

ARD discovery is missing.

19/20

Most to gain

### Usability

Scoped permissions, Agent onboarding friction, and 9 more are missing.

18/40

Most to gain

### Access

Content without JavaScript, Not blocked by bot detection, and 11 more are missing.

11/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 sourcegraph.comand recorded every request it made.

**S**sourcegraph.comAnsweredRan Nov 20, 2026

Question

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

7

Steps

1m 48s

Duration

6

Pages opened

0

Failed

Every address the agent typed itself loaded. Every link it followed loaded.

1. 1sourcegraph.com /Named in the question _→_ **Read**
2. 2/docsA link on a page it read _→_ **Read**
3. 3/docs/getting-startedA link on a page it read _→_ **Read**
4. 4/docs/adminA link on a page it read _→_ **Read**
5. 5/docs/adminA link on a page it read _→_ **Read again**
6. 6/docs/admin/how-to/site-admin-quickstartA link on a page it read _→_ **Read**
7. 7/docs/admin/deployTyped by the agent _→_ **Read**

7/7 steps

StepsHow it found itCame back as

Step 7 of 7

`sourcegraph.com/docs/admin/deploy`

How it got here

Typed by the agent

Response

307 → 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**5**

Typed by the agent**1**

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

Free to start. No card.

Every check

139checks

- Passed**18**
- To fix**25**
- Not in the score**96**

43 checks count toward the score. The other 96 are tracked for later.

Discovery19 of 201 to fix6 passed

ARD discoveryRequired0 / 1

Developer resource discoverabilityRecommended4 / 4

Brand name discoverabilityRequired3 / 3

Wikipedia / Wikidata entity presenceRecommended4 / 4

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

Access11 of 309 to fix4 partly8 passed

llms.txt existsRequired0 / 1

llms.txt formattingRecommended0 / 2

JSON-LD structured dataRequired0 / 2

Agent instruction / when-to-useRequired0 / 1

JSON-LD entity linking (sameAs)Recommended0 / 1

Organization schema completenessRecommended0 / 1

OpenAPI spec publishedRequired0 / 8

Developer portalRecommended0 / 5

Markdown content negotiation (acceptmarkdown.com)Recommended0 / 1

Content without JavaScriptRequired1.7 / 5

Not blocked by bot detectionRequired1 / 2

Trust anchor pagesRequired0.5 / 1

Agent crawler reachabilityRecommended0 / 1

Sitemap existsRequired1 / 1

robots.txt agent-user policyRequired1 / 1

Pricing info accessibleRequired3 / 3

Public API/docs linked from homepageRequired4 / 4

Metadata completenessRequired1 / 1

Redirect hygieneRecommended1 / 1

Page token budgetRecommended1 / 1

Content behind authRecommended1 / 1

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

llms.txt links resolveRecommendedNot 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

Usability18 of 409 to fix2 partly4 passed

Scoped permissionsRecommended0 / 5

Agent onboarding frictionRecommended0 / 2

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

MCP server / manifestRequired8.3 / 10

Agent-friendly 404sRecommended1 / 2

Public API with reachable endpointsRequired8 / 8

OAuth 2.0 supportRequired5 / 5

OAuth Protected Resource metadata (RFC 9728)Required2 / 2

CLI tool availableRecommended3 / 3

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

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

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
