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.