---
title: "Hugging Face agent readiness score: 80/100 · Agentrail"
description: "The website is strongest in discovery, with developer resources and a Wikipedia or Wikidata presence, but it missed checks for WebMCP support and content without JavaScript."
canonical: "https://www.agentrail.co/agent-readiness/huggingface.co?h=AGXZASCR0XX6W00E"
---

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

Free to start. No card.

Usability

17 to fix

- MCP parameter schemasRecommendedHow to fix →
- MCP tool listingRecommendedHow to fix →
- auth.md existsEmergingHow to fix →
- auth.md structureEmergingHow to fix →

Fixes unlock with the full report

Where the score comes from

72 of 90 points

How huggingface.co scores on each of the four questions agents ask.

Discovery20/20

Access21/30

Usability31/40

Paymentsnot scored yet

Strongest

### Discovery

Every discovery check passed.

20/20

Most to gain

### Access

Content without JavaScript, llms.txt exists, and 9 more are missing.

21/30

Most to gain

### Usability

MCP parameter schemas, MCP tool listing, and 8 more are missing.

31/40

Not scored yet

### Payments ( bonus )

Counts when scoring opens.

—

Every check

139checks

- Passed**39**
- To fix**21**
- Not in the score**79**

60 checks count toward the score. The other 79 are tracked for later.

Discovery20 of 209 passed

ARD discoveryRequired1 / 1

ARD entry validityRecommended2 / 2

Developer resource discoverabilityRecommended4 / 4

Brand name discoverabilityRequired3 / 3

Wikipedia / Wikidata entity presenceRecommended4 / 4

robots.txt AI crawler policyRequired1 / 1

Listed in MCP registriesRecommended3 / 3

NPM/PyPI SDK packageRecommended1 / 1

Homepage not hidden from searchRecommended1 / 1

\+ 6 checks not in the score

AI Catalog discoveryEmergingNot counted

ARD trust manifestEmergingNot counted

Agent platform configsEmergingNot counted

Agent Plugins manifestEmergingNot counted

Registry brandingEmergingNot counted

ChatGPT app listedRecommendedNot counted

Access21 of 307 to fix4 partly10 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

Markdown content negotiation (acceptmarkdown.com)Recommended0 / 1

Content without JavaScriptRequired1.7 / 5

Metadata completenessRequired0.5 / 1

Trust anchor pagesRequired0.5 / 1

Content behind authRecommended0.5 / 1

Sitemap existsRequired1 / 1

Not blocked by bot detectionRequired2 / 2

robots.txt agent-user policyRequired1 / 1

Pricing info accessibleRequired3 / 3

Public API/docs linked from homepageRequired4 / 4

Redirect hygieneRecommended1 / 1

Page token budgetRecommended1 / 1

OpenAPI spec publishedRequired8 / 8

Developer portalRecommended5 / 5

Agent crawler reachabilityRecommended1 / 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

Usability31 of 404 to fix6 partly20 passed

WebMCP supportRequired0 / 8

Idempotency-Key supportRecommended0 / 3

REST typed error modelRecommended0 / 3

REST async-job patternRecommended0 / 2

MCP parameter schemasRecommended2.9 / 3

MCP tool listingRecommended1.4 / 3

Agent-friendly 404sRecommended1 / 2

API schema complexity analysisRecommended1 / 2

Function calling compatibilityRecommended1 / 2

MCP tool output schemasRecommended1.5 / 3

MCP tool descriptionsRecommended4 / 4

MCP tool namingRecommended2 / 2

Public API with reachable endpointsRequired8 / 8

OAuth 2.0 supportRequired5 / 5

Scoped permissionsRecommended5 / 5

Agent onboarding frictionRecommended2 / 2

OAuth Protected Resource metadata (RFC 9728)Required2 / 2

MCP server / manifestRequired10 / 10

MCP error handlingRecommended2 / 2

MCP modern transportRecommended1 / 1

Rate limit response headersRecommended2 / 2

JSON error responsesRequired3 / 3

REST versioning / deprecation policyRecommended3 / 3

REST pagination patternRecommended2 / 2

CLI tool availableRecommended3 / 3

REST response schema coverageRecommended2 / 2

MCP tool annotationsRecommended3 / 3

Sandbox / test environmentRecommended2 / 2

MCP server instructionsRecommended1 / 1

MCP tools are distinguishableRecommended2 / 2

\+ 49 checks not in the score

MCP server identityRecommendedNot 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

NLWeb /ask endpointEmergingNot counted

NLWeb streaming supportEmergingNot 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 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
