MCP server for searching documentation across multiple libraries (LangChain, LLamaIndex, OpenAI) using web search and content fetching
Single tool 'get_docs' has a reasonable name and basic description, but critical gaps undermine quality. Description is 106 chars (within 10-1024 range) but lacks WHEN to use it and prerequisites. Input schema is present with two string parameters, but both lack type constraints (no enums for 'library' despite supporting only 3 values). Output is unstructured text with no schema documentation. No error handling guidance, ValueError for unsupported library is raised but not documented. Tool does not follow composition patterns: it combines search + fetch + parse into one call, which is reasonable, but the response is raw concatenated text rather than structured results. No pagination despite potentially returning large documents. Parameters lack format/constraint descriptions (e.g., 'library' should enumerate langchain|openai|llama-index). Baseline: avg tool description 194 chars (this is 106), avg params per tool 4 (this has 2), 100% of A+ tools have documented return types (this has none).
Search the docs for a given query and Library. Supports langchain, openai and llama-index.
No output schema documented. Tool returns raw concatenated text with no structure, forcing LLM to parse unstructured content. Should return array of {url, title, excerpt, relevance} objects.
'library' parameter accepts free-form string but only 3 values are valid (langchain, openai, llama-index). Must declare as enum to prevent hallucinated values and guide LLM selection.
Error handling does not guide recovery. ValueError for unsupported library is raised but not documented in description. Should state: 'If library not found, call with one of: langchain, openai, llama-index'.
Description lacks WHEN to use and prerequisites. Does not explain that SERPER_API_KEY must be set, or that results are limited to 2 pages. Should state: 'Searches documentation sites using Serper API. Requires SERPER_API_KEY env var. Returns up to 2 pages of results.'
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 41 | 2026-07-28+ | v2 |
No pagination or result limits documented. Tool fetches and concatenates text from 2 results without limit on output size, risking context window exhaustion. Should cap output and offer pagination.