Scan Results: https://platform.claude.com/docs
Vanity URL: scan.glintbase.xyz/platform-scan
37/100
Agent Readiness Score
Legacy Docs (Invisible)
Invisible to AI agents. Severe context noise, non-functional code, or zero discoverable specifications.
Category Breakdown
Context Optimization21 / 30
Code Block Execution16 / 30
Machine Readability0 / 20
Agent Tooling & MCP0 / 20
Detailed Findings
⚡
Context Optimization
21/30
llms.txt Auto-Discovery
llms-full.txt Consolidated Docs
Markdown Content Negotiation (Accept: text/markdown)
DOM Cleanliness Ratio (1% markdown/HTML)
↳ AI Agent Fix Prompt
Reduce layout boilerplate (header, footers, scripts) or use Markdown Content Negotiation to strip DOM noise.
🔧
Code Block Execution
16/30
Terminal Prompt Pollution (No "$" prefixes in copyable code)
Dependency & Import Completeness
↳ AI Agent Fix Prompt
Review every code example in my documentation. For each snippet, ensure it is fully self-contained and executable. Every code block must include: 1. All import / require statements at the top 2. Package installation command in a comment 3. Authentication initialization if the code makes API calls 4. All variables defined before use — no undefined references 5. Inline comments explaining WHY each step is done, not just what An AI agent copying this snippet must be able to run it without searching for any additional information. Details: Missing installation commands for the 'anthropic' library. The code assumes the package is already installed but does not include 'pip install anthropic' or equivalent
Dynamic Variable Placeholders
↳ AI Agent Fix Prompt
Replace vague variable hints or hardcoded keys with clean, uppercase environment placeholders (e.g. <YOUR_API_KEY> or process.env.YOUR_API_KEY). Details: API key credential handling is ambiguous. The client is initialized without explicit API key parameters, but no placeholder is provided for the expected 'api_key' parameter which should be passed to Anthropic() constructor
🔍
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
0/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
↳ AI Agent Fix Prompt
Provide a comprehensive table or section listing error codes, their causes, and solutions. This lets agents cross-reference error stacks and resolve integration errors automatically.