Agent MCP Directory

Hugging Face: the 360 agent-readiness check

Hugging Face scores 82 of 100 on Ora's agent-readiness scan, a B, read 9 November 2026. Of the five surfaces an agent acts on, Ora found 5: an MCP server, an OpenAPI specification, a public API, OAuth, a command line. A perfect Discovery layer and 25 skills, with no llms.txt and no JSON-LD.

On 9 November 2026 the public site at huggingface.co scored 82 of 100 on Ora's agent-readiness scan, a B, in Ora's AI & ML category. Ora probes a site the way an agent would: it requests pages with the agents' own user agents, reads robots.txt, looks for the files agents read, and tries the API, MCP and payment surfaces. This check reads the act layer first, because that is what the directory records, then the door, what an agent can read, and whether the company is found and recommended. Ora's one-line summary: Hugging Face excels at model discovery and access through comprehensive registries, but lacks WebMCP support for agent integration.

The score

Hugging Face on Ora, read 2026-11-09: points per layer, with the share of each layer's maximum. 58 checks pass, 9 are partial, 35 fail and 30 do not apply to this site.
LayerAsksPointsShare
UsabilityCan agents use it85 of 10879%
AccessCan agents read it46 of 6175%
DiscoveryCan agents find and recommend it21 of 21100%
PaymentsCan agents pay0 of 0none apply
TotalGrade B82 of 10082%

What an agent can do

The surfaces an agent acts on: an API it can find and call, an MCP server, an agent card, OAuth metadata, a command line. This is the layer the directory records, so it comes first.

In the directory, Hugging Face has an open MCP server with tools listed at https://huggingface.co/mcp, 4 tools listed, no authentication; the connector run of 4 November 2026 is on the entry page. Ora's MCP server check for the same domain reads pass; the two look for different things, the directory for a server that answers a handshake and lists tools, Ora for a server it can find from the site.

What an agent can do: 19 checks Ora ran on huggingface.co, read 2026-11-09. The last column is Ora's own observation where it published one.
CheckResultPointsWhat Ora saw
MCP server / manifest mcp-serverPass6 of 6MCP server connected via Streamable HTTP - huggingface.co/mcp v0.4.31 (protocol 2025-11-25; extensions: io.modelcontextprotocol/skills)
MCP well-known discovery mcp-well-known-discoveryPass2 of 2MCP server card listed in /.well-known/ai-catalog.json
Public API with reachable endpoints public-apiPass7 of 7Documented REST API detected; endpoints require authentication (API key / OAuth), which is expected for agent access. Best-of-protocols score: 7/7.
Public API/docs linked from homepage public-api-docsPass3 of 3API/docs link found on homepage and resolves: /docs
Developer portal developer-portalPass6 of 6Developer portal found at /developers
OpenAPI spec published openapi-specPass7 of 7OpenAPI spec found at https://huggingface.co/.well-known/openapi.json (version: 3.1.0)
API catalog (RFC 9727) api-catalog-rfc9727Pass2 of 2no detail published
A2A / agent-card a2a-agent-cardFail0 of 2No A2A agent card found at /.well-known/agent-card.json
Agent discovery file agent-discovery-filePass2 of 2Agent Skills index (agentskills.io) found at /.well-known/agent-skills/index.json with 25 skill(s)
OAuth 2.0 support oauth-supportPass5 of 5OpenID Connect discovery endpoint found at https://huggingface.co
OAuth Protected Resource metadata (RFC 9728) oauth-protected-resourcePass2 of 2no detail published
auth.md exists auth-md-existsFail0 of 2No /auth.md found at site root
WebMCP support webmcpFail0 of 5No WebMCP support detected - no document.modelContext / navigator.modelContext usage found (scanned 1 of 1 same-origin script bundle(s) for modelContext registrations)
NLWeb /ask endpoint nlweb-askFail0 of 1No NLWeb-conformant /ask endpoint found via GET or POST
CLI tool available cli-toolPass3 of 3CLI package found on npm: @huggingface/hub
Multi-language SDK packages rest-sdk-packagesPartial2 of 3SDK packages found in npm, pypi
Rate limit response headers rate-limit-headersPass2 of 2no detail published
Idempotency-Key support idempotency-key-supportFail0 of 3No REST Idempotency-Key support detected
JSON error responses json-error-responsesPass4 of 4no detail published

