Crawl, index, and hybrid-search websites; exposed to LLM agents as an MCP server.
Three read-only tools with complete schemas and basic descriptions. Naming follows verb_noun convention (search_, list_, get_). Descriptions are present but brief (34 - 72 chars, below the 194-char baseline). Parameter descriptions are minimal or missing entirely. Output schemas are not documented. Error handling is basic. No tool annotations. The server is functional but lacks LLM-optimization depth.
Fetch the full extracted text of one indexed page by id.
List every indexed page (id, url, title) so an agent can pick one to read in full.
Hybrid (semantic + BM25) search over all crawled documentation. Returns the most relevant chunks with source URLs.
Parameter descriptions missing or incomplete. 'top_k' in search_docs lacks description; 'page_id' in get_doc_page has only 'The unique identifier of the page to retrieve' (generic). LLMs cannot infer valid formats or constraints.
Output schemas not documented. search_docs returns JSON with 'url', 'title', 'score', 'method', 'text' fields, but no schema is provided to the LLM. list_doc_pages and get_doc_page outputs are also undocumented. LLMs cannot plan downstream calls or extract fields reliably.
Tool descriptions are too brief (34 - 72 chars vs. 194-char baseline). 'List every indexed page (id, url, title) so an agent can pick one to read in full' lacks context on when to call this vs. search_docs. No dependency hints or discovery guidance.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 59 | 2026-07-28+ | v2 |
Error handling is minimal. get_doc_page returns 'Page not found' as plain text with isError=true, but does not suggest recovery (e.g., 'Try list_doc_pages() to find valid page IDs'). No error categorization (retryable vs. user-fixable).
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). All three tools are read-only and idempotent, but this is not declared. LLMs cannot optimize retry logic or understand safety properties.