huggingface.co

Journey

· Snapshot & citation

68.7/ 100

C · Needs work

Waymark scored huggingface.co 68.7/100 (C) on 24 Aug 2026.

huggingface.co is blockers remain. Access is the strongest layer, and Discovery is the open one. Next: jSON-LD structured data.

FindMixed
11.1/20
9 of 18 checks passed
DoorMixed
22.9/30
18 of 27 checks passed
ToolsMixed
27.8/40
10 of 16 checks passed
Pay
N/A
No cart or pay rail — out of the denominator.

What should the prompt cover?

24 findings · 22 selected

Failures (19)

Warnings (5)

Group by
1. Can an agent discover and trust you?ROBOTSSITEMAPDISCOVERYSKILLS 74/100

Whether an agent can find this origin from public files and treat it as the real one.

pass
HTTPS reachable 2/2
Evidence. Homepage responded 200 over HTTPS.
Probed homepage.
pass
robots.txt present 2/2
Evidence. Valid robots.txt with User-agent rules.
Probed robots.txt.
pass
XML sitemap 2/2
Evidence. Found sitemap.xml or sitemap index.
pass
Well-known AI catalog 1/1
Evidence. Found /.well-known AI catalog JSON.
Probed well-known paths.
failed
AGENTS.md 0/1
Evidence. agents.md status 404.
Probed public URLs named in the evidence.
Recommended fix. Publish /agents.md with agent-oriented usage notes.
partial
robots.txt AI policy Required 1/2
Evidence. robots.txt present but no named AI crawlers.
Probed robots.txt.
Recommended fix. Name GPTBot, ClaudeBot, Google-Extended, PerplexityBot and state allow or deny.
pass
Sitemap for agents Recommended 2/2
Evidence. Sitemap document fetched.
Probed sitemap.
pass
HTTP Link header bonus 1/1
Evidence. Link: </.well-known/ai-catalog.json>; rel="ai-catalog"; type="application/ai-catalog+json", </.well-known/api-catalog>; rel="api-catalog"
Probed well-known paths.
failed
ai-plugin.json bonus 0/1
Evidence. No /.well-known/ai-plugin.json.
Probed well-known paths.
Recommended fix. Optionally publish a plugin-style capability manifest.
pass
API catalog linkset bonus 2/2
Evidence. api-catalog found.
scanner error
Wikipedia sitelink bonus 0/4
Evidence. Wikidata SPARQL The operation was aborted
Scanner error — not counted as a site fail and not in the score denominator.
scanner error
Wikidata official website bonus 0/3
Evidence. Wikidata SPARQL The operation was aborted
Scanner error — not counted as a site fail and not in the score denominator.
scanner error
Brand official-website match Recommended 0/3
Evidence. Wikidata SPARQL The operation was aborted
Scanner error — not counted as a site fail and not in the score denominator.
pass
Public MCP registry listing bonus 1/1
Evidence. Registry hit at https://registry.modelcontextprotocol.io/v0/servers?search=huggingface.
Probed public URLs named in the evidence.
failed
Package homepage match bonus 0/1
Evidence. No npm package homepage matching huggingface.co.
Probed homepage.
Recommended fix. Publish an official package whose homepage is this domain.
failed
Sitemap lastmod bonus 0/1
Evidence. Sitemap without lastmod.
Recommended fix. Add lastmod dates to sitemap entries.
n/a
related-website-set bonus 0/1
Evidence. No related-website-set (N/A unless multi-origin).
n/a
ads.txt bonus 0/1
Evidence. No ads inventory (N/A).
2. Do you welcome agents?ROBOTSCRAWLBOT AUTH 88/100

Whether crawlers and signed bots are allowed through rather than blocked at the door.

pass
AI crawlers not blanket-blocked 2/2
Evidence. No blanket Disallow: / for common AI bots.
n/a
robots Crawl-delay bonus 0/1
Evidence. No Crawl-delay (optional).
n/a
Web Bot Auth keys Recommended 0/2
Evidence. No http-message-signatures-directory.
partial
CORS / API hint 0.5/1
Evidence. No CORS header or obvious API path.
Recommended fix. If you expose an API, send Access-Control-Allow-Origin for intended clients.
pass
CSP or X-Frame-Options 1/1
Evidence. CSP or X-Frame-Options present.
3. Does an agent understand who you are and what you do?HTMLJSON-LDLLMS.TXTSKILLSDOCSNLWEB 34/100

Whether the site explains the product in language a model can ingest.

