Scan Results: https://www.mintlify.com/docs

ID: 8bad3d3b-5239-424e-8bc9-f7dad1f4f162

41/100
Agent Readiness Score

AI-Friendly Docs

Parseable by AI models but has high token usage or lacks standard machine-readable hooks.

Category Breakdown

Context Optimization11 / 30
Code Block Execution10 / 30
Machine Readability0 / 20
Agent Tooling & MCP20 / 20

Detailed Findings

Context Optimization

11/30

llms.txt Auto-Discovery

↳ AI Agent Fix Prompt
Create an llms.txt file at the root of my documentation site.
Place it at: [domain]/llms.txt

Structure it exactly as follows:
Line 1: # [Product Name]
Line 2: Blank line
Line 3: One paragraph summary of what the product does and who it's for.
Line 4: Blank line
Line 5: ## Technical Constraints
- Rate limits
- Authentication requirements
- SDK language support
- Known limitations
Line 6: Blank line
Line 7: ## Key Documentation
- [URL]: [one-line description] (repeat for top 10 most important pages)

My docs are at: [URL]
My product does: [brief description]

llms-full.txt Consolidated Docs

↳ AI Agent Fix Prompt
Create an llms-full.txt file at the root of my documentation site.
This should contain the entire documentation merged into a single Markdown file.

Markdown Content Negotiation (Accept: text/markdown)

DOM Cleanliness Ratio (1% markdown/HTML)

↳ AI Agent Fix Prompt
Reduce layout boilerplate (header, footers, scripts) or use Markdown Content Negotiation to strip DOM noise.
🔧

Code Block Execution

10/30

This category was analyzed using structural heuristics. Results reflect your documentation's observable patterns.

Terminal Prompt Pollution (No "$" prefixes in copyable code)

Dependency & Import Completeness

↳ AI Agent Fix Prompt
No code blocks found to analyze.

Dynamic Variable Placeholders

↳ AI Agent Fix Prompt
No code blocks found to analyze.
🔍

Machine Readability

0/20

OpenAPI/Swagger Spec Auto-Discovery

↳ AI Agent Fix Prompt
Expose an OpenAPI or Swagger specification at a standard path (e.g. /openapi.json) or link to it using the "Link" HTTP response header with rel="openapi".

JSON-LD Structured Schema (TechArticle / APIReference / Guide)

↳ AI Agent Fix Prompt
Embed a <script type="application/ld+json"> block classifying your docs as a TechArticle, Guide, or APIReference, containing semantically enriched metadata.
🤖

Agent Tooling & MCP

20/20

Model Context Protocol (MCP) Server Integration

Error Code Diagnostics & Cross-Referencing Index

All checks passed — this category is agent-ready.