Markdown Content Preprocessor - Fetch web pages, extract content, convert to clean Markdown
Single-tool server with solid naming and schema definition. The 'read_website' tool follows verb_noun convention and has a complete JSON Schema with proper type constraints. Description is adequate but could be more specific about LLM-relevant behavior (when to use, dependencies, output format). Parameters are well-typed with min/max bounds. However, output schema is completely undocumented, LLMs cannot see what fields will be returned, violating the 'document output schema' critical check. No error handling guidance; no recovery paths documented. Tool annotations present but underutilized.
Fast, token-efficient web content extraction - ideal for reading documentation, analyzing content, and gathering information from websites. Converts to clean Markdown while preserving links and structure.
Output schema completely undocumented. LLMs cannot plan downstream calls or validate returned fields. The tool returns markdown + metadata but there is no schema definition visible in code or docs.
No error handling guidance in tool description. Tool description lacks recovery paths: what if the URL is invalid? What if the site requires authentication? What if crawling is blocked? LLMs need actionable error strategies.
Tool description does not explicitly state that it modifies external state (caches content, makes network requests). Agents need to know whether calls are safe to retry and what side effects occur.
Parameter 'cookiesFile' path is a security risk if user-provided. No validation mentioned; paths could enable directory traversal. Input validation rules not documented.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | C | 64 | <=2025-11-25 | v2 |
| 2026-03-09 | F | 0 | - | v1 |
Description does not explain the output format or structure. States 'converts to clean Markdown' but does not document returned fields, structure, or when markdown is vs isn't available.