pass
Title and description 2/2
Evidence. Title and meta description present.
failed
JSON-LD structured data 0/4
Evidence. No JSON-LD on the homepage.
Probed homepage.
Recommended fix. Add JSON-LD (Organization, WebSite, or SoftwareApplication).
failed
html lang attribute 0/1
Evidence. Missing lang on <html>.
Recommended fix. Set <html lang="en"> (or the correct language).
failed
JSON-LD entities Recommended 0/4
Evidence. No JSON-LD.
Recommended fix. Embed Organization, Product, Offer, SoftwareApplication, or FAQPage.
n/a
JSON-LD sameAs bonus 0/2
Evidence. No JSON-LD.
pass
Open Graph basics bonus 2/2
Evidence. Open Graph plus canonical.
failed
llms.txt 0/2
Evidence. llms.txt status 404.
Probed public URLs named in the evidence.
Recommended fix. Add /llms.txt describing the site for language models. Verify: curl -sI https://huggingface.co/llms.txt
failed
llms.txt index Recommended 0/2
Evidence. Missing /llms.txt.
Recommended fix. Add a markdown index at /llms.txt. Verify: curl -sI https://huggingface.co/llms.txt
failed
llms.txt size and links Recommended 0/2
Evidence. No llms.txt to score.
Recommended fix. Keep /llms.txt over ~200 characters with absolute URLs to docs.
failed
llms-full.txt bonus 0/1
Evidence. llms-full.txt status 404.
Probed public URLs named in the evidence.
Recommended fix. Optionally publish /llms-full.txt for one-shot ingest.
n/a
Section llms.txt bonus 0/1
Evidence. No /docs/llms.txt.
n/a
NLWeb schemamap bonus 0/1
Evidence. No schemamap (N/A unless you offer NL search).
pass
Trust pages Recommended 2/2
Evidence. Trust links found.
n/a
Speakable markup bonus 0/1
Evidence. No SpeakableSpecification (N/A unless voice content).
n/a
humans.txt bonus 0/1
Evidence. No /humans.txt (optional).
pass
security.txt Recommended 1/1
Evidence. RFC 9116 security.txt with Contact.
pass
RSS or Atom feed 1/1
Evidence. Feed link detected.
partial
RSS or Atom document bonus 0.5/1
Evidence. No /feed or /rss.xml document.
Recommended fix. Publish /rss.xml or /atom.xml.
4. Can an agent integrate with you?LINKSSKILLSDOCSAPIOPSMCPSDK 75/100

Whether there is a documented machine door into the product.

failed
OpenAPI / Swagger link 0/2
Evidence. No OpenAPI/Swagger link in HTML.
Probed OpenAPI.
Recommended fix. Link to an OpenAPI or Swagger document from the homepage.
pass
Login or docs link 3/3
Evidence. Login or developer docs link found.
failed
MCP well-known card 0/2
Evidence. MCP mentioned without a well-known card.
Probed well-known paths.
Recommended fix. Publish /.well-known/mcp.json describing your MCP server.
pass
MCP SSE / HTTP hint 1/1
Evidence. Page mentions MCP or SSE transport.
n/a
openapi.json fetchable 0/0
Evidence. Fetched OpenAPI or Swagger document.
Probed OpenAPI.
failed
Webhook or API docs 0/2
Evidence. No webhook/API docs mention.
Recommended fix. Document webhooks and REST/RPC APIs for agents.
pass
Agent skills index 2/2
Evidence. Skills index or mention found.
pass
OpenAPI document Required 5/7
Evidence. OpenAPI probe.
Probed OpenAPI.
pass
Public API surface Recommended 7/7
Evidence. Docs or API paths look callable.
pass
Developer portal Recommended 6/6
Evidence. Developer hub found.
pass
MCP server Recommended 6/6
Evidence. MCP probe.
partial
MCP server card Recommended 1/2
Evidence. MCP mentioned without a card.
Recommended fix. Publish /.well-known/mcp.json or mcp/server-card.json.
pass
Agent Skills files bonus 2/2
Evidence. Skills file or index found.
failed
CLI tool Recommended 0/3
Evidence. No CLI mention.
Recommended fix. Publish an official CLI.
pass
GraphQL GET hint bonus 2/2
Evidence. GraphQL GET or docs mention.
pass
OpenAPI UI page bonus 1/1
Evidence. Swagger UI or Redoc page found.
n/a
OpenAPI (legacy slot) 0/0
Evidence. OpenAPI/Swagger fetched.
Probed OpenAPI.
5. Is your integration well-built?APIMCP 50/100

Whether the integration surface is complete enough to call with confidence.

n/a
MCP initialize Required 0/3
Evidence. initialize HTTP 200 at https://huggingface.co/mcp
Probed public URLs named in the evidence.
partial
MCP server card Recommended 1/2
Evidence. MCP mentioned without a card.
Recommended fix. Publish /.well-known/mcp.json or mcp/server-card.json.
6. Can an agent use you reliably in production?MCPAPIOPS 82/100

Whether errors, idempotency, and limits are visible before a call fails.

