Scan Results: https://docs.mapbox.com

Vanity URL: scan.glintbase.xyz/mapbox-scan

LeaderboardNew Scan
36/100
Agent Readiness Score

Legacy Docs (Invisible)

Invisible to AI agents. Severe context noise, non-functional code, or zero discoverable specifications.

Share on XLinkedIn

Category Breakdown

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

Detailed Findings

⚡

Context Optimization

6/30

llms.txt Auto-Discovery

llms-full.txt Consolidated Docs

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

Markdown Content Negotiation (Accept: text/markdown)

↳ AI Agent Fix Prompt
My documentation is returning excessive HTML to AI agents.
Implement server-side content negotiation in my app.

When a request includes the header 'Accept: text/markdown',
return ONLY the technical content as clean Markdown.

Strip completely: navigation menus, footers, cookie banners,
sidebar links, breadcrumbs, social sharing buttons,
interactive widgets, and any HTML not containing technical content.

The response should contain only:
- Page title as H1
- Section headings as H2/H3
- Body text
- Code blocks with language tags
- Parameter tables
- No HTML tags, no CSS, no scripts

DOM Cleanliness Ratio (10% markdown/HTML)

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

Code Block Execution

10/30

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

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

Dependency & Import Completeness

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

Dynamic Variable Placeholders

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

Machine Readability

0/20

OpenAPI/Swagger Spec Auto-Discovery

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

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

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

Agent Tooling & MCP

20/20

Model Context Protocol (MCP) Server Integration

Error Code Diagnostics & Cross-Referencing Index

All checks passed — this category is agent-ready.