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

ID: fcb0da02-2425-4030-8761-27a2bdadc47a

LeaderboardNew Scan
31/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 Optimization11 / 30
Code Block Execution10 / 30
Machine Readability0 / 20
Agent Tooling & MCP10 / 20

Detailed Findings

⚡

Context Optimization

11/30

llms.txt Auto-Discovery

llms-full.txt Consolidated Docs

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 (3% 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

10/20

Model Context Protocol (MCP) Server Integration

↳ AI Agent Fix Prompt
Configure and expose an MCP server definition at /.well-known/mcp.json or publish guidelines showing AI agents how to interact with your APIs using MCP tool declarations.

Error Code Diagnostics & Cross-Referencing Index