Export Report
OVERALL SCORE
Level 3, Bot-Aware
- AI Discoverability 24 out of 100
- Agent Ease of Use 18 out of 100
- Security & Trust 40 out of 100
- GEO, AIO and AEO 66 out of 100
- SEO 100 out of 100
- Performance and Accessibility 85 out of 100
What AI sees of your website
Mintlify - The Intelligent Knowledge Platform
Meet the next generation of documentation. AI-native, beautiful out-of-the-box, and built for developers.
Next step
Turn this report into a fix workflow
26 failed checks are ready to move into MCP or CLI remediation. Generate a repair prompt, connect the scanner to your coding agent, or open the integration docs before your next rescan.
| Metric | Score | Status | Passed | Failed | Warning | Evidence |
|---|---|---|---|---|---|---|
| AI Discoverability | 24 | Priority fix | 5 | 18 | 0 | View details |
| Discoverability | 33 | Priority fix | 3 | 6 | 0 | View details |
| Content Readiness | 33 | Priority fix | 2 | 8 | 0 | View details |
| Bot Access Control | 0 | Priority fix | 0 | 4 | 0 | View details |
| Agent Ease of Use | 18 | Priority fix | 12 | 20 | 4 | View details |
| API | 42 | Priority fix | 2 | 4 | 2 | View details |
| Auth | Not Applicable | Not Applicable | 6 | 2 | 0 | View details |
| MCP | 13 | Priority fix | 0 | 6 | 2 | View details |
| Skill Discovery | 0 | Priority fix | 0 | 8 | 0 | View details |
| Agent Commerce | Not Applicable | Not Applicable | 4 | 0 | 0 | |
| GEO, AIO and AEO | 66 | Needs work | 5 | 3 | 11 | View details |
| GEO Readiness | 74 | Needs work | 1 | 0 | 4 | |
| AIO Readiness | 61 | Needs work | 3 | 2 | 2 | View details |
| AEO Readiness | 61 | Needs work | 1 | 1 | 5 | View details |
| SEO | 100 | Strong | 11 | 0 | 0 | |
| SEO | 100 | Strong | 11 | 0 | 0 | |
| Security & Trust | 40 | Priority fix | 6 | 3 | 0 | View details |
| Security & Trust | 40 | Priority fix | 2 | 3 | 0 | View details |
| AI Training Exposure | Not Applicable | Not Applicable | 4 | 0 | 0 | |
| Performance and Accessibility | 85 | Mostly ready | 19 | 7 | 1 | View details |
| Performance | 81 | Mostly ready | 13 | 7 | 1 | View details |
| Accessibility | 91 | Strong | 6 | 0 | 0 |
Prioritized recommendations
Issues ranked by score impact
51 items need attention
Agent Ease of UseAPIEstablished
API Catalog
API Catalog failed at "Fetch API catalog".
50 Fail
Agent Ease of UseAPIEstablished
API Catalog
API Catalog failed at "Fetch API catalog".
Needs attention
API Catalog
Issue
The API catalog endpoint did not return HTTP 2xx.
Why it matters
API catalogs help agents find service descriptions, documentation, and status resources without guessing API entry points.
Check name
API Catalog
Score
0/100
Status
fail
Category
API
Maturity
Established
Goal
Publish an API catalog for automated API discovery using RFC 9727.
Result
API Catalog failed at "Fetch API catalog".
Validation steps
Fetch API catalog
The API catalog endpoint did not return HTTP 2xx.
Validate RFC 9727 linkset
Response is not valid JSON.
Fetch advertised API catalog targets
API Catalog did not expose any same-origin hrefs to validate.
Evidence
{
"failedStep": "fetch",
"steps": [
{
"id": "fetch",
"title": "Fetch API catalog",
"status": "fail",
"evidence": {
"statusCode": 404,
"contentType": "text/html; charset=utf-8"
},
"issue": "The API catalog endpoint did not return HTTP 2xx.",
"howToFix": "Publish /.well-known/api-catalog."
},
{
"id": "validate",
"title": "Validate RFC 9727 linkset",
"status": "fail",
"evidence": {
"valid": false,
"compatibleContentType": false,
"issue": "Response is not valid JSON.",
"rawExcerpt": "<!DOCTYPE html><html lang=\"en\"><head><meta charSet=\"utf-8\"/><meta name=\"viewport\" content=\"width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no\"/><link rel=\"stylesheet\" href=\"/_next/static/chunks/9d00b394ea8ef152.css\" data-precedence=\"next\"/><link rel=\"stylesheet\" href=\"/_next/static/chunks/22bbd7177ad0897a.css\" data-precedence=\"next\"/><link rel=\"preload\" as=\"script\" fetchPriority=\"low\" href=\"/_next/static/chunks/18a2e4e579dcff01.js\"/><script src=\"/_next/static/chunks/b8e0f968daefc144.js\" async=\"\"></script><script src=\"/_next/static/chunks/54afae82ba38f00b.js\" async=\"\"></script><script src=\"/_next/static/chunks/df749965d2748117.js\" async=\"\"></script><script src=\"/_next/static/chunks/turbopack-07c6cd18568147f6.js\" async=\"\"></script><script src=\"/_next/stat"
},
"issue": "Response is not valid JSON.",
"howToFix": "Use application/linkset+json with service-desc, service-doc, and status relations that each include href."
},
{
"id": "target-validation",
"title": "Fetch advertised API catalog targets",
"status": "fail",
"evidence": {
"checked": [],
"failures": [
{
"reason": "No same-origin API catalog hrefs were available to fetch."
}
]
},
"issue": "API Catalog did not expose any same-origin hrefs to validate.",
"howToFix": "Make each same-origin API catalog href reachable and serve the advertised media type."
}
]
}AI DiscoverabilityBot Access ControlEstablished
AI bot rules in robots.txt
AI bot rules in robots.txt is missing or incomplete.
33 Fail
AI DiscoverabilityBot Access ControlEstablished
AI bot rules in robots.txt
AI bot rules in robots.txt is missing or incomplete.
Needs attention
AI bot rules in robots.txt
Issue
No specific User-agent rules found for major AI crawlers (GPTBot, ClaudeBot, etc.) in robots.txt.
Why it matters
Explicit AI bot rules reduce ambiguity for crawler operators and make training, indexing, or retrieval access policy auditable.
Check name
AI bot rules in robots.txt
Score
0/100
Status
fail
Category
Bot Access Control
Maturity
Established
Goal
Add User-agent rules for AI crawlers like GPTBot, Claude-Web, and others.
Result
AI bot rules in robots.txt is missing or incomplete.
Evidence
{
"expectedBots": [
"GPTBot",
"ChatGPT-User",
"ClaudeBot",
"Claude-Web",
"Anthropic-AI",
"Google-Extended",
"PerplexityBot",
"CCBot",
"Applebot-Extended",
"Meta-ExternalAgent",
"Bytespider",
"Amazonbot",
"Cohere-AI"
],
"configuredBots": []
}AI DiscoverabilityBot Access ControlInformational
Content Signal
Content Signal is missing or incomplete.
33 Fail
AI DiscoverabilityBot Access ControlInformational
Content Signal
Content Signal is missing or incomplete.
Needs attention
Content Signal
Issue
No Content Signal found in robots.txt
Why it matters
Content Signal provides a machine-readable way to communicate AI usage preferences where participating crawlers look for policy.
Check name
Content Signal
Score
0/100
Status
fail
Category
Bot Access Control
Maturity
Informational
Goal
Declare AI content usage preferences with Content Signal in robots.txt.
Result
Content Signal is missing or incomplete.
Evidence
{
"signals": [],
"ai-train": false,
"search": false,
"ai-input": false
}Security & TrustSecurity & TrustEstablished
Content-Security-Policy
Content-Security-Policy is missing or incomplete.
33 Fail
Security & TrustSecurity & TrustEstablished
Content-Security-Policy
Content-Security-Policy is missing or incomplete.
Needs attention
Content-Security-Policy
Issue
Content-Security-Policy is missing or incomplete.
Why it matters
Content Security Policy limits where scripts, styles, frames, and connections can load from, reducing the impact of injection bugs.
Check name
Content-Security-Policy
Score
0/100
Status
fail
Category
Security & Trust
Maturity
Established
Goal
Constrain script, style, frame, and resource loading with a Content-Security-Policy header.
Result
Content-Security-Policy is missing or incomplete.
Evidence
{
"header": "content-security-policy",
"value": null
}Security & TrustSecurity & TrustEstablished
Referrer-Policy
Referrer-Policy is missing or incomplete.
33 Fail
Security & TrustSecurity & TrustEstablished
Referrer-Policy
Referrer-Policy is missing or incomplete.
Needs attention
Referrer-Policy
Issue
Referrer-Policy is missing or incomplete.
Why it matters
Referrer-Policy controls how much URL context is sent to other origins, limiting accidental leakage of paths, queries, and identifiers.
Check name
Referrer-Policy
Score
0/100
Status
fail
Category
Security & Trust
Maturity
Established
Goal
Limit how much referrer data leaves the site.
Result
Referrer-Policy is missing or incomplete.
Evidence
{
"header": "referrer-policy",
"value": null
}AI DiscoverabilityBot Access ControlInformational
Web Bot Auth request signing
Web Bot Auth request signing failed at "Fetch to find resource".
33 Fail
AI DiscoverabilityBot Access ControlInformational
Web Bot Auth request signing
Web Bot Auth request signing failed at "Fetch to find resource".
Needs attention
Web Bot Auth request signing
Issue
Web Bot Auth request signing was not found at the expected path.
Why it matters
Web Bot Auth discovery lets servers and clients find signing keys for bot identity workflows based on HTTP Message Signatures.
Check name
Web Bot Auth request signing
Score
0/100
Status
fail
Category
Bot Access Control
Maturity
Informational
Goal
Advertise HTTP Message Signatures keys when this site operates signed bot clients or supports Web Bot Auth workflows.
Result
Web Bot Auth request signing failed at "Fetch to find resource".
Validation steps
Fetch to find resource
Web Bot Auth request signing was not found at the expected path.
Evidence
{
"failedStep": "fetch",
"steps": [
{
"id": "fetch",
"title": "Fetch to find resource",
"status": "fail",
"evidence": {
"checked": [
{
"path": "/.well-known/http-message-signatures-directory",
"statusCode": 404,
"contentType": "text/html; charset=utf-8",
"length": 109961
}
]
},
"issue": "Web Bot Auth request signing was not found at the expected path.",
"howToFix": "If publishing Web Bot Auth keys, return a JSON key directory with a non-empty keys array and the draft media type."
}
]
}Security & TrustSecurity & TrustEstablished
X-Content-Type-Options
X-Content-Type-Options is missing or incomplete.
33 Fail
Security & TrustSecurity & TrustEstablished
X-Content-Type-Options
X-Content-Type-Options is missing or incomplete.
Needs attention
X-Content-Type-Options
Issue
X-Content-Type-Options is missing or incomplete.
Why it matters
X-Content-Type-Options prevents browsers from treating mislabeled files as executable content, reducing content-sniffing attacks.
Check name
X-Content-Type-Options
Score
0/100
Status
fail
Category
Security & Trust
Maturity
Established
Goal
Prevent MIME sniffing for browser-loaded resources.
Result
X-Content-Type-Options is missing or incomplete.
Evidence
{
"header": "x-content-type-options",
"value": null
}Agent Ease of UseSkill DiscoveryEmerging recommendation
A2A Agent Card
A2A Agent Card failed at "Fetch to find resource".
25 Fail
Agent Ease of UseSkill DiscoveryEmerging recommendation
A2A Agent Card
A2A Agent Card failed at "Fetch to find resource".
Needs attention
A2A Agent Card
Issue
A2A Agent Card was not found at the expected path.
Why it matters
A2A Agent Cards let compatible clients discover agent skills, input and output modes, and the endpoint used to invoke those skills.
Check name
A2A Agent Card
Score
0/100
Status
fail
Category
Skill Discovery
Maturity
Emerging recommendation
Goal
Publish an agent card so A2A-compatible clients can discover capabilities.
Result
A2A Agent Card failed at "Fetch to find resource".
Validation steps
Fetch to find resource
A2A Agent Card was not found at the expected path.
Evidence
{
"failedStep": "fetch",
"steps": [
{
"id": "fetch",
"title": "Fetch to find resource",
"status": "fail",
"evidence": {
"checked": [
{
"path": "/.well-known/agent-card.json",
"statusCode": 404,
"contentType": "text/html; charset=utf-8",
"length": 109943
},
{
"path": "/.well-known/a2a/agent-card.json",
"statusCode": 404,
"contentType": "text/html; charset=utf-8",
"length": 109951
},
{
"path": "/agent-card.json",
"statusCode": 404,
"contentType": "text/html; charset=utf-8",
"length": 109927
}
]
},
"issue": "A2A Agent Card was not found at the expected path.",
"howToFix": "Publish an A2A Agent Card with required skill details and make the advertised url answer A2A JSON-RPC requests."
}
]
}Agent Ease of UseSkill DiscoveryEmerging recommendation
Agent Skills index
Agent Skills index failed at "Fetch to find resource".
25 Fail
Agent Ease of UseSkill DiscoveryEmerging recommendation
Agent Skills index
Agent Skills index failed at "Fetch to find resource".
Needs attention
Agent Skills index
Issue
Agent Skills index was not found at the expected path.
Why it matters
An Agent Skills index lets clients find task-specific SKILL.md documents that describe how to use site capabilities correctly.
Check name
Agent Skills index
Score
0/100
Status
fail
Category
Skill Discovery
Maturity
Emerging recommendation
Goal
Publish an agent skills discovery index.
Result
Agent Skills index failed at "Fetch to find resource".
Validation steps
Fetch to find resource
Agent Skills index was not found at the expected path.
Evidence
{
"failedStep": "fetch",
"steps": [
{
"id": "fetch",
"title": "Fetch to find resource",
"status": "fail",
"evidence": {
"checked": [
{
"path": "/.well-known/agent-skills/index.json",
"statusCode": 404,
"contentType": "text/html; charset=utf-8",
"length": 109955
},
{
"path": "/.well-known/skills/index.json",
"statusCode": 404,
"contentType": "text/html; charset=utf-8",
"length": 109949
}
]
},
"issue": "Agent Skills index was not found at the expected path.",
"howToFix": "Publish an index with a non-empty skills array and reachable SKILL.md URLs."
}
]
}Agent Ease of UseSkill DiscoveryEmerging recommendation
agent.json
agent.json failed at "Fetch to find resource".
25 Fail
Agent Ease of UseSkill DiscoveryEmerging recommendation
agent.json
agent.json failed at "Fetch to find resource".
Needs attention
agent.json
Issue
agent.json was not found at the expected path.
Why it matters
agent.json is an emerging machine-readable manifest for declaring what a website does, how agents authenticate, and which actions or protocols are available.
Check name
agent.json
Score
0/100
Status
fail
Category
Skill Discovery
Maturity
Emerging recommendation
Goal
Publish the singular Agent Web Protocol agent.json manifest without confusing it with the separate agents.json directory convention.
Result
agent.json failed at "Fetch to find resource".
Validation steps
Fetch to find resource
agent.json was not found at the expected path.
Evidence
{
"failedStep": "fetch",
"steps": [
{
"id": "fetch",
"title": "Fetch to find resource",
"status": "fail",
"evidence": {
"checked": [
{
"path": "/.well-known/agent.json",
"statusCode": 404,
"contentType": "text/html; charset=utf-8",
"length": 109938
},
{
"path": "/agent.json",
"statusCode": 404,
"contentType": "text/html; charset=utf-8",
"length": 109922
}
]
},
"issue": "agent.json was not found at the expected path.",
"howToFix": "Publish agent.json with awp_version, domain, intent, and typed actions that point to real same-origin API or protocol endpoints."
}
]
}Agent Ease of UseSkill DiscoveryInformational
agents.json
agents.json failed at "Fetch to find resource".
25 Fail
Agent Ease of UseSkill DiscoveryInformational
agents.json
agents.json failed at "Fetch to find resource".
Needs attention
agents.json
Issue
agents.json was not found at the expected path.
Why it matters
agents.json gives clients a simple directory of agent-facing capabilities and contacts when a site chooses to advertise them.
Check name
agents.json
Score
0/100
Status
fail
Category
Skill Discovery
Maturity
Informational
Goal
Publish an agents.json directory for agent-facing capabilities and contacts when using this convention.
Result
agents.json failed at "Fetch to find resource".
Validation steps
Fetch to find resource
agents.json was not found at the expected path.
Evidence
{
"failedStep": "fetch",
"steps": [
{
"id": "fetch",
"title": "Fetch to find resource",
"status": "fail",
"evidence": {
"checked": [
{
"path": "/.well-known/agents.json",
"statusCode": 404,
"contentType": "text/html; charset=utf-8",
"length": 109939
},
{
"path": "/agents.json",
"statusCode": 404,
"contentType": "text/html; charset=utf-8",
"length": 109923
}
]
},
"issue": "agents.json was not found at the expected path.",
"howToFix": "If this site uses agents.json, publish JSON with an agents array containing name and url for each agent."
}
]
}AI DiscoverabilityContent ReadinessEstablished
Content freshness signals
Content freshness signals is missing or incomplete.
25 Fail
AI DiscoverabilityContent ReadinessEstablished
Content freshness signals
Content freshness signals is missing or incomplete.
Needs attention
Content freshness signals
Issue
Content freshness signals are incomplete: missing Last-Modified HTTP header; missing dateModified/datePublished in JSON-LD; missing meta or <time> freshness tags.
Why it matters
Freshness signals help agents decide whether content is current enough to cite, summarize, or compare against newer sources.
Check name
Content freshness signals
Score
0/100
Status
fail
Category
Content Readiness
Maturity
Established
Goal
Expose modified and published dates for freshness-aware retrieval and ranking.
Result
Content freshness signals is missing or incomplete.
Evidence
{
"lastModified": null,
"schemaDates": [],
"metaDateCount": 0,
"timeDateCount": 0
}AI DiscoverabilityDiscoverabilityEstablished
High-value schema types
High-value schema types is missing or incomplete.
25 Fail
AI DiscoverabilityDiscoverabilityEstablished
High-value schema types
High-value schema types is missing or incomplete.
Needs attention
High-value schema types
Issue
No high-value schema types (e.g. Article, Product, Service) were found.
Why it matters
High-value schema types tell agents whether a page is an article, product, event, service, or other actionable content type.
Check name
High-value schema types
Score
0/100
Status
fail
Category
Discoverability
Maturity
Established
Goal
Use schema types that describe the page's primary content or offering.
Result
High-value schema types is missing or incomplete.
Evidence
{
"found": [],
"expected": [
"Article",
"BlogPosting",
"NewsArticle",
"Product",
"SoftwareApplication",
"FAQPage",
"LocalBusiness",
"VideoObject",
"HowTo",
"Event",
"Course",
"Review",
"Service"
],
"allTypes": []
}AI DiscoverabilityDiscoverabilityEstablished
JSON-LD present
JSON-LD present is missing or incomplete.
25 Fail
AI DiscoverabilityDiscoverabilityEstablished
JSON-LD present
JSON-LD present is missing or incomplete.
Needs attention
JSON-LD present
Issue
No JSON-LD blocks found.
Why it matters
JSON-LD is a low-friction structured data format that agents can extract without interpreting page presentation or microdata markup.
Check name
JSON-LD present
Score
0/100
Status
fail
Category
Discoverability
Maturity
Established
Goal
Expose schema.org JSON-LD so AI search systems can parse page entities.
Result
JSON-LD present is missing or incomplete.
Evidence
{
"blocks": 0,
"validBlocks": 0,
"schemaContextBlocks": 0,
"errors": [],
"documents": [],
"nodes": []
}AI DiscoverabilityDiscoverabilityEstablished
Link headers
Link headers failed at "Find useful Link headers".
25 Fail
AI DiscoverabilityDiscoverabilityEstablished
Link headers
Link headers failed at "Find useful Link headers".
Needs attention
Link headers
Issue
No useful agent discovery Link headers were found.
Why it matters
Link headers let automated clients discover API catalogs, documentation, and machine-readable alternates without parsing page markup first.
Check name
Link headers
Score
0/100
Status
fail
Category
Discoverability
Maturity
Established
Goal
Include Link response headers for agent discovery using RFC 8288.
Result
Link headers failed at "Find useful Link headers".
Validation steps
Find useful Link headers
No useful agent discovery Link headers were found.
Fetch same-origin Link header targets
Link headers did not expose any same-origin targets to validate.
Evidence
{
"failedStep": "presence",
"steps": [
{
"id": "presence",
"title": "Find useful Link headers",
"status": "fail",
"evidence": {
"links": []
},
"issue": "No useful agent discovery Link headers were found.",
"howToFix": "Expose useful Link headers such as rel=\"api-catalog\", rel=\"service-doc\", and rel=\"service-desc\"."
},
{
"id": "target-validation",
"title": "Fetch same-origin Link header targets",
"status": "fail",
"evidence": {
"checked": [],
"failures": [
{
"reason": "No same-origin Link header targets were available to fetch."
}
]
},
"issue": "Link headers did not expose any same-origin targets to validate.",
"howToFix": "Make each same-origin Link href reachable and serve the advertised media type."
}
]
}AI DiscoverabilityContent ReadinessEmerging recommendation
llms.txt
llms.txt failed at "Fetch to find resource".
25 Fail
AI DiscoverabilityContent ReadinessEmerging recommendation
llms.txt
llms.txt failed at "Fetch to find resource".
Needs attention
llms.txt
Issue
llms.txt was not found at the expected path.
Why it matters
llms.txt gives language-model clients a concise, curated summary of important site context and links before they crawl broadly.
Check name
llms.txt
Score
0/100
Status
fail
Category
Content Readiness
Maturity
Emerging recommendation
Goal
Publish llms.txt to summarize agent-readable site guidance.
Result
llms.txt failed at "Fetch to find resource".
Validation steps
Fetch to find resource
llms.txt was not found at the expected path.
Evidence
{
"failedStep": "fetch",
"steps": [
{
"id": "fetch",
"title": "Fetch to find resource",
"status": "fail",
"evidence": {
"checked": [
{
"path": "/llms.txt",
"statusCode": 404,
"contentType": "text/html; charset=utf-8",
"length": 109920
},
{
"path": "/llms-full.txt",
"statusCode": 404,
"contentType": "text/html; charset=utf-8",
"length": 109925
}
]
},
"issue": "llms.txt was not found at the expected path.",
"howToFix": "Publish /llms.txt as Markdown with a clear title, concise site summary, and useful links for agents."
}
]
}AI DiscoverabilityContent ReadinessEstablished
Markdown negotiation
Markdown negotiation failed at "Markdown content type".
25 Fail
AI DiscoverabilityContent ReadinessEstablished
Markdown negotiation
Markdown negotiation failed at "Markdown content type".
Needs attention
Markdown negotiation
Issue
Content-Type "text/html; charset=utf-8" does not indicate Markdown when requested with Accept: text/markdown.
Why it matters
Markdown negotiation gives agents a cleaner representation of page content while preserving normal HTML for browsers.
Check name
Markdown negotiation
Score
0/100
Status
fail
Category
Content Readiness
Maturity
Established
Goal
Return HTML responses as markdown when agents request it.
Result
Markdown negotiation failed at "Markdown content type".
Validation steps
Markdown content type
Content-Type "text/html; charset=utf-8" does not indicate Markdown when requested with Accept: text/markdown.
Vary: Accept header
Markdown negotiation is missing Vary: Accept; current Vary header is "rsc, next-router-state-tree, next-router-prefetch, next-router-segment-prefetch, accept-encoding".
Structured Markdown body
Markdown response is missing a heading.
Evidence
{
"failedStep": "content-type",
"steps": [
{
"id": "content-type",
"title": "Markdown content type",
"status": "fail",
"evidence": {
"statusCode": 200,
"contentType": "text/html; charset=utf-8"
},
"issue": "Content-Type \"text/html; charset=utf-8\" does not indicate Markdown when requested with Accept: text/markdown.",
"howToFix": "Return Content-Type: text/markdown; charset=utf-8 for requests with Accept: text/markdown."
},
{
"id": "vary-accept",
"title": "Vary: Accept header",
"status": "fail",
"evidence": {
"vary": "rsc, next-router-state-tree, next-router-prefetch, next-router-segment-prefetch, accept-encoding"
},
"issue": "Markdown negotiation is missing Vary: Accept; current Vary header is \"rsc, next-router-state-tree, next-router-prefetch, next-router-segment-prefetch, accept-encoding\".",
"howToFix": "Add Vary: Accept on negotiated Markdown responses so shared caches keep HTML and Markdown variants separate."
},
{
"id": "markdown-content",
"title": "Structured Markdown body",
"status": "fail",
"evidence": {
"valid": false,
"hasHeading": false,
"wordCount": 53994,
"excerpt": "<!DOCTYPE html><!--E0w51E7TqCHIskwlNlUQP--><html lang=\"en\"><head><meta charSet=\"utf-8\"/><meta name=\"viewport\" content=\"width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no\"/><link rel=\"preload\" href=\"/_nex",
"issue": "Markdown response is missing a heading."
},
"issue": "Markdown response is missing a heading.",
"howToFix": "Return Markdown with at least one heading and substantive page content, including useful links or instructions for agents."
}
]
}Agent Ease of UseMCPEmerging recommendation
MCP Server Card
MCP Server Card failed at "Fetch to find resource".
25 Fail
Agent Ease of UseMCPEmerging recommendation
MCP Server Card
MCP Server Card failed at "Fetch to find resource".
Needs attention
MCP Server Card
Issue
MCP Server Card was not found at the expected path.
Why it matters
MCP Server Cards help agents discover server transports, capabilities, and protocol details before opening an MCP session.
Check name
MCP Server Card
Score
0/100
Status
fail
Category
MCP
Maturity
Emerging recommendation
Goal
Publish an MCP Server Card for agent discovery.
Result
MCP Server Card failed at "Fetch to find resource".
Validation steps
Fetch to find resource
MCP Server Card was not found at the expected path.
Evidence
{
"failedStep": "fetch",
"steps": [
{
"id": "fetch",
"title": "Fetch to find resource",
"status": "fail",
"evidence": {
"checked": [
{
"path": "/.well-known/mcp/server-card.json",
"statusCode": 404,
"contentType": "text/html; charset=utf-8",
"length": 109952
},
{
"path": "/.well-known/mcp/server-cards.json",
"statusCode": 404,
"contentType": "text/html; charset=utf-8",
"length": 109953
},
{
"path": "/.well-known/mcp.json",
"statusCode": 404,
"contentType": "text/html; charset=utf-8",
"length": 109936
}
]
},
"issue": "MCP Server Card was not found at the expected path.",
"howToFix": "Publish an MCP server card with valid transports and make each advertised local endpoint answer an MCP initialize request."
}
]
}Agent Ease of UseMCPEmerging recommendation
mcp.json
mcp.json failed at "Fetch to find resource".
25 Fail
Agent Ease of UseMCPEmerging recommendation
mcp.json
mcp.json failed at "Fetch to find resource".
Needs attention
mcp.json
Issue
mcp.json was not found at the expected path.
Why it matters
MCP clients need trustworthy server metadata, protocol version, transport details, and capability hints before connecting to a remote MCP server.
Check name
mcp.json
Score
0/100
Status
fail
Category
MCP
Maturity
Emerging recommendation
Goal
Expose a stable MCP server metadata document that points agents to the site's MCP endpoint.
Result
mcp.json failed at "Fetch to find resource".
Validation steps
Fetch to find resource
mcp.json was not found at the expected path.
Evidence
{
"failedStep": "fetch",
"steps": [
{
"id": "fetch",
"title": "Fetch to find resource",
"status": "fail",
"evidence": {
"checked": [
{
"path": "/mcp.json",
"statusCode": 404,
"contentType": "text/html; charset=utf-8",
"length": 109920
},
{
"path": "/.well-known/mcp.json",
"statusCode": 404,
"contentType": "text/html; charset=utf-8",
"length": 109936
},
{
"path": "/.well-known/mcp/server-card.json",
"statusCode": 404,
"contentType": "text/html; charset=utf-8",
"length": 109952
}
]
},
"issue": "mcp.json was not found at the expected path.",
"howToFix": "Publish mcp.json or an MCP server card with serverInfo, protocolVersion, transport endpoint, and capabilities."
}
]
}AI DiscoverabilityDiscoverabilityEstablished
Organization / WebSite schema
Organization / WebSite schema is missing or incomplete.
25 Fail
AI DiscoverabilityDiscoverabilityEstablished
Organization / WebSite schema
Organization / WebSite schema is missing or incomplete.
Needs attention
Organization / WebSite schema
Issue
Neither Organization nor WebSite schema types were found in JSON-LD.
Why it matters
Organization and WebSite schema help agents identify the publisher, canonical site identity, logo, and related profiles for attribution.
Check name
Organization / WebSite schema
Score
0/100
Status
fail
Category
Discoverability
Maturity
Established
Goal
Identify the site owner and website entity in structured data.
Result
Organization / WebSite schema is missing or incomplete.
Evidence
{
"found": [],
"allTypes": []
}AI DiscoverabilityContent ReadinessEstablished
Semantic HTML
Semantic HTML is missing or incomplete.
25 Fail
AI DiscoverabilityContent ReadinessEstablished
Semantic HTML
Semantic HTML is missing or incomplete.
Needs attention
Semantic HTML
Issue
Semantic HTML is incomplete: missing <main> landmark.
Why it matters
Semantic HTML gives browsers, assistive technology, search systems, and agents reliable landmarks, headings, controls, form semantics, and image context.
Check name
Semantic HTML
Score
0/100
Status
fail
Category
Content Readiness
Maturity
Established
Goal
Expose readable page structure through semantic HTML and accessible controls.
Result
Semantic HTML is missing or incomplete.
Evidence
{
"main": false,
"nav": true,
"footer": true,
"meaningfulH1": true,
"headingOrder": true,
"accessibleLinks": true,
"accessibleButtons": true,
"imageAltCoverage": true,
"formAutocompleteCoverage": true,
"details": {
"inaccessibleLinks": [],
"inaccessibleButtons": [],
"missingAutocompleteInputs": [],
"imagesMissingAlt": [],
"skippedHeadingLevels": []
},
"counts": {
"h1": 1,
"headings": 19,
"links": 68,
"inaccessibleLinks": 0,
"buttons": 12,
"inaccessibleButtons": 0,
"images": 14,
"imagesWithAlt": 14,
"autocompleteInputs": 1,
"inputsWithAutocomplete": 1,
"missingAutocompleteInputs": 0
}
}Agent Ease of UseMCPInformational
WebMCP manifest
WebMCP manifest failed at "Fetch to find resource".
25 Fail
Agent Ease of UseMCPInformational
WebMCP manifest
WebMCP manifest failed at "Fetch to find resource".
Needs attention
WebMCP manifest
Issue
WebMCP manifest was not found at the expected path.
Why it matters
A WebMCP manifest advertises browser-exposed tools declaratively so agents can understand available site actions before invoking them.
Check name
WebMCP manifest
Score
0/100
Status
fail
Category
MCP
Maturity
Informational
Goal
Publish a WebMCP manifest for declarative browser tool discovery when using the draft manifest convention.
Result
WebMCP manifest failed at "Fetch to find resource".
Validation steps
Fetch to find resource
WebMCP manifest was not found at the expected path.
Evidence
{
"failedStep": "fetch",
"steps": [
{
"id": "fetch",
"title": "Fetch to find resource",
"status": "fail",
"evidence": {
"checked": [
{
"path": "/.well-known/webmcp.json",
"statusCode": 404,
"contentType": "text/html; charset=utf-8",
"length": 109939
},
{
"path": "/webmcp.json",
"statusCode": 404,
"contentType": "text/html; charset=utf-8",
"length": 109923
},
{
"path": "/mcp.json",
"statusCode": 404,
"contentType": "text/html; charset=utf-8",
"length": 109920
}
]
},
"issue": "WebMCP manifest was not found at the expected path.",
"howToFix": "Keep declarative WebMCP manifest discovery informational until the manifest shape stabilizes; validate tools if you publish one."
}
]
}Agent Ease of UseMCPInformational
WebMCP
WebMCP has a validation warning at "Validate WebMCP declarative annotation quality".
13 Warning
Agent Ease of UseMCPInformational
WebMCP
WebMCP has a validation warning at "Validate WebMCP declarative annotation quality".
Needs attention
WebMCP
Issue
WebMCP declarative annotations need fixes.
Details
Why it matters
WebMCP can expose page context and actions directly through the browser, giving agents safer structured hooks than screen scraping alone.
Check name
WebMCP
Score
50/100
Status
warning
Category
MCP
Maturity
Informational
Goal
Support WebMCP to expose site tools to AI agents via the browser.
Result
WebMCP has a validation warning at "Validate WebMCP declarative annotation quality".
Validation steps
Detect data-mcp-tool annotations
No data-mcp-tool attributes were found on interactive elements.
Detect WebMCP declarative tags
No elements found with tool-name or tool-description attributes.
Validate WebMCP declarative annotation quality
WebMCP declarative annotations need fixes.
WebMCP declarative annotation issues
<input> is missing a name attribute.<input> is missing a label.<input> is missing tool-param-description.
Detect WebMCP imperative API usage
navigator.modelContext.provideContext(), navigator.modelContext.registerTool(), or other imperative signals were not detected in rendered browser state.
Detect WebMCP browser navigator injection
navigator.modelContext was not detected in the rendered browser page.
Interactive surface coverage
Only 0% of interactive surfaces are annotated.
Evidence
{
"failedStep": "declarative-annotation-quality",
"steps": [
{
"id": "data-mcp-tool-attributes",
"title": "Detect data-mcp-tool annotations",
"status": "informational",
"evidence": {
"dataMcpToolCount": 0,
"dataMcpTools": []
},
"issue": "No data-mcp-tool attributes were found on interactive elements.",
"howToFix": "Add data-mcp-tool attributes to high-value forms, buttons, and links so generic MCP-aware tooling can identify intended actions."
},
{
"id": "declarative-tags",
"title": "Detect WebMCP declarative tags",
"status": "informational",
"evidence": {
"totalForms": 1,
"formsWithTags": 0,
"totalInteractive": 81,
"interactiveWithTags": 0,
"totalCount": 82,
"taggedCount": 0,
"dataMcpToolCount": 0,
"dataMcpTools": [],
"coverage": 0,
"annotationIssues": [
"<input> is missing a name attribute.",
"<input> is missing a label.",
"<input> is missing tool-param-description."
]
},
"issue": "No elements found with tool-name or tool-description attributes.",
"howToFix": "Add tool-name and tool-description attributes to forms and interactive elements."
},
{
"id": "declarative-annotation-quality",
"title": "Validate WebMCP declarative annotation quality",
"status": "warning",
"evidence": {
"issueCount": 3,
"issues": [
"<input> is missing a name attribute.",
"<input> is missing a label.",
"<input> is missing tool-param-description."
]
},
"issue": "WebMCP declarative annotations need fixes.",
"issueDetails": [
{
"title": "WebMCP declarative annotation issues",
"items": [
{
"type": "code",
"value": "<input> is missing a name attribute."
},
{
"type": "code",
"value": "<input> is missing a label."
},
{
"type": "code",
"value": "<input> is missing tool-param-description."
}
]
}
],
"howToFix": "Use snake_case tool-name values, descriptive tool-description values, named and labeled fields, and tool-param-description on inputs."
},
{
"id": "imperative-api",
"title": "Detect WebMCP imperative API usage",
"status": "informational",
"evidence": {
"staticSignals": {
"detected": false,
"matched": []
},
"browser": {
"checked": true,
"detected": false,
"hasNavigatorModelContext": false,
"modelContextType": "undefined",
"hasProvideContext": false,
"hasRegisterTool": false
}
},
"issue": "navigator.modelContext.provideContext(), navigator.modelContext.registerTool(), or other imperative signals were not detected in rendered browser state.",
"howToFix": "Use navigator.modelContext.provideContext() to register tools programmatically."
},
{
"id": "browser-navigator-injection",
"title": "Detect WebMCP browser navigator injection",
"status": "informational",
"evidence": {
"browser": {
"checked": true,
"detected": false,
"hasNavigatorModelContext": false,
"modelContextType": "undefined",
"hasProvideContext": false,
"hasRegisterTool": false
}
},
"issue": "navigator.modelContext was not detected in the rendered browser page.",
"howToFix": "Expose WebMCP through navigator.modelContext in the browser runtime when the page is intended to provide in-page tools."
},
{
"id": "surface-coverage",
"title": "Interactive surface coverage",
"status": "informational",
"evidence": {
"totalForms": 1,
"formsWithTags": 0,
"totalInteractive": 81,
"interactiveWithTags": 0,
"totalCount": 82,
"taggedCount": 0,
"dataMcpToolCount": 0,
"dataMcpTools": [],
"coverage": 0,
"annotationIssues": [
"<input> is missing a name attribute.",
"<input> is missing a label.",
"<input> is missing tool-param-description."
]
},
"issue": "Only 0% of interactive surfaces are annotated.",
"howToFix": "Add WebMCP annotations to all forms and interactive elements to increase agent coverage."
}
],
"staticSignals": {
"detected": false,
"matched": []
},
"coverage": {
"totalForms": 1,
"formsWithTags": 0,
"totalInteractive": 81,
"interactiveWithTags": 0,
"totalCount": 82,
"taggedCount": 0,
"dataMcpToolCount": 0,
"dataMcpTools": [],
"coverage": 0,
"annotationIssues": [
"<input> is missing a name attribute.",
"<input> is missing a label.",
"<input> is missing tool-param-description."
]
},
"browserWebMcp": {
"checked": true,
"detected": false,
"hasNavigatorModelContext": false,
"modelContextType": "undefined",
"hasProvideContext": false,
"hasRegisterTool": false
}
}GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
AIO: Visible structured data match
AIO: Visible structured data match scored 0/100 and needs a fix.
12 Fail
GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
AIO: Visible structured data match
AIO: Visible structured data match scored 0/100 and needs a fix.
Needs attention
AIO: Visible structured data match
Issue
No JSON-LD structured data was detected.
Details
Why it matters
AI Overviews depend on Google-search eligibility, useful visible content, consistent structured data, answer-first sections, trust signals, and preview controls that permit snippets.
Check name
AIO: Visible structured data match
Score
0/100
Status
fail
Category
GEO, AIO & AEO
Maturity
Emerging recommendation
Goal
Make page content eligible and useful for Google AI Overviews and AI Mode extraction.
Result
AIO: Visible structured data match scored 0/100 and needs a fix.
Evidence
{
"schemaCount": 0,
"mismatches": [],
"score": 0,
"weight": 18
}Agent Ease of UseAPIEstablished
OpenAPI discovery
OpenAPI discovery has a validation warning at "Check machine-usable API details".
9 Warning
Agent Ease of UseAPIEstablished
OpenAPI discovery
OpenAPI discovery has a validation warning at "Check machine-usable API details".
Needs attention
OpenAPI discovery
Issue
OpenAPI is valid, but missing schemas, parameters, servers, or security details reduce machine usability.
Why it matters
OpenAPI documents let agents understand available operations, schemas, authentication, and request formats before calling an API.
Check name
OpenAPI discovery
Score
83/100
Status
warning
Category
API
Maturity
Established
Goal
Publish a valid OpenAPI or Swagger document for API discovery.
Result
OpenAPI discovery has a validation warning at "Check machine-usable API details".
Validation steps
Check machine-usable API details
OpenAPI is valid, but missing schemas, parameters, servers, or security details reduce machine usability.
Evidence
{
"failedStep": "machine-usable-detail",
"steps": [
{
"id": "fetch",
"title": "Fetch OpenAPI document",
"status": "pass",
"evidence": {
"found": "/docs/openapi.json",
"statusCode": 200,
"contentType": "application/octet-stream, application/json"
}
},
{
"id": "validate",
"title": "Validate baseline OpenAPI structure",
"status": "pass",
"evidence": {
"valid": true,
"compatibleContentType": true,
"format": "json",
"version": "3.0.1",
"pathCount": 3,
"operationCount": 3,
"operationWarnings": [
{
"path": "/project/update/{projectId}",
"method": "post",
"field": "requestBody",
"issue": "Mutating operation has no requestBody schema."
}
],
"hasServers": true,
"hasSecuritySchemes": true,
"hasExplicitNoAuth": false,
"rawExcerpt": "{\n \"openapi\": \"3.0.1\",\n \"info\": {\n \"title\": \"Mintlify External API\",\n \"description\": \"An API for Mintlify documentation management and resource access.\",\n \"version\": \"1.0.0\"\n },\n \"servers\": [\n {\n \"url\": \"https://api.mintlify.com/v1\"\n }\n ],\n \"security\": [\n {\n \"bearerAuth\": []\n }\n ],\n \"x-mcp\": {\n \"enabled\": true\n },\n \"paths\": {\n \"/project/update/{projectId}\": {\n \"post\": {\n \"summary\": \"Trigger update\",\n \"description\": \"Queue a deployment update for your documentation project. Returns a status ID that can be used to track the update progress. The update is triggered from your configured deployment branch.\",\n \"parameters\": [\n {\n \"name\": \"projectId\",\n \"in\": \"path\",\n \"description\": \""
}
},
{
"id": "machine-usable-detail",
"title": "Check machine-usable API details",
"status": "warning",
"evidence": {
"warningCount": 1,
"warnings": [
{
"path": "/project/update/{projectId}",
"method": "post",
"field": "requestBody",
"issue": "Mutating operation has no requestBody schema."
}
],
"hasServers": true,
"hasSecuritySchemes": true,
"hasExplicitNoAuth": false
},
"issue": "OpenAPI is valid, but missing schemas, parameters, servers, or security details reduce machine usability.",
"howToFix": "Add servers, parameters, request bodies, response schemas, and security or explicit no-auth declarations where they apply."
}
]
}GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
AIO: Source and trust signals
AIO: Source and trust signals scored 40/100 and needs a fix.
8 Fail
GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
AIO: Source and trust signals
AIO: Source and trust signals scored 40/100 and needs a fix.
Needs attention
AIO: Source and trust signals
Issue
Missing AIO trust signals: author, publisher, freshnessDate.
Details
Why it matters
AI Overviews depend on Google-search eligibility, useful visible content, consistent structured data, answer-first sections, trust signals, and preview controls that permit snippets.
Check name
AIO: Source and trust signals
Score
40/100
Status
fail
Category
GEO, AIO & AEO
Maturity
Emerging recommendation
Goal
Make page content eligible and useful for Google AI Overviews and AI Mode extraction.
Result
AIO: Source and trust signals scored 40/100 and needs a fix.
Evidence
{
"signals": {
"author": false,
"publisher": false,
"freshnessDate": false,
"aboutOrContact": true,
"policyLinks": true
},
"missing": [
"author",
"publisher",
"freshnessDate"
],
"authorMeta": "",
"schemaAuthors": [],
"schemaPublishers": [],
"schemaDates": [],
"visibleDates": [],
"aboutLinks": [
{
"href": "/customers/fidelity",
"text": "Read more about how Fidelity meets enterprise-level documentation needs with MintlifyRead story",
"html": "<a data-type=\"slider\" class=\"focus:outline-none group w-full\" href=\"/customers/fidelity\"><div class=\"w-full rounded-2xl overflow-hidden relative mb-2 aspect-video\"><img alt=\"Fidelity\" loading=\"lazy\" width=\"500\" height=\"290\" decoding=\"async\" data-nimg=\"1\" class=\"w-full h-full object-cover bg-background-invert/20\" style=\"color:transparent\" srcset=\"/_next/image?url=%2Fcustomers%2Ffidelity.webp&w=640&q=75 1x, /_next/image?url=%2Fcustomers%2Ffidelity.webp&w=1080&q=75 2x\" src=\"/_nex..."
},
{
"href": "https://www.linkedin.com/company/mintlify/posts",
"text": "",
"html": "<a href=\"https://www.linkedin.com/company/mintlify/posts\" target=\"_blank\" rel=\"noopener noreferrer\" aria-label=\"LinkedIn\" class=\"group/social-link relative after:absolute after:content-[''] after:inset-[-8px]\"><svg width=\"21\" height=\"20\" viewBox=\"0 0 21 20\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\" aria-hidden=\"true\" class=\"text-muted opacity-70 group-hover/social-link:opacity-100 transition-opacity duration-300\"><path d=\"M11.4595 11.5714V18.889H8.06641V6.24428H11.2672L11.3238..."
}
],
"contactLinks": [
{
"href": "/use-cases/help-center",
"text": "Help CenterDocs that handle support for you",
"html": "<a class=\"py-2 flex flex-col gap-1\" href=\"/use-cases/help-center\"><div class=\"flex items-center gap-2\"><svg viewBox=\"0 0 18 18\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\" class=\"shrink-0 select-none size-4\"><path opacity=\"0.2\" d=\"M6.75003 16.4956C6.51563 16.4956 6.28124 16.4399 6.06744 16.3281C4.87894 15.7085 1.00003 13.3852 1.00003 9.51118C0.992228 7.59078 2.55271 6.01658 4.47851 6.00488C5.32911 6.01608 6.12893 6.32569 6.75003 6.86179C7.37013 6.32569 8.16603 6.01608 9.00683 6.00488C10.94..."
},
{
"href": "/contact/sales",
"text": "Contact sales",
"html": "<a data-slot=\"button\" class=\"inline-flex items-center outline-offset-2 h-fit focus-visible:outline-2 focus-visible:outline-brand justify-center cursor-pointer gap-1.5 whitespace-nowrap rounded-full font-medium [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-3 shrink-0 transition-[color,background-color] duration-100 bg-background-soft text-text-main border border-transparent text-[15px] py-[4.5px] px-3 w-full\" href=\"/contact/sales\">Contact sales</a>"
},
{
"href": "/contact/sales",
"text": "Contact sales",
"html": "<a data-slot=\"button\" class=\"inline-flex items-center outline-offset-2 h-fit focus-visible:outline-2 focus-visible:outline-brand justify-center cursor-pointer gap-1.5 whitespace-nowrap rounded-full font-medium [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-3 shrink-0 transition-[color,background-color] duration-100 bg-background-soft text-text-main border border-transparent text-[15px] py-[4.5px] px-3 max-lg:hidden dark\" href=\"/contact/sales\">Contact sales</a>"
},
{
"href": "/customers/kalshi",
"text": "How Kalshi helps developers discover what's possible faster and ultimately drive broader adoption of its prediction markets.Read story",
"html": "<a data-type=\"slider\" class=\"focus:outline-none group w-full\" href=\"/customers/kalshi\"><div class=\"w-full rounded-2xl overflow-hidden relative mb-2 aspect-video\"><img alt=\"Kalshi\" loading=\"lazy\" width=\"500\" height=\"290\" decoding=\"async\" data-nimg=\"1\" class=\"w-full h-full object-cover bg-background-invert/20\" style=\"color:transparent\" srcset=\"/_next/image?url=%2Fcustomers%2Fkalshi.webp&w=640&q=75 1x, /_next/image?url=%2Fcustomers%2Fkalshi.webp&w=1080&q=75 2x\" src=\"/_next/image?..."
},
{
"href": "/customers/lovable",
"text": "How Lovable scaled their onboarding and support with Mintlify's AI-native documentationRead story",
"html": "<a data-type=\"slider\" class=\"focus:outline-none group w-full\" href=\"/customers/lovable\"><div class=\"w-full rounded-2xl overflow-hidden relative mb-2 aspect-video\"><img alt=\"Lovable\" loading=\"lazy\" width=\"500\" height=\"290\" decoding=\"async\" data-nimg=\"1\" class=\"w-full h-full object-cover bg-background-invert/20\" style=\"color:transparent\" srcset=\"/_next/image?url=%2Fcustomers%2Flovable.webp&w=640&q=75 1x, /_next/image?url=%2Fcustomers%2Flovable.webp&w=1080&q=75 2x\" src=\"/_next/im..."
},
{
"href": "/customers/anaconda",
"text": "Anaconda freed its engineers from maintaining custom documentation infrastructure to focus on what matters: helping 50 million data scientists build better models faster.Read story",
"html": "<a data-type=\"slider\" class=\"focus:outline-none group w-full\" href=\"/customers/anaconda\"><div class=\"w-full rounded-2xl overflow-hidden relative mb-2 aspect-video\"><img alt=\"Anaconda\" loading=\"lazy\" width=\"500\" height=\"290\" decoding=\"async\" data-nimg=\"1\" class=\"w-full h-full object-cover bg-background-invert/20\" style=\"color:transparent\" srcset=\"/_next/image?url=%2Fcustomers%2Fanaconda.webp&w=640&q=75 1x, /_next/image?url=%2Fcustomers%2Fanaconda.webp&w=1080&q=75 2x\" src=\"/_nex..."
},
{
"href": "/contact/sales",
"text": "Get a demo",
"html": "<a data-slot=\"button\" class=\"inline-flex items-center outline-offset-2 h-fit focus-visible:outline-2 focus-visible:outline-brand justify-center cursor-pointer gap-1.5 whitespace-nowrap rounded-full font-medium [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-3 shrink-0 transition-[color,background-color] duration-100 bg-background-main text-text-main border border-border-soft hover:bg-background-soft hover:border-transparent text-base/[150%] px-6 py-[0.4375rem]..."
}
],
"privacyLinks": [
{
"href": "/legal/privacy",
"text": "Privacy Policy",
"html": "<a target=\"_self\" data-slot=\"button\" class=\"inline-flex items-center outline-offset-2 h-fit focus-visible:outline-2 focus-visible:outline-brand justify-center cursor-pointer gap-1.5 whitespace-nowrap rounded-full font-medium [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-3 shrink-0 transition-[color,background-color] duration-100 text-text-main border border-transparent text-sm/[150%] bg-transparent px-3 py-1.5 hover:bg-background-soft\" href=\"/legal/privacy\">..."
},
{
"href": "/legal/terms",
"text": "Terms Of Service",
"html": "<a target=\"_self\" data-slot=\"button\" class=\"inline-flex items-center outline-offset-2 h-fit focus-visible:outline-2 focus-visible:outline-brand justify-center cursor-pointer gap-1.5 whitespace-nowrap rounded-full font-medium [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-3 shrink-0 transition-[color,background-color] duration-100 text-text-main border border-transparent text-sm/[150%] bg-transparent px-3 py-1.5 hover:bg-background-soft\" href=\"/legal/terms\">Te..."
}
],
"score": 40,
"weight": 20
}GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
AEO: Answer evidence and trust
AEO: Answer evidence and trust scored 40/100 and needs a fix.
5 Fail
GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
AEO: Answer evidence and trust
AEO: Answer evidence and trust scored 40/100 and needs a fix.
Needs attention
AEO: Answer evidence and trust
Issue
Missing AIO trust signals: author, publisher, freshnessDate.
Details
Why it matters
Answer engines need concise answers, question-led structure, entity clarity, visible evidence, and trust signals that can be extracted without relying on search-only metadata checks.
Check name
AEO: Answer evidence and trust
Score
40/100
Status
fail
Category
GEO, AIO & AEO
Maturity
Emerging recommendation
Goal
Make page content easy for answer engines and assistants to answer from directly.
Result
AEO: Answer evidence and trust scored 40/100 and needs a fix.
Evidence
{
"signals": {
"author": false,
"publisher": false,
"freshnessDate": false,
"aboutOrContact": true,
"policyLinks": true
},
"missing": [
"author",
"publisher",
"freshnessDate"
],
"authorMeta": "",
"schemaAuthors": [],
"schemaPublishers": [],
"schemaDates": [],
"visibleDates": [],
"aboutLinks": [
{
"href": "/customers/fidelity",
"text": "Read more about how Fidelity meets enterprise-level documentation needs with MintlifyRead story",
"html": "<a data-type=\"slider\" class=\"focus:outline-none group w-full\" href=\"/customers/fidelity\"><div class=\"w-full rounded-2xl overflow-hidden relative mb-2 aspect-video\"><img alt=\"Fidelity\" loading=\"lazy\" width=\"500\" height=\"290\" decoding=\"async\" data-nimg=\"1\" class=\"w-full h-full object-cover bg-background-invert/20\" style=\"color:transparent\" srcset=\"/_next/image?url=%2Fcustomers%2Ffidelity.webp&w=640&q=75 1x, /_next/image?url=%2Fcustomers%2Ffidelity.webp&w=1080&q=75 2x\" src=\"/_nex..."
},
{
"href": "https://www.linkedin.com/company/mintlify/posts",
"text": "",
"html": "<a href=\"https://www.linkedin.com/company/mintlify/posts\" target=\"_blank\" rel=\"noopener noreferrer\" aria-label=\"LinkedIn\" class=\"group/social-link relative after:absolute after:content-[''] after:inset-[-8px]\"><svg width=\"21\" height=\"20\" viewBox=\"0 0 21 20\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\" aria-hidden=\"true\" class=\"text-muted opacity-70 group-hover/social-link:opacity-100 transition-opacity duration-300\"><path d=\"M11.4595 11.5714V18.889H8.06641V6.24428H11.2672L11.3238..."
}
],
"contactLinks": [
{
"href": "/use-cases/help-center",
"text": "Help CenterDocs that handle support for you",
"html": "<a class=\"py-2 flex flex-col gap-1\" href=\"/use-cases/help-center\"><div class=\"flex items-center gap-2\"><svg viewBox=\"0 0 18 18\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\" class=\"shrink-0 select-none size-4\"><path opacity=\"0.2\" d=\"M6.75003 16.4956C6.51563 16.4956 6.28124 16.4399 6.06744 16.3281C4.87894 15.7085 1.00003 13.3852 1.00003 9.51118C0.992228 7.59078 2.55271 6.01658 4.47851 6.00488C5.32911 6.01608 6.12893 6.32569 6.75003 6.86179C7.37013 6.32569 8.16603 6.01608 9.00683 6.00488C10.94..."
},
{
"href": "/contact/sales",
"text": "Contact sales",
"html": "<a data-slot=\"button\" class=\"inline-flex items-center outline-offset-2 h-fit focus-visible:outline-2 focus-visible:outline-brand justify-center cursor-pointer gap-1.5 whitespace-nowrap rounded-full font-medium [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-3 shrink-0 transition-[color,background-color] duration-100 bg-background-soft text-text-main border border-transparent text-[15px] py-[4.5px] px-3 w-full\" href=\"/contact/sales\">Contact sales</a>"
},
{
"href": "/contact/sales",
"text": "Contact sales",
"html": "<a data-slot=\"button\" class=\"inline-flex items-center outline-offset-2 h-fit focus-visible:outline-2 focus-visible:outline-brand justify-center cursor-pointer gap-1.5 whitespace-nowrap rounded-full font-medium [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-3 shrink-0 transition-[color,background-color] duration-100 bg-background-soft text-text-main border border-transparent text-[15px] py-[4.5px] px-3 max-lg:hidden dark\" href=\"/contact/sales\">Contact sales</a>"
},
{
"href": "/customers/kalshi",
"text": "How Kalshi helps developers discover what's possible faster and ultimately drive broader adoption of its prediction markets.Read story",
"html": "<a data-type=\"slider\" class=\"focus:outline-none group w-full\" href=\"/customers/kalshi\"><div class=\"w-full rounded-2xl overflow-hidden relative mb-2 aspect-video\"><img alt=\"Kalshi\" loading=\"lazy\" width=\"500\" height=\"290\" decoding=\"async\" data-nimg=\"1\" class=\"w-full h-full object-cover bg-background-invert/20\" style=\"color:transparent\" srcset=\"/_next/image?url=%2Fcustomers%2Fkalshi.webp&w=640&q=75 1x, /_next/image?url=%2Fcustomers%2Fkalshi.webp&w=1080&q=75 2x\" src=\"/_next/image?..."
},
{
"href": "/customers/lovable",
"text": "How Lovable scaled their onboarding and support with Mintlify's AI-native documentationRead story",
"html": "<a data-type=\"slider\" class=\"focus:outline-none group w-full\" href=\"/customers/lovable\"><div class=\"w-full rounded-2xl overflow-hidden relative mb-2 aspect-video\"><img alt=\"Lovable\" loading=\"lazy\" width=\"500\" height=\"290\" decoding=\"async\" data-nimg=\"1\" class=\"w-full h-full object-cover bg-background-invert/20\" style=\"color:transparent\" srcset=\"/_next/image?url=%2Fcustomers%2Flovable.webp&w=640&q=75 1x, /_next/image?url=%2Fcustomers%2Flovable.webp&w=1080&q=75 2x\" src=\"/_next/im..."
},
{
"href": "/customers/anaconda",
"text": "Anaconda freed its engineers from maintaining custom documentation infrastructure to focus on what matters: helping 50 million data scientists build better models faster.Read story",
"html": "<a data-type=\"slider\" class=\"focus:outline-none group w-full\" href=\"/customers/anaconda\"><div class=\"w-full rounded-2xl overflow-hidden relative mb-2 aspect-video\"><img alt=\"Anaconda\" loading=\"lazy\" width=\"500\" height=\"290\" decoding=\"async\" data-nimg=\"1\" class=\"w-full h-full object-cover bg-background-invert/20\" style=\"color:transparent\" srcset=\"/_next/image?url=%2Fcustomers%2Fanaconda.webp&w=640&q=75 1x, /_next/image?url=%2Fcustomers%2Fanaconda.webp&w=1080&q=75 2x\" src=\"/_nex..."
},
{
"href": "/contact/sales",
"text": "Get a demo",
"html": "<a data-slot=\"button\" class=\"inline-flex items-center outline-offset-2 h-fit focus-visible:outline-2 focus-visible:outline-brand justify-center cursor-pointer gap-1.5 whitespace-nowrap rounded-full font-medium [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-3 shrink-0 transition-[color,background-color] duration-100 bg-background-main text-text-main border border-border-soft hover:bg-background-soft hover:border-transparent text-base/[150%] px-6 py-[0.4375rem]..."
}
],
"privacyLinks": [
{
"href": "/legal/privacy",
"text": "Privacy Policy",
"html": "<a target=\"_self\" data-slot=\"button\" class=\"inline-flex items-center outline-offset-2 h-fit focus-visible:outline-2 focus-visible:outline-brand justify-center cursor-pointer gap-1.5 whitespace-nowrap rounded-full font-medium [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-3 shrink-0 transition-[color,background-color] duration-100 text-text-main border border-transparent text-sm/[150%] bg-transparent px-3 py-1.5 hover:bg-background-soft\" href=\"/legal/privacy\">..."
},
{
"href": "/legal/terms",
"text": "Terms Of Service",
"html": "<a target=\"_self\" data-slot=\"button\" class=\"inline-flex items-center outline-offset-2 h-fit focus-visible:outline-2 focus-visible:outline-brand justify-center cursor-pointer gap-1.5 whitespace-nowrap rounded-full font-medium [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-3 shrink-0 transition-[color,background-color] duration-100 text-text-main border border-transparent text-sm/[150%] bg-transparent px-3 py-1.5 hover:bg-background-soft\" href=\"/legal/terms\">Te..."
}
],
"score": 40,
"weight": 22
}GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
GEO: Extraction-friendly structure
GEO: Extraction-friendly structure scored 60/100 and needs improvement.
5 Warning
GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
GEO: Extraction-friendly structure
GEO: Extraction-friendly structure scored 60/100 and needs improvement.
Needs attention
GEO: Extraction-friendly structure
Issue
Missing extraction signals: optional top summary / TL;DR / key takeaways block, table with <thead> only if the page already has tabular/comparative data, ordered list only if the page explains a workflow/process, optional visible FAQ or FAQPage schema, JSON-LD structured data.
Details
Why it matters
Generative engines favor pages with self-contained answer passages, clear entities, structured data, summaries, FAQ patterns, and crawler-accessible HTML that can be cited without extra interpretation.
Check name
GEO: Extraction-friendly structure
Score
60/100
Status
warning
Category
GEO, AIO & AEO
Maturity
Emerging recommendation
Goal
Make page content easy for AI answer engines to extract, cite, and attribute.
Result
GEO: Extraction-friendly structure scored 60/100 and needs improvement.
Evidence
{
"hasSummary": false,
"tableCount": 0,
"tablesWithHead": 0,
"tablesMissingThead": [],
"orderedLists": 0,
"hasFaq": false,
"definitionPatterns": 2,
"schemaBlocks": 0,
"missingSignals": [
"optional top summary / TL;DR / key takeaways block",
"table with <thead> only if the page already has tabular/comparative data",
"ordered list only if the page explains a workflow/process",
"optional visible FAQ or FAQPage schema",
"JSON-LD structured data"
],
"score": 60,
"weight": 24
}GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
GEO: Entity clarity
GEO: Entity clarity scored 70/100 and needs improvement.
4 Warning
GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
GEO: Entity clarity
GEO: Entity clarity scored 70/100 and needs improvement.
Needs attention
GEO: Entity clarity
Issue
Title/H1 terms missing from description: mintlify, intelligent, knowledge, platform.
Details
Why it matters
Generative engines favor pages with self-contained answer passages, clear entities, structured data, summaries, FAQ patterns, and crawler-accessible HTML that can be cited without extra interpretation.
Check name
GEO: Entity clarity
Score
70/100
Status
warning
Category
GEO, AIO & AEO
Maturity
Emerging recommendation
Goal
Make page content easy for AI answer engines to extract, cite, and attribute.
Result
GEO: Entity clarity scored 70/100 and needs improvement.
Evidence
{
"title": "Mintlify - The Intelligent Knowledge Platform",
"h1": "The Intelligent Knowledge Platform",
"description": "Meet the next generation of documentation. AI-native, beautiful out-of-the-box, and built for developers.",
"topicOverlap": 0,
"topicTerms": [
"mintlify",
"intelligent",
"knowledge",
"platform"
],
"descriptionTerms": [
"meet",
"next",
"generation",
"documentation",
"native",
"beautiful",
"out",
"box",
"built",
"developers"
],
"missingFromDescription": [
"mintlify",
"intelligent",
"knowledge",
"platform"
],
"score": 70,
"weight": 28
}GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
AEO: Answer-first sections
AEO: Answer-first sections scored 65/100 and needs improvement.
4 Warning
GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
AEO: Answer-first sections
AEO: Answer-first sections scored 65/100 and needs improvement.
Needs attention
AEO: Answer-first sections
Issue
11 section(s) may benefit from a clearer opening answer; this is optional for feature/card sections.
Details
Why it matters
Answer engines need concise answers, question-led structure, entity clarity, visible evidence, and trust signals that can be extracted without relying on search-only metadata checks.
Check name
AEO: Answer-first sections
Score
65/100
Status
warning
Category
GEO, AIO & AEO
Maturity
Emerging recommendation
Goal
Make page content easy for answer engines and assistants to answer from directly.
Result
AEO: Answer-first sections scored 65/100 and needs improvement.
Evidence
{
"sectionCount": 12,
"passing": 1,
"failing": [
{
"heading": "Built for both people and AI",
"headingHtml": "<h3 class=\"md:text-2xl text-xl font-medium leading-[130%] md:tracking-[-0.24px] tracking-[-0.2px] text-text-main\">Built for both people and AI</h3>",
"firstParagraph": "Ensure your product shows up in the AI workflows users already rely on. We support llms.txt, MCP, and whatever comes next.",
"paragraphHtml": "<p class=\"text-text-soft text-base/[1.5] text-balance\">Ensure your product shows up in the AI workflows users already rely on. We support llms.txt, MCP, and whatever comes next.</p>",
"words": 22,
"direct": false,
"issue": "First paragraph is 22 words and does not look like a concise direct answer."
},
{
"heading": "Self-updating knowledge management",
"headingHtml": "<h3 class=\"md:text-2xl text-xl font-medium leading-[130%] md:tracking-[-0.24px] tracking-[-0.2px] text-text-main\">Self-updating knowledge management</h3>",
"firstParagraph": "Draft, edit, and maintain content with a context-aware agent. Move faster and more consistently without the documentation debt.",
"paragraphHtml": "<p class=\"text-text-soft text-base/[1.5] text-balance\">Draft, edit, and maintain content with a context-aware agent. Move faster and more consistently without the documentation debt.</p>",
"words": 18,
"direct": false,
"issue": "First paragraph is 18 words and does not look like a concise direct answer."
},
{
"heading": "Bring intelligence to enterprise knowledge",
"headingHtml": "<h3 class=\"section-title md:!text-left\">Bring intelligence to enterprise knowledge</h3>",
"firstParagraph": "Modernize without the rebuild with enterprise-grade professional service & security.",
"paragraphHtml": "<p class=\"text-main text-text-soft font-normal max-md:text-center text-balance\">Modernize without the rebuild with enterprise-grade professional service & security.</p>",
"words": 9,
"direct": false,
"issue": "First paragraph is 9 words and does not look like a concise direct answer."
},
{
"heading": "See how Anthropic accelerates AI development with Mintlify",
"headingHtml": "<h3 class=\"text-white text-2xl mt-4 font-medium tracking-[-0.24px] max-w-[28rem] relative z-10\">See how Anthropic accelerates AI development with Mintlify</h3>",
"firstParagraph": "2M+",
"paragraphHtml": "<p class=\"text-white text-[2.5rem] leading-[110%] tracking-[-0.8px]\">2M+</p>",
"words": 1,
"direct": false,
"issue": "First paragraph is 1 words and does not look like a concise direct answer."
},
{
"heading": "Loved by your favorite companies",
"headingHtml": "<h2 class=\"section-title\">Loved by your favorite companies</h2>",
"firstParagraph": "From frontier AI companies to consumer brands, leaders across industries scale knowledge with Mintlify.",
"paragraphHtml": "<p class=\"text-center text-text-soft text-base/6 max-w-[34rem]\">From frontier AI companies to consumer brands, leaders across industries scale knowledge with Mintlify.</p>",
"words": 14,
"direct": false,
"issue": "First paragraph is 14 words and does not look like a concise direct answer."
},
{
"heading": "Make documentation your winning advantage",
"headingHtml": "<h3 class=\"text-text-main text-[40px] text-center font-semibold leading-[110%] tracking-[-0.8px] max-w-[560px]\">Make documentation your winning advantage</h3>",
"firstParagraph": "Join the leaders of tomorrow to future proof your documentation today.",
"paragraphHtml": "<p class=\"text-text-main text-base/[150%] mt-4 text-center max-w-[560px] text-balance\">Join the leaders of tomorrow to future proof your documentation today.</p>",
"words": 11,
"direct": false,
"issue": "First paragraph is 11 words and does not look like a concise direct answer."
},
{
"heading": "explore",
"headingHtml": "<h3 class=\"px-3 py-1.5 mb-1 uppercase text-[13px]/[150%] tracking-[0.65px] font-medium text-muted\">explore</h3>",
"firstParagraph": "",
"paragraphHtml": "",
"words": 0,
"direct": false,
"issue": "No paragraph follows this heading."
},
{
"heading": "resources",
"headingHtml": "<h3 class=\"px-3 py-1.5 mb-1 uppercase text-[13px]/[150%] tracking-[0.65px] font-medium text-muted\">resources</h3>",
"firstParagraph": "",
"paragraphHtml": "",
"words": 0,
"direct": false,
"issue": "No paragraph follows this heading."
},
{
"heading": "documentation",
"headingHtml": "<h3 class=\"px-3 py-1.5 mb-1 uppercase text-[13px]/[150%] tracking-[0.65px] font-medium text-muted\">documentation</h3>",
"firstParagraph": "",
"paragraphHtml": "",
"words": 0,
"direct": false,
"issue": "No paragraph follows this heading."
},
{
"heading": "company",
"headingHtml": "<h3 class=\"px-3 py-1.5 mb-1 uppercase text-[13px]/[150%] tracking-[0.65px] font-medium text-muted\">company</h3>",
"firstParagraph": "",
"paragraphHtml": "",
"words": 0,
"direct": false,
"issue": "No paragraph follows this heading."
},
{
"heading": "legal",
"headingHtml": "<h3 class=\"px-3 py-1.5 mb-1 uppercase text-[13px]/[150%] tracking-[0.65px] font-medium text-muted\">legal</h3>",
"firstParagraph": "",
"paragraphHtml": "",
"words": 0,
"direct": false,
"issue": "No paragraph follows this heading."
}
],
"score": 65,
"weight": 28
}GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
AEO: Question-led structure
AEO: Question-led structure scored 50/100 and needs improvement.
3 Warning
GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
AEO: Question-led structure
AEO: Question-led structure scored 50/100 and needs improvement.
Needs attention
AEO: Question-led structure
Issue
No question-led h2 sections or FAQ pattern was detected.
Details
Why it matters
Answer engines need concise answers, question-led structure, entity clarity, visible evidence, and trust signals that can be extracted without relying on search-only metadata checks.
Check name
AEO: Question-led structure
Score
50/100
Status
warning
Category
GEO, AIO & AEO
Maturity
Emerging recommendation
Goal
Make page content easy for answer engines and assistants to answer from directly.
Result
AEO: Question-led structure scored 50/100 and needs improvement.
Evidence
{
"h2Count": 2,
"questionH2s": [],
"hasFaq": false,
"score": 50,
"weight": 18
}GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
GEO: Explanatory content depth
GEO: Explanatory content depth scored 75/100 and needs improvement.
2 Warning
GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
GEO: Explanatory content depth
GEO: Explanatory content depth scored 75/100 and needs improvement.
Needs attention
GEO: Explanatory content depth
Issue
No substantial explanatory paragraphs were found.
Details
Why it matters
Generative engines favor pages with self-contained answer passages, clear entities, structured data, summaries, FAQ patterns, and crawler-accessible HTML that can be cited without extra interpretation.
Check name
GEO: Explanatory content depth
Score
75/100
Status
warning
Category
GEO, AIO & AEO
Maturity
Emerging recommendation
Goal
Make page content easy for AI answer engines to extract, cite, and attribute.
Result
GEO: Explanatory content depth scored 75/100 and needs improvement.
Evidence
{
"candidatePassages": 1,
"citablePassages": 0,
"failingCandidateParagraphs": [],
"citableParagraphs": [],
"score": 75,
"weight": 18
}GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
AIO: Answer block readiness
AIO: Answer block readiness scored 65/100 and needs improvement.
2 Warning
GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
AIO: Answer block readiness
AIO: Answer block readiness scored 65/100 and needs improvement.
Needs attention
AIO: Answer block readiness
Issue
11 section(s) may benefit from a clearer opening answer; this is optional for feature/card sections.
Details
Why it matters
AI Overviews depend on Google-search eligibility, useful visible content, consistent structured data, answer-first sections, trust signals, and preview controls that permit snippets.
Check name
AIO: Answer block readiness
Score
65/100
Status
warning
Category
GEO, AIO & AEO
Maturity
Emerging recommendation
Goal
Make page content eligible and useful for Google AI Overviews and AI Mode extraction.
Result
AIO: Answer block readiness scored 65/100 and needs improvement.
Evidence
{
"sectionCount": 12,
"passing": 1,
"failing": [
{
"heading": "Built for both people and AI",
"headingHtml": "<h3 class=\"md:text-2xl text-xl font-medium leading-[130%] md:tracking-[-0.24px] tracking-[-0.2px] text-text-main\">Built for both people and AI</h3>",
"firstParagraph": "Ensure your product shows up in the AI workflows users already rely on. We support llms.txt, MCP, and whatever comes next.",
"paragraphHtml": "<p class=\"text-text-soft text-base/[1.5] text-balance\">Ensure your product shows up in the AI workflows users already rely on. We support llms.txt, MCP, and whatever comes next.</p>",
"words": 22,
"direct": false,
"issue": "First paragraph is 22 words and does not look like a concise direct answer."
},
{
"heading": "Self-updating knowledge management",
"headingHtml": "<h3 class=\"md:text-2xl text-xl font-medium leading-[130%] md:tracking-[-0.24px] tracking-[-0.2px] text-text-main\">Self-updating knowledge management</h3>",
"firstParagraph": "Draft, edit, and maintain content with a context-aware agent. Move faster and more consistently without the documentation debt.",
"paragraphHtml": "<p class=\"text-text-soft text-base/[1.5] text-balance\">Draft, edit, and maintain content with a context-aware agent. Move faster and more consistently without the documentation debt.</p>",
"words": 18,
"direct": false,
"issue": "First paragraph is 18 words and does not look like a concise direct answer."
},
{
"heading": "Bring intelligence to enterprise knowledge",
"headingHtml": "<h3 class=\"section-title md:!text-left\">Bring intelligence to enterprise knowledge</h3>",
"firstParagraph": "Modernize without the rebuild with enterprise-grade professional service & security.",
"paragraphHtml": "<p class=\"text-main text-text-soft font-normal max-md:text-center text-balance\">Modernize without the rebuild with enterprise-grade professional service & security.</p>",
"words": 9,
"direct": false,
"issue": "First paragraph is 9 words and does not look like a concise direct answer."
},
{
"heading": "See how Anthropic accelerates AI development with Mintlify",
"headingHtml": "<h3 class=\"text-white text-2xl mt-4 font-medium tracking-[-0.24px] max-w-[28rem] relative z-10\">See how Anthropic accelerates AI development with Mintlify</h3>",
"firstParagraph": "2M+",
"paragraphHtml": "<p class=\"text-white text-[2.5rem] leading-[110%] tracking-[-0.8px]\">2M+</p>",
"words": 1,
"direct": false,
"issue": "First paragraph is 1 words and does not look like a concise direct answer."
},
{
"heading": "Loved by your favorite companies",
"headingHtml": "<h2 class=\"section-title\">Loved by your favorite companies</h2>",
"firstParagraph": "From frontier AI companies to consumer brands, leaders across industries scale knowledge with Mintlify.",
"paragraphHtml": "<p class=\"text-center text-text-soft text-base/6 max-w-[34rem]\">From frontier AI companies to consumer brands, leaders across industries scale knowledge with Mintlify.</p>",
"words": 14,
"direct": false,
"issue": "First paragraph is 14 words and does not look like a concise direct answer."
},
{
"heading": "Make documentation your winning advantage",
"headingHtml": "<h3 class=\"text-text-main text-[40px] text-center font-semibold leading-[110%] tracking-[-0.8px] max-w-[560px]\">Make documentation your winning advantage</h3>",
"firstParagraph": "Join the leaders of tomorrow to future proof your documentation today.",
"paragraphHtml": "<p class=\"text-text-main text-base/[150%] mt-4 text-center max-w-[560px] text-balance\">Join the leaders of tomorrow to future proof your documentation today.</p>",
"words": 11,
"direct": false,
"issue": "First paragraph is 11 words and does not look like a concise direct answer."
},
{
"heading": "explore",
"headingHtml": "<h3 class=\"px-3 py-1.5 mb-1 uppercase text-[13px]/[150%] tracking-[0.65px] font-medium text-muted\">explore</h3>",
"firstParagraph": "",
"paragraphHtml": "",
"words": 0,
"direct": false,
"issue": "No paragraph follows this heading."
},
{
"heading": "resources",
"headingHtml": "<h3 class=\"px-3 py-1.5 mb-1 uppercase text-[13px]/[150%] tracking-[0.65px] font-medium text-muted\">resources</h3>",
"firstParagraph": "",
"paragraphHtml": "",
"words": 0,
"direct": false,
"issue": "No paragraph follows this heading."
},
{
"heading": "documentation",
"headingHtml": "<h3 class=\"px-3 py-1.5 mb-1 uppercase text-[13px]/[150%] tracking-[0.65px] font-medium text-muted\">documentation</h3>",
"firstParagraph": "",
"paragraphHtml": "",
"words": 0,
"direct": false,
"issue": "No paragraph follows this heading."
},
{
"heading": "company",
"headingHtml": "<h3 class=\"px-3 py-1.5 mb-1 uppercase text-[13px]/[150%] tracking-[0.65px] font-medium text-muted\">company</h3>",
"firstParagraph": "",
"paragraphHtml": "",
"words": 0,
"direct": false,
"issue": "No paragraph follows this heading."
},
{
"heading": "legal",
"headingHtml": "<h3 class=\"px-3 py-1.5 mb-1 uppercase text-[13px]/[150%] tracking-[0.65px] font-medium text-muted\">legal</h3>",
"firstParagraph": "",
"paragraphHtml": "",
"words": 0,
"direct": false,
"issue": "No paragraph follows this heading."
}
],
"score": 65,
"weight": 8
}GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
AEO: Entity and definition clarity
AEO: Entity and definition clarity scored 75/100 and needs improvement.
2 Warning
GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
AEO: Entity and definition clarity
AEO: Entity and definition clarity scored 75/100 and needs improvement.
Needs attention
AEO: Entity and definition clarity
Issue
Entity or definition gaps: mintlify, intelligent, knowledge, platform.
Details
Why it matters
Answer engines need concise answers, question-led structure, entity clarity, visible evidence, and trust signals that can be extracted without relying on search-only metadata checks.
Check name
AEO: Entity and definition clarity
Score
75/100
Status
warning
Category
GEO, AIO & AEO
Maturity
Emerging recommendation
Goal
Make page content easy for answer engines and assistants to answer from directly.
Result
AEO: Entity and definition clarity scored 75/100 and needs improvement.
Evidence
{
"title": "Mintlify - The Intelligent Knowledge Platform",
"h1": "The Intelligent Knowledge Platform",
"description": "Meet the next generation of documentation. AI-native, beautiful out-of-the-box, and built for developers.",
"topicOverlap": 0,
"definitionCount": 2,
"topicTerms": [
"mintlify",
"intelligent",
"knowledge",
"platform"
],
"descriptionTerms": [
"meet",
"next",
"generation",
"documentation",
"native",
"beautiful",
"out",
"box",
"built",
"developers"
],
"missingFromDescription": [
"mintlify",
"intelligent",
"knowledge",
"platform"
],
"score": 75,
"weight": 18
}GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
AEO: Answer intent coverage
AEO: Answer intent coverage scored 70/100 and needs improvement.
1 Warning
GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
AEO: Answer intent coverage
AEO: Answer intent coverage scored 70/100 and needs improvement.
Needs attention
AEO: Answer intent coverage
Issue
Missing likely AI Overview intent sections: what, how, benefits, cost, compare.
Details
Why it matters
Answer engines need concise answers, question-led structure, entity clarity, visible evidence, and trust signals that can be extracted without relying on search-only metadata checks.
Check name
AEO: Answer intent coverage
Score
70/100
Status
warning
Category
GEO, AIO & AEO
Maturity
Emerging recommendation
Goal
Make page content easy for answer engines and assistants to answer from directly.
Result
AEO: Answer intent coverage scored 70/100 and needs improvement.
Evidence
{
"headings": [
{
"text": "Built for the intelligence age",
"html": "<h2 class=\"section-title\">Built for the intelligence age</h2>"
},
{
"text": "Loved by your favorite companies",
"html": "<h2 class=\"section-title\">Loved by your favorite companies</h2>"
}
],
"expected": [
{
"id": "what",
"label": "What is Mintlify - The Intelligent Knowledge Platform?",
"pattern": {}
},
{
"id": "how",
"label": "How does Mintlify - The Intelligent Knowledge Platform work?",
"pattern": {}
},
{
"id": "benefits",
"label": "Why use Mintlify - The Intelligent Knowledge Platform?",
"pattern": {}
},
{
"id": "cost",
"label": "Is Mintlify - The Intelligent Knowledge Platform free or paid?",
"pattern": {}
},
{
"id": "compare",
"label": "How does Mintlify - The Intelligent Knowledge Platform compare with alternatives?",
"pattern": {}
}
],
"missing": [
{
"id": "what",
"label": "What is Mintlify - The Intelligent Knowledge Platform?",
"pattern": {}
},
{
"id": "how",
"label": "How does Mintlify - The Intelligent Knowledge Platform work?",
"pattern": {}
},
{
"id": "benefits",
"label": "Why use Mintlify - The Intelligent Knowledge Platform?",
"pattern": {}
},
{
"id": "cost",
"label": "Is Mintlify - The Intelligent Knowledge Platform free or paid?",
"pattern": {}
},
{
"id": "compare",
"label": "How does Mintlify - The Intelligent Knowledge Platform compare with alternatives?",
"pattern": {}
}
],
"score": 70,
"weight": 8
}Agent Ease of UseAPIEmerging recommendation
AI context endpoint
AI context endpoint is informational for this page.
Informational
Agent Ease of UseAPIEmerging recommendation
AI context endpoint
AI context endpoint is informational for this page.
Needs attention
AI context endpoint
Issue
AI context endpoint is informational for this page.
Why it matters
A context endpoint gives agents a small, low-latency summary of product purpose, safe actions, and canonical machine-readable resources without scraping the whole site.
Check name
AI context endpoint
Score
100/100
Status
informational
Category
API
Maturity
Emerging recommendation
Goal
Expose a compact API context endpoint agents can fetch before deciding which public API or discovery resource to use.
Result
AI context endpoint is informational for this page.
Validation steps
Fetch to find resource
AI context endpoint was not found at the expected path.
Evidence
{
"steps": [
{
"id": "fetch",
"title": "Fetch to find resource",
"status": "informational",
"evidence": {
"checked": [
{
"path": "/api/ai/context",
"statusCode": 404,
"contentType": "text/html; charset=utf-8",
"length": 109934
},
{
"path": "/api/context",
"statusCode": 404,
"contentType": "text/html; charset=utf-8",
"length": 109927
},
{
"path": "/context",
"statusCode": 404,
"contentType": "text/html; charset=utf-8",
"length": 109919
}
]
},
"issue": "AI context endpoint was not found at the expected path.",
"howToFix": "Publish a concise JSON or Markdown AI context endpoint describing the product, public actions, and machine-readable resources."
}
]
}GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
AIO: Query intent coverage
AIO: Query intent coverage is informational for this page.
Informational
GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
AIO: Query intent coverage
AIO: Query intent coverage is informational for this page.
Needs attention
AIO: Query intent coverage
Issue
Missing likely AI Overview intent sections: what, how, benefits, cost, compare.
Details
Why it matters
AI Overviews depend on Google-search eligibility, useful visible content, consistent structured data, answer-first sections, trust signals, and preview controls that permit snippets.
Check name
AIO: Query intent coverage
Score
70/100
Status
informational
Category
GEO, AIO & AEO
Maturity
Emerging recommendation
Goal
Make page content eligible and useful for Google AI Overviews and AI Mode extraction.
Result
AIO: Query intent coverage is informational for this page.
Evidence
{
"headings": [
{
"text": "Built for the intelligence age",
"html": "<h2 class=\"section-title\">Built for the intelligence age</h2>"
},
{
"text": "Loved by your favorite companies",
"html": "<h2 class=\"section-title\">Loved by your favorite companies</h2>"
}
],
"expected": [
{
"id": "what",
"label": "What is Mintlify - The Intelligent Knowledge Platform?",
"pattern": {}
},
{
"id": "how",
"label": "How does Mintlify - The Intelligent Knowledge Platform work?",
"pattern": {}
},
{
"id": "benefits",
"label": "Why use Mintlify - The Intelligent Knowledge Platform?",
"pattern": {}
},
{
"id": "cost",
"label": "Is Mintlify - The Intelligent Knowledge Platform free or paid?",
"pattern": {}
},
{
"id": "compare",
"label": "How does Mintlify - The Intelligent Knowledge Platform compare with alternatives?",
"pattern": {}
}
],
"missing": [
{
"id": "what",
"label": "What is Mintlify - The Intelligent Knowledge Platform?",
"pattern": {}
},
{
"id": "how",
"label": "How does Mintlify - The Intelligent Knowledge Platform work?",
"pattern": {}
},
{
"id": "benefits",
"label": "Why use Mintlify - The Intelligent Knowledge Platform?",
"pattern": {}
},
{
"id": "cost",
"label": "Is Mintlify - The Intelligent Knowledge Platform free or paid?",
"pattern": {}
},
{
"id": "compare",
"label": "How does Mintlify - The Intelligent Knowledge Platform compare with alternatives?",
"pattern": {}
}
],
"score": 70,
"weight": 4
}GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
GEO: Q&A and FAQ opportunities
GEO: Q&A and FAQ opportunities is informational for this page.
Informational
GEO, AIO and AEOGEO, AIO & AEOEmerging recommendation
GEO: Q&A and FAQ opportunities
GEO: Q&A and FAQ opportunities is informational for this page.
Needs attention
GEO: Q&A and FAQ opportunities
Issue
2 h2 heading(s) are not phrased as questions; this is optional and only useful where Q&A wording is natural. No visible FAQ or FAQPage schema was detected; this is optional unless the page answers common questions.
Details
Why it matters
Generative engines favor pages with self-contained answer passages, clear entities, structured data, summaries, FAQ patterns, and crawler-accessible HTML that can be cited without extra interpretation.
Check name
GEO: Q&A and FAQ opportunities
Score
75/100
Status
informational
Category
GEO, AIO & AEO
Maturity
Emerging recommendation
Goal
Make page content easy for AI answer engines to extract, cite, and attribute.
Result
GEO: Q&A and FAQ opportunities is informational for this page.
Evidence
{
"h2Count": 2,
"questionH2s": 0,
"hasFaq": false,
"nonQuestionH2s": [
{
"index": 1,
"text": "Built for the intelligence age",
"isQuestion": false,
"html": "<h2 class=\"section-title\">Built for the intelligence age</h2>"
},
{
"index": 2,
"text": "Loved by your favorite companies",
"isQuestion": false,
"html": "<h2 class=\"section-title\">Loved by your favorite companies</h2>"
}
],
"score": 75,
"weight": 4
}AI DiscoverabilityDiscoverabilityEstablished
IndexNow key
IndexNow key is informational for this page.
Informational
AI DiscoverabilityDiscoverabilityEstablished
IndexNow key
IndexNow key is informational for this page.
Needs attention
IndexNow key
Issue
IndexNow key is informational for this page.
Why it matters
IndexNow lets sites notify participating search engines about changed URLs, but ownership verification requires a UTF-8 key file whose filename matches the key.
Check name
IndexNow key
Score
100/100
Status
informational
Category
Discoverability
Maturity
Established
Goal
Verify that IndexNow ownership key placement is detectable when the site advertises it.
Result
IndexNow key is informational for this page.
Validation steps
Find advertised IndexNow key location
No IndexNow key location was advertised in HTML, Link headers, or robots.txt.
Fetch and validate IndexNow key file
No discoverable IndexNow key file was found.
Evidence
{
"steps": [
{
"id": "advertised-location",
"title": "Find advertised IndexNow key location",
"status": "informational",
"evidence": {
"advertised": []
},
"issue": "No IndexNow key location was advertised in HTML, Link headers, or robots.txt.",
"howToFix": "Advertise the key location with robots.txt IndexNow-Key, rel=\"indexnow-key\", or meta name=\"indexnow-key-location\" if you want scanners to verify it."
},
{
"id": "fetch-key",
"title": "Fetch and validate IndexNow key file",
"status": "informational",
"evidence": {
"advertised": [],
"checked": []
},
"issue": "No discoverable IndexNow key file was found.",
"howToFix": "Host a UTF-8 text file named {key}.txt using a 32-character hexadecimal key whose body exactly matches the key."
}
]
}Agent Ease of UseAuthEstablished
OAuth / OIDC discovery
OAuth / OIDC discovery has an informational finding because the page appears to support authentication.
Informational
Agent Ease of UseAuthEstablished
OAuth / OIDC discovery
OAuth / OIDC discovery has an informational finding because the page appears to support authentication.
Needs attention
OAuth / OIDC discovery
Issue
OAuth Discovery response did not match the expected shape. missing: jwks_uri; endpoint issues: [{"field":"jwks_uri","issue":"Missing URL."}].
Why it matters
OAuth and OIDC discovery let agents find authorization, token, and key endpoints programmatically instead of relying on human documentation.
Check name
OAuth / OIDC discovery
Score
0/100
Status
informational
Category
Auth
Maturity
Established
Goal
Publish OAuth/OIDC discovery metadata so agents can authenticate with your APIs.
Result
OAuth / OIDC discovery has an informational finding because the page appears to support authentication.
Validation steps
Validate resource body
OAuth Discovery response did not match the expected shape. missing: jwks_uri; endpoint issues: [{"field":"jwks_uri","issue":"Missing URL."}].
Evidence
{
"failedStep": "validate",
"steps": [
{
"id": "fetch",
"title": "Fetch discovery resource",
"status": "pass",
"evidence": {
"path": "/.well-known/openid-configuration",
"statusCode": 200,
"contentType": "application/json; charset=utf-8"
}
},
{
"id": "validate",
"title": "Validate resource body",
"status": "fail",
"evidence": {
"valid": false,
"issue": "OAuth Discovery response did not match the expected shape. missing: jwks_uri; endpoint issues: [{\"field\":\"jwks_uri\",\"issue\":\"Missing URL.\"}].",
"compatibleContentType": true,
"missing": [
"jwks_uri"
],
"endpointIssues": [
{
"field": "jwks_uri",
"issue": "Missing URL."
}
],
"issuer": "https://mcp.mintlify.com",
"authorizationEndpoint": "https://mcp.mintlify.com/oauth/authorize",
"tokenEndpoint": "https://mcp.mintlify.com/oauth/token",
"responseTypesSupported": [
"code"
],
"grantTypesSupported": [
"authorization_code",
"refresh_token"
],
"idTokenSigningAlgValuesSupported": [],
"rawExcerpt": "{\"issuer\":\"https://mcp.mintlify.com\",\"authorization_endpoint\":\"https://mcp.mintlify.com/oauth/authorize\",\"token_endpoint\":\"https://mcp.mintlify.com/oauth/token\",\"registration_endpoint\":\"https://mcp.mintlify.com/oauth/register\",\"scopes_supported\":[\"docs:read\",\"docs:write\",\"nav:write\",\"config:write\",\"session:write\",\"deployment:read\",\"deployment:write\",\"members:read\",\"members:write\",\"billing:read\",\"integrations:write\",\"analytics:read\",\"offline_access\"],\"response_types_supported\":[\"code\"],\"grant_types_supported\":[\"authorization_code\",\"refresh_token\"],\"code_challenge_methods_supported\":[\"S256\"],\"token_endpoint_auth_methods_supported\":[\"none\"]}"
},
"issue": "OAuth Discovery response did not match the expected shape. missing: jwks_uri; endpoint issues: [{\"field\":\"jwks_uri\",\"issue\":\"Missing URL.\"}].",
"howToFix": "Publish valid OAuth/OIDC metadata only when the site actually supports OAuth/OIDC. Otherwise omit provider discovery and document any unauthenticated public APIs separately."
},
{
"id": "authorization-endpoint",
"title": "Probe authorization endpoint with an authorization-code request",
"status": "pass",
"evidence": {
"url": "https://mcp.mintlify.com/oauth/authorize?response_type=code&client_id=can-agent-use-scanner&redirect_uri=https%3A%2F%2Fcan-agent-use.invalid%2Foauth%2Fcallback&scope=openid&state=can-agent-use-probe",
"method": "GET",
"statusCode": 302,
"location": "https://app.mintlify.com/api/admin-mcp/oauth/authorize?response_type=code&client_id=can-agent-use-scanner&redirect_uri=https%3A%2F%2Fcan-agent-use.invalid%2Foauth%2Fcallback&scope=openid&state=can-agent-use-probe",
"contentType": "text/plain",
"excerpt": "Redirecting...\n"
},
"howToFix": "Implement an authorization endpoint that can process syntactically valid authorization requests, or remove it from discovery metadata until it exists."
},
{
"id": "authorization-redirect-safety",
"title": "Reject unregistered authorization redirects",
"status": "pass",
"evidence": {
"url": "https://mcp.mintlify.com/oauth/authorize?response_type=code&client_id=can-agent-use-unknown-client&redirect_uri=https%3A%2F%2Fcan-agent-use.invalid%2Fattacker-callback&scope=openid&state=can-agent-use-redirect-safety",
"method": "GET",
"statusCode": 302,
"location": "https://app.mintlify.com/api/admin-mcp/oauth/authorize?response_type=code&client_id=can-agent-use-unknown-client&redirect_uri=https%3A%2F%2Fcan-agent-use.invalid%2Fattacker-callback&scope=openid&state=can-agent-use-redirect-safety",
"redirectedToUntrusted": false,
"contentType": "text/plain",
"excerpt": "Redirecting...\n"
},
"howToFix": "Validate client_id and registered redirect_uri values before redirecting. Return a direct OAuth error for invalid clients or redirect URIs."
},
{
"id": "token-endpoint",
"title": "Probe token endpoint with advertised grant type",
"status": "pass",
"evidence": {
"url": "https://mcp.mintlify.com/oauth/token",
"method": "POST",
"grantType": "authorization_code",
"statusCode": 401,
"oauthError": "invalid_client",
"contentType": "application/json; charset=utf-8",
"excerpt": "{\"error\":\"invalid_client\",\"error_description\":\"Unauthorized\",\"error_uri\":\"https://stytch.com/docs/api/errors/400#unauthorized_client\",\"request_id\":\"request-id-live-1acc613e-3aec-4cc0-95c2-1ff47b89c2a8\",\"status_code\":401}"
},
"howToFix": "Support every advertised grant type enough to return a protocol-appropriate response, or stop advertising unsupported grants."
}
],
"authApplicability": {
"supportsAuth": true,
"score": 6,
"signals": [
{
"source": "link:href",
"weight": 3,
"match": "auth link"
},
{
"source": "visible-text",
"weight": 3,
"match": "sso"
}
]
},
"resourceFetchSucceeded": true
}Agent Ease of UseAuthEmerging recommendation
OAuth Protected Resource
OAuth Protected Resource has an informational finding because the page appears to support authentication.
Informational
Agent Ease of UseAuthEmerging recommendation
OAuth Protected Resource
OAuth Protected Resource has an informational finding because the page appears to support authentication.
Needs attention
OAuth Protected Resource
Issue
Protected resource metadata `resource` did not match the resource identifier used to retrieve it.
Why it matters
Protected Resource metadata tells agents which authorization servers protect an API and how to connect authentication challenges to the right resource.
Check name
OAuth Protected Resource
Score
0/100
Status
informational
Category
Auth
Maturity
Emerging recommendation
Goal
Publish OAuth Protected Resource Metadata so agents can discover how to authenticate.
Result
OAuth Protected Resource has an informational finding because the page appears to support authentication.
Validation steps
Validate protected resource identity
Protected resource metadata `resource` did not match the resource identifier used to retrieve it.
Probe protected API Bearer challenge
No protected route with a 401 Bearer challenge was detected; metadata alone does not prove a protected resource.
Evidence
{
"failedStep": "resource-identity",
"steps": [
{
"id": "fetch",
"title": "Fetch protected resource metadata",
"status": "pass",
"evidence": {
"path": "/.well-known/oauth-protected-resource",
"statusCode": 200,
"contentType": "application/json; charset=utf-8"
},
"howToFix": "Publish /.well-known/oauth-protected-resource JSON."
},
{
"id": "metadata",
"title": "Validate protected resource metadata",
"status": "pass",
"evidence": {
"valid": true,
"compatibleContentType": true,
"hasResource": true,
"authorizationServerCount": 1,
"resource": "https://mcp.mintlify.com",
"resourceIssues": [],
"authServerIssues": [],
"scopesSupported": [
"docs:read",
"docs:write",
"nav:write",
"config:write",
"session:write",
"deployment:read",
"deployment:write",
"members:read",
"members:write",
"billing:read",
"integrations:write",
"analytics:read",
"offline_access"
],
"bearerMethodsSupported": [
"header"
],
"rawExcerpt": "{\"resource\":\"https://mcp.mintlify.com\",\"authorization_servers\":[\"https://mcp.mintlify.com\"],\"bearer_methods_supported\":[\"header\"],\"scopes_supported\":[\"docs:read\",\"docs:write\",\"nav:write\",\"config:write\",\"session:write\",\"deployment:read\",\"deployment:write\",\"members:read\",\"members:write\",\"billing:read\",\"integrations:write\",\"analytics:read\",\"offline_access\"]}"
},
"howToFix": "Publish resource and authorization_servers as absolute URLs."
},
{
"id": "resource-identity",
"title": "Validate protected resource identity",
"status": "fail",
"evidence": {
"resource": "https://mcp.mintlify.com",
"expectedResource": "https://www.mintlify.com"
},
"issue": "Protected resource metadata `resource` did not match the resource identifier used to retrieve it.",
"howToFix": "Set `resource` to the origin/resource identifier represented by /.well-known/oauth-protected-resource."
},
{
"id": "protected-route-challenge",
"title": "Probe protected API Bearer challenge",
"status": "informational",
"evidence": {
"checked": [
{
"path": "/api/admin/scans",
"statusCode": 404,
"wwwAuthenticate": {
"valid": false,
"present": false
},
"expectedMetadataUrl": "https://www.mintlify.com/.well-known/oauth-protected-resource",
"metadataUrlMatches": true,
"metadataResource": "https://mcp.mintlify.com",
"resourceMatchesRequestContext": false
},
{
"path": "/api/admin/summary",
"statusCode": 404,
"wwwAuthenticate": {
"valid": false,
"present": false
},
"expectedMetadataUrl": "https://www.mintlify.com/.well-known/oauth-protected-resource",
"metadataUrlMatches": true,
"metadataResource": "https://mcp.mintlify.com",
"resourceMatchesRequestContext": false
},
{
"path": "/api/scans",
"statusCode": 404,
"wwwAuthenticate": {
"valid": false,
"present": false
},
"expectedMetadataUrl": "https://www.mintlify.com/.well-known/oauth-protected-resource",
"metadataUrlMatches": true,
"metadataResource": "https://mcp.mintlify.com",
"resourceMatchesRequestContext": false
}
]
},
"issue": "No protected route with a 401 Bearer challenge was detected; metadata alone does not prove a protected resource.",
"howToFix": "When this site exposes bearer-protected APIs, return 401 with WWW-Authenticate: Bearer and link resource_metadata."
}
],
"authApplicability": {
"supportsAuth": true,
"score": 6,
"signals": [
{
"source": "link:href",
"weight": 3,
"match": "auth link"
},
{
"source": "visible-text",
"weight": 3,
"match": "sso"
}
]
},
"resourceFetchSucceeded": true
}Performance and AccessibilityBest PracticesBrowser audit
Browser errors were logged to the console
50 Fail
Performance and AccessibilityBest PracticesBrowser audit
Browser errors were logged to the console
Check name
Browser errors were logged to the console
Score
0/100
Status
fail
Device
desktop
Category
Best Practices
Fix guidance
Errors logged to the console indicate unresolved problems. They can come from network request failures and other browser concerns. [Learn more about this errors in console diagnostic audit](https://developer.chrome.com/docs/lighthouse/best-practices/errors-in-console/)
Evidence
{
"description": "Errors logged to the console indicate unresolved problems. They can come from network request failures and other browser concerns. [Learn more about this errors in console diagnostic audit](https://developer.chrome.com/docs/lighthouse/best-practices/errors-in-console/)"
}Performance and AccessibilityBest PracticesBrowser audit
Uses deprecated APIs
50 Fail
Performance and AccessibilityBest PracticesBrowser audit
Uses deprecated APIs
Check name
Uses deprecated APIs
Score
0/100
Status
fail
Device
desktop
Category
Best Practices
Estimated savings
1 warning found
Fix guidance
Deprecated APIs will eventually be removed from the browser. [Learn more about deprecated APIs](https://developer.chrome.com/docs/lighthouse/best-practices/deprecations/).
Evidence
{
"displayValue": "1 warning found",
"description": "Deprecated APIs will eventually be removed from the browser. [Learn more about deprecated APIs](https://developer.chrome.com/docs/lighthouse/best-practices/deprecations/)."
}Performance and AccessibilityPerformanceBrowser audit
Document does not have a main landmark.
13 Fail
Performance and AccessibilityPerformanceBrowser audit
Document does not have a main landmark.
Check name
Document does not have a main landmark.
Score
0/100
Status
fail
Device
desktop
Category
Performance
Fix guidance
One main landmark helps screen reader users navigate a web page. [Learn more about landmarks](https://dequeuniversity.com/rules/axe/4.11/landmark-one-main).
References
https://web.dev/learn/performance/Evidence
{
"description": "One main landmark helps screen reader users navigate a web page. [Learn more about landmarks](https://dequeuniversity.com/rules/axe/4.11/landmark-one-main)."
}Performance and AccessibilityPerformanceBrowser audit
Forced reflow
13 Fail
Performance and AccessibilityPerformanceBrowser audit
Forced reflow
Check name
Forced reflow
Score
0/100
Status
fail
Device
desktop
Category
Performance
Fix guidance
A forced reflow occurs when JavaScript queries geometric properties (such as offsetWidth) after styles have been invalidated by a change to the DOM state. This can result in poor performance. Learn more about [forced reflows](https://developer.chrome.com/docs/performance/insights/forced-reflow) and possible mitigations.
References
https://web.dev/learn/performance/Evidence
{
"description": "A forced reflow occurs when JavaScript queries geometric properties (such as offsetWidth) after styles have been invalidated by a change to the DOM state. This can result in poor performance. Learn more about [forced reflows](https://developer.chrome.com/docs/performance/insights/forced-reflow) and possible mitigations."
}Performance and AccessibilityPerformanceBrowser audit
LCP request discovery
13 Fail
Performance and AccessibilityPerformanceBrowser audit
LCP request discovery
Check name
LCP request discovery
Score
0/100
Status
fail
Device
desktop
Category
Performance
Fix guidance
[Optimize LCP](https://developer.chrome.com/docs/performance/insights/lcp-discovery) by making the LCP image discoverable from the HTML immediately, and avoiding lazy-loading
References
https://web.dev/learn/performance/Evidence
{
"description": "[Optimize LCP](https://developer.chrome.com/docs/performance/insights/lcp-discovery) by making the LCP image discoverable from the HTML immediately, and avoiding lazy-loading"
}Performance and AccessibilityPerformanceBrowser audit
Network dependency tree
13 Fail
Performance and AccessibilityPerformanceBrowser audit
Network dependency tree
Check name
Network dependency tree
Score
0/100
Status
fail
Device
desktop
Category
Performance
Fix guidance
[Avoid chaining critical requests](https://developer.chrome.com/docs/performance/insights/network-dependency-tree) by reducing the length of chains, reducing the download size of resources, or deferring the download of unnecessary resources to improve page load.
References
https://web.dev/learn/performance/Evidence
{
"description": "[Avoid chaining critical requests](https://developer.chrome.com/docs/performance/insights/network-dependency-tree) by reducing the length of chains, reducing the download size of resources, or deferring the download of unnecessary resources to improve page load."
}Performance and AccessibilityPerformanceBrowser audit
Reduce unused JavaScript
13 Fail
Performance and AccessibilityPerformanceBrowser audit
Reduce unused JavaScript
Check name
Reduce unused JavaScript
Score
0/100
Status
fail
Device
desktop
Category
Performance
Estimated savings
Est savings of 447Â KiB
Fix guidance
Reduce unused JavaScript and defer loading scripts until they are required to decrease bytes consumed by network activity. [Learn how to reduce unused JavaScript](https://developer.chrome.com/docs/lighthouse/performance/unused-javascript/).
References
https://web.dev/learn/performance/Evidence
{
"displayValue": "Est savings of 447Â KiB",
"description": "Reduce unused JavaScript and defer loading scripts until they are required to decrease bytes consumed by network activity. [Learn how to reduce unused JavaScript](https://developer.chrome.com/docs/lighthouse/performance/unused-javascript/).",
"numericValue": 200
}Performance and AccessibilityPerformanceBrowser audit
Use efficient cache lifetimes
13 Fail
Performance and AccessibilityPerformanceBrowser audit
Use efficient cache lifetimes
Check name
Use efficient cache lifetimes
Score
0/100
Status
fail
Device
desktop
Category
Performance
Estimated savings
Est savings of 602Â KiB
Fix guidance
A long cache lifetime can speed up repeat visits to your page. [Learn more about caching](https://developer.chrome.com/docs/performance/insights/cache).
References
https://web.dev/learn/performance/Evidence
{
"displayValue": "Est savings of 602Â KiB",
"description": "A long cache lifetime can speed up repeat visits to your page. [Learn more about caching](https://developer.chrome.com/docs/performance/insights/cache)."
}Performance and AccessibilityPerformanceBrowser audit
Legacy JavaScript
6 Warning
Performance and AccessibilityPerformanceBrowser audit
Legacy JavaScript
Check name
Legacy JavaScript
Score
50/100
Status
warning
Device
desktop
Category
Performance
Estimated savings
Est savings of 50Â KiB
Fix guidance
Polyfills and transforms enable older browsers to use new JavaScript features. However, many aren't necessary for modern browsers. Consider modifying your JavaScript build process to not transpile [Baseline](https://web.dev/articles/baseline-and-polyfills) features, unless you know you must support older browsers. [Learn why most sites can deploy ES6+ code without transpiling](https://developer.chrome.com/docs/performance/insights/legacy-javascript)
References
https://web.dev/learn/performance/Evidence
{
"displayValue": "Est savings of 50Â KiB",
"description": "Polyfills and transforms enable older browsers to use new JavaScript features. However, many aren't necessary for modern browsers. Consider modifying your JavaScript build process to not transpile [Baseline](https://web.dev/articles/baseline-and-polyfills) features, unless you know you must support older browsers. [Learn why most sites can deploy ES6+ code without transpiling](https://developer.chrome.com/docs/performance/insights/legacy-javascript)"
}Performance and AccessibilityPerformanceBrowser audit
Loading performance
2 Fail
Performance and AccessibilityPerformanceBrowser audit
Loading performance
Check name
Loading performance
Score
82/100
Status
fail
Device
desktop
Category
Performance
Fix guidance
Review the grouped loading performance checks and improve the failing sub-checks listed in evidence.
References
https://web.dev/learn/performance/Evidence
{
"checks": [
{
"id": "largest-contentful-paint",
"title": "Largest Contentful Paint",
"score": 63,
"displayValue": "2.0Â s",
"numericValue": 1987
},
{
"id": "interactive",
"title": "Time to Interactive",
"score": 64,
"displayValue": "3.8Â s",
"numericValue": 3796.654030134984
},
{
"id": "max-potential-fid",
"title": "Max Potential First Input Delay",
"score": 65,
"displayValue": "210Â ms",
"numericValue": 205
},
{
"id": "first-contentful-paint",
"title": "First Contentful Paint",
"score": 100,
"displayValue": "0.4Â s",
"numericValue": 367
},
{
"id": "speed-index",
"title": "Speed Index",
"score": 92,
"displayValue": "1.2Â s",
"numericValue": 1222.8712885408117
},
{
"id": "network-rtt",
"title": "Network Round Trip Times",
"score": 100,
"displayValue": "20Â ms",
"numericValue": 21.653999999999996
},
{
"id": "server-response-time",
"title": "Initial server response time was short",
"score": 100,
"displayValue": "Root document took 40Â ms",
"numericValue": 40
},
{
"id": "total-blocking-time",
"title": "Total Blocking Time",
"score": 70,
"displayValue": "250Â ms",
"numericValue": 245.0012804159344
}
]
}Fix with MCP or CLI
Use this report as the handoff into remediation. Generate a coding-agent prompt with the failing checks attached, or jump to the MCP and CLI setup docs before your next rescan.
Score history
Public scan score over time
Public reports for this website origin. Select any point or report link to open that canonical report.
| Scan date | Score | Readiness | Report |
|---|---|---|---|
| 53/100 | Level 3, Bot-Aware | Current report |