https://cursor.com/llms.txt
Score history · 30 checks
Findings
-
Multiple H1 headings−25
Found 2 extra H1 heading(s). There must be exactly one.
Fix: Keep a single H1 for the project name and demote the others to H2 (##).
-
No blockquote summary−15
A short blockquote (> ...) right after the title gives LLMs essential context.
Fix: Add a one- or two-sentence summary as a blockquote directly below the H1.
-
Sections contain no links−15
Found H2 sections but none contain a markdown link list.
Fix: Populate each section with bullet links: - [Title](https://...): description.
-
Malformed list item(s) (200)−30
Line(s): 5, 6, 7, 8, 9, 10, 11, 12, +192. e.g. "- https://cursor.com/docs.md"; "- https://cursor.com/docs/get-started/quickstart.md"; "- https://cursor.com/docs/models-and-pricing.md"
Fix: Use the format: - [Link text](https://example.com): optional description.
-
Prose inside/after a section (2)−2
Line(s): 262, 269. e.g. "All documentation is available in multiple languages. To access a spec…"; "Available languages: cn, ja, zh-Hant, es, fr, pt-BR, ko, ru, tr, id, d…"
Fix: The spec keeps free prose above the first H2 section; sections should hold link lists.
-
llms-full.txt found
A companion llms-full.txt is also available — great for full-context consumption.
AI discoverability optional · doesn’t affect score
Beyond llms.txt, these companion files help AI tools and search engines understand your site. We only check genuinely adopted ones.
-
✓
robots.txt standard /robots.txt
2 Sitemap directives.
-
✓
sitemap.xml standard /sitemap.xml
Valid XML sitemap.
-
✓
RSS / Atom feed standard /atom.xml
Feed found at /atom.xml — a freshness signal for AI/search.
-
✓
ads.txt standard /ads.txt
245 authorized-seller records (IAB ads.txt).
-
✓
security.txt standard /.well-known/security.txt
Has a Contact field (RFC 9116).
-
✓
ai.txt informational /ai.txt
Present. Note: ai.txt is a non-standard, opt-in-only convention (no neutral spec).
-
✓
A2A agent card emerging /.well-known/agent-card.json
Present but not valid JSON.
-
✓
llms.json emerging /llms.json
Present but is not valid JSON.
-
—
Markdown content negotiation emerging homepage
Suggestion: Optionally serve a Markdown rendering of pages when Accept: text/markdown is requested, so AI agents get clean content.
-
—
Content Signals emerging /robots.txt
Suggestion: Optionally add a Content-Signal directive to robots.txt to declare permitted AI uses (e.g. search=yes, ai-train=no).
-
✓
MCP server card informational /.well-known/mcp.json
Present but not valid JSON.
-
✓
API Catalog emerging /.well-known/api-catalog
Present, but not a valid RFC 9727 linkset (expected an "item" relation listing your APIs).
-
—
OAuth discovery emerging /.well-known/oauth-protected-resource
Suggestion: If agents need authenticated access, add OAuth discovery (/.well-known/oauth-protected-resource, RFC 9728).
-
✓
Structured data (JSON-LD) standard homepage
JSON-LD present, including Organization and WebSite.
-
✓
Open Graph tags standard homepage
Open Graph tags present (controls link previews in AI/social).
-
✓
Twitter Card standard homepage
Twitter Card metadata present.
-
✓
Canonical URL standard homepage
Canonical link present (avoids duplicate-content dilution).
-
✓
hreflang standard homepage
hreflang annotations present (multilingual targeting).
-
—
FAQPage schema standard homepage
Suggestion: If you have Q&A content, add FAQPage JSON-LD so AI answer engines can cite it directly.
-
—
AI file discovery hints emerging homepage
Suggestion: Add <link rel="alternate" href="/llms.txt"> (and llms-full.txt) in <head> so crawlers discover your AI files.
-
—
WebMCP browser tools informational homepage
Optional & experimental. Detects only declarative <form toolname> markup; imperative navigator.modelContext (JS) tools aren't visible to a server-side check.
For brand/identity data, use schema.org Organization JSON-LD embedded in your pages — that’s what knowledge graphs actually read. Files like brand.txt, identity.json or llms.json are vendor inventions with no shared spec, so we don’t check them.
Shareable link: https://llms-txt-validator.dev/r/lvitqhuavqga
Embed your score
Add this badge to your README or site. It updates automatically when the site is re-checked.
Markdown
[](https://llms-txt-validator.dev/report?url=cursor.com)
HTML
<a href="https://llms-txt-validator.dev/report?url=cursor.com"><img src="https://llms-txt-validator.dev/badge/cursor.com.svg" alt="llms.txt score"></a>