pass
Rate limit signal Recommended 2/2
Evidence. Rate-limit or retry signal found.
partial
Idempotency signal Recommended 1/3
Evidence. API surface without idempotency notes.
Recommended fix. Document idempotency keys for mutating calls.
pass
Machine-readable errors Recommended 4/4
Evidence. JSON/problem error shape found.
pass
Honest 404 Recommended 2/2
Evidence. 404/410 on probe path.
7. Can an agent authenticate to you?SDKOAUTHAUTH.MDMCP 95/100

Whether an agent can obtain access without a human in the loop.

pass
OAuth / OIDC well-known 2/2
Evidence. OAuth or OIDC discovery document found.
pass
OAuth 2.0 surface Required 5/5
Evidence. Authorization or token endpoint in discovery.
pass
OAuth AS metadata Required 3/3
Evidence. AS or OIDC metadata document fetched.
Probed public URLs named in the evidence.
pass
PKCE S256 Required 2/2
Evidence. S256 listed in code_challenge_methods_supported.
pass
OAuth protected resource Recommended 2/2
Evidence. oauth-protected-resource found.
pass
Scoped permissions Recommended 5/5
Evidence. Named scopes found.
n/a
auth.md bonus 0/2
Evidence. No /auth.md (optional).
failed
change-password well-known bonus 0/1
Evidence. Login surface without /.well-known/change-password.
Probed well-known paths.
Recommended fix. If users have passwords, serve /.well-known/change-password.
8. Can an agent transact with you?PRICINGX402MPPUCPACPAP2 100/100

Whether an agent can price, pay, or check out on a documented rail.

n/a
x402 payment bonus 0/0
Evidence. No cart/SKU/checkout and no live payment rail (Pay N/A).
n/a
Agentic checkout (ACP) bonus 0/0
Evidence. No cart/SKU/checkout and no live payment rail (Pay N/A).
n/a
ACP delegated payment bonus 0/0
Evidence. No cart/SKU/checkout and no live payment rail (Pay N/A).
n/a
Universal Commerce Protocol bonus 0/0
Evidence. No cart/SKU/checkout and no live payment rail (Pay N/A).
n/a
Machine Payments Protocol bonus 0/0
Evidence. No cart/SKU/checkout and no live payment rail (Pay N/A).
pass
Pricing page Recommended 3/3
Evidence. Fetched /pricing.
Probed public URLs named in the evidence.
n/a
pricing.md bonus 0/2
Evidence. No /pricing.md (optional).
9. Can a user act through an agent?APPS 0/100

Whether a person can finish a job through an agent-facing UI.

failed
MCP Apps UI hint bonus 0/1
Evidence. No MCP Apps hint (N/A unless you return UI).
Recommended fix. If you return UI, declare io.modelcontextprotocol/ui resources.
n/a
A2A agent card Required 0/2
Evidence. No agent-card.json (N/A unless A2A).
n/a
Web app manifest bonus 0/1
Evidence. No web app manifest (N/A).
10. Can an agent operate your website directly?MARKDOWNA11YHTMLWEBMCPNLWEBLLMS.TXT 50/100

Whether an agent can read and operate the site itself when there is no API or MCP.

failed
Markdown negotiation bonus 0/1
Evidence. Homepage did not negotiate markdown.
Probed homepage.
Recommended fix. Respond to Accept: text/markdown with a markdown body.
failed
/index.md fallback bonus 0/1
Evidence. index.md status 404.
Probed public URLs named in the evidence.
Recommended fix. Serve a markdown homepage at /index.md.
n/a
WebMCP page tools bonus 0/1
Evidence. No in-page WebMCP (N/A).
pass
NLWeb /ask bonus 1/1
Evidence. NLWeb or /ask signal.
pass
Agent mode view bonus 1/1
Evidence. mode=agent responded.
Probed public URLs named in the evidence.
n/a
NodeInfo bonus 0/1
Evidence. No nodeinfo (N/A).
n/a
oEmbed discovery bonus 0/1
Evidence. No oEmbed (N/A unless embeddable).

About this snapshot & how to cite it

Public technical signals observed by Waymark. A score describes this snapshot; it does not guarantee that an agent will complete a task. Private and authenticated workflows are outside this scan.

Snapshot: . Cite the domain, score, scan time, and report URL. This URL serves the latest completed snapshot and can change after a rescan.

Methodology and limits · Markdown · JSON evidence

Scanner issues (not site fails): , , .

Share this snapshot

Embed the latest score. A badge is a public snapshot, not a certification.

Waymark score badge for huggingface.co
Open badge SVG ↗

Also on the Board

Same-category snapshots, ordered by score. Scan times may differ.

Email me if this score changes

Join the monitoring waitlist. Monitoring is not active yet. This saves your interest; it does not schedule scans or send change alerts.

By joining, you agree to save your email and this domain for monitoring launch contact, for up to 180 days. Request removal via Contact. No billing.

Email this report

Send the current snapshot and a link. One email. Not a list.

We'll send huggingface.co as it stands on this page.