At the door

What the site answers when a request arrives with an agent's user agent, and what robots.txt says to agents.

At the door: 8 checks Ora ran on huggingface.co, read 2026-11-09. The last column is Ora's own observation where it published one.
CheckResultPointsWhat Ora saw
Not blocked by bot detection bot-detectionPass2 of 2Site accessible to 4 agent user-agents (ChatGPT-User, OAI-SearchBot, Claude-User, PerplexityBot).
Agent crawler reachability agent-crawler-reachabilityPass2 of 2Reachable to every agent we tested - ChatGPT-User: reachable, OAI-SearchBot: reachable, Claude-User: reachable, PerplexityBot: reachable
robots.txt AI crawler policy robots-ai-policy-qualityPass2 of 2AI search crawlers: allowed in 18 of 18 checks (3 crawlers on 6 pages). AI training crawlers: allowed in 12 of 12 checks (2 crawlers on 6 pages), not scored.
robots.txt agent-user policy robots-agent-user-policyPass2 of 2No applicable crawl or usage restriction found for 3 user-triggered agents (chatgpt-user, claude-user, perplexity-user) on 1 public page: https://huggingface.co/. Declared policy only;
Content behind auth docs-auth-gatePass2 of 2All 5 sampled pages are publicly readable (5 with substantive content)
Homepage not hidden from search noindex-directivesPass1 of 1No noindex on the homepage: no robots, googlebot or bingbot meta tag and no X-Robots-Tag header hides it from search.
Redirect hygiene redirect-hygienePass1 of 1no detail published
Web Bot Auth directory web-bot-auth-directoryFail0 of 2No /.well-known/http-message-signatures-directory found

What an agent can read

Whether the text is in the first response, what the site publishes for agents, and how it describes itself to them. One check in this group does not apply to this site and is left out.

What an agent can read: 16 checks Ora ran on huggingface.co, read 2026-11-09. The last column is Ora's own observation where it published one.
CheckResultPointsWhat Ora saw
Content without JavaScript content-no-jsPartial2 of 33470 chars with H1, but heading hierarchy skips H2 to H4; 3.3% content ratio is below the 5% target
Page token budget page-token-budgetPass1 of 1All 6 measured pages fit an agent context budget (largest ~3K tokens)
Sitemap exists sitemapPass2 of 2Valid sitemap found at https://huggingface.co/sitemap.xml with multiple sitemaps entries
Sitemap freshness (lastmod) sitemap-lastmodFail0 of 1None of the 10 sampled sitemap entries carries a lastmod date. Add <lastmod> (W3C datetime) so agents can prioritize fresh content.
llms.txt exists llms-txt-existsFail0 of 1No llms.txt found at /llms.txt or /.well-known/llms.txt.
llms.txt formatting llms-txt-formattingFail0 of 2No llms.txt found to evaluate quality
Markdown agent docs markdown-negotiationFail0 of 1Missing markdown content negotiation. Homepage returned text/html when probed with Accept: text/markdown (expected text/markdown), and none of the well-known root paths (/llms.md, /auth.md, /agents.md, /developers.md,
Markdown URL fallback markdown-url-fallbackFail0 of 2Homepage does not support the .md suffix. Probed https://huggingface.co/index.md and it did not return markdown (expected text/markdown content-type or a heading-led non-HTML body).
Bot-UA markdown serving agent-ua-markdownFail0 of 1No probed bot User-Agent (ChatGPT-User, Claude-User, Perplexity-User) receives markdown when requesting HTML. Optional: detect AI-bot UAs server-side and serve them a markdown representation directly.
Agent mode view agent-mode-viewFail0 of 2?mode=agent returns same content as homepage (no dedicated agent view)
JSON-LD structured data json-ldFail0 of 4No JSON-LD structured data found on homepage
Organization schema completeness org-schema-completenessFail0 of 2No JSON-LD found - Organization schema missing
JSON-LD entity linking (sameAs) json-ld-entity-linkingFail0 of 2No JSON-LD found - no entity linking possible
Schema type breadth schema-type-breadthFail0 of 2No extended schema types found - AI can only answer basic questions about this entity
Metadata completeness metadata-completenessPartial1 of 23/4 metadata signals present - missing: HTML lang attribute
Agent instruction / when-to-use agent-instructionPass3 of 3no detail published

Found and recommended

Whether an assistant can find the company by name, confirm what it is, and see it in the registries agents read.

Found and recommended: 9 checks Ora ran on huggingface.co, read 2026-11-09. The last column is Ora's own observation where it published one.
CheckResultPointsWhat Ora saw
Brand name discoverability brand-search-accuracyPass3 of 3huggingface.co ranks #3 for "Hugging Face ML collaboration platform"
Wikipedia / Wikidata entity presence wikipedia-presencePass4 of 4Wikipedia "Hugging Face" and Wikidata Q108943604 both verified - domain confirmed on both sources
Developer resource discoverability agentic-search-specificPass3 of 3no detail published
Listed in MCP registries mcp-registry-listedPass1 of 1no detail published
NPM/PyPI SDK package npm-sdk-packagePass1 of 1no detail published
ChatGPT app listed chatgpt-app-listedPass2 of 2no detail published
Registry branding registry-brandingFail0 of 2No registry branding (name, icon, description) found
Listed on skills.sh skills-sh-listedPass1 of 1no detail published
ARD discovery ard-catalogPass1 of 1no detail published

Payments

The agent payment protocols Ora probes for. A site that sells nothing has nothing here, and Ora scores the layer out of zero when none applies. None of the 6 payment checks applied to huggingface.co.

The fixes worth most points

Ora attaches an estimate to each failing or partial check: how many points the site would gain by passing it. These are the 5 with the largest estimates for Hugging Face, with what Ora observed. The wording of each fix is Ora's; the 28 checks it runs on an MCP server are listed with their layer and tier.

  • JSON-LD structured data: fail, 0 of 4, about 2.2 points to gain. Ora saw: No JSON-LD structured data found on homepage
  • WebMCP support: fail, 0 of 5, about 2.1 points to gain. Ora saw: No WebMCP support detected - no document.modelContext / navigator.modelContext usage found (scanned 1 of 1 same-origin script bundle(s) for modelContext registrations)
  • MCP Apps support: fail, 0 of 4, about 1.6 points to gain. Ora saw: No MCP Apps support detected - this product has an in-agent UI surface but exposes no ui:// resources or tool UI metadata for agents to render.
  • REST typed error model: fail, 0 of 3, about 1.2 points to gain. Ora saw: No typed error model found in OpenAPI spec
  • Idempotency-Key support: fail, 0 of 3, about 1.2 points to gain. Ora saw: No REST Idempotency-Key support detected

Our read

Hugging Face has a perfect Discovery layer, 21 of 21, and an act layer that passes the hard rows: a live MCP handshake with huggingface.co/mcp version 0.4.31 over Streamable HTTP, the server card listed in /.well-known/ai-catalog.json, an OpenAPI 3.1.0 specification at /.well-known/openapi.json, OpenID Connect discovery on the main domain, @huggingface/hub on npm, SDKs in npm and PyPI, and an agent skills index with 25 skills. What it misses is the plain text layer: no llms.txt at either location and no JSON-LD on the home page, which together are about 5 points, plus a heading tree that skips from H2 to H4 at a 3.3 percent text ratio. The specification has no typed error model and REST has no Idempotency-Key. The single script bundle registers no WebMCP tool. For the registry where most of the world's open models live, the two missing files are an afternoon's work.

Test your own surfaces

The scan above is free and needs no account: enter a domain at ora.ai and read the same four layers for your own site. For an MCP server, Ora scans the server URL itself and runs 28 of its 132 public checks on it, which is why it is the check this directory recommends; the reasons, the limits and the alternatives are on their own page. The command below runs the same audit from a terminal and exits with 1 under the score you set, so it can gate a deploy.

npx ax@0.10 audit https://example.com --min-score 70

All 360 checks, one company a day. Corrections to the corrections page.