Server has 5 tools with basic schemas and descriptions, but significant gaps in parameter documentation and output schema clarity. All tools are READ_ONLY (good for safety), but descriptions lack LLM-optimization guidance and parameter constraints are underspecified. No error handling guidance, no pagination support despite tools returning lists, and output schemas are not formally documented. Naming is clear and verb-based (web_search, news_search, image_search, scrape_webpage, fetch_url), but parameter descriptions are minimal. Average tool score: 52/100.
Fetch a URL and extract clean, readable text. Optimized for LLM context - removes HTML, scripts, ads. Use this to read article content from search results.
Search for images using Google Images via Serper API.
Search for recent news articles using Google News via Serper API.
Scrape and extract content from a webpage URL. Returns the page text, title, and metadata.
Search the web using Google via Serper API. Returns organic results, snippets, and links.
Output schemas not documented. Tools return raw API responses (web_search returns Serper JSON, scrape_webpage returns title/text/metadata) but LLM has no formal schema to understand structure. Agents cannot reliably extract fields or plan downstream calls.
Parameter descriptions lack constraints and format guidance. 'num_results' accepts 'number' with no min/max bounds (spec says max 100 but description doesn't enforce it). 'country' and 'language' accept free-form strings with no enum or pattern. LLMs will hallucinate invalid values.
No pagination support. Tools return lists (web_search, news_search, image_search) but accept no limit/offset/cursor parameters. Large result sets will blow context window. Spec requires pagination for list-returning tools.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 50 | 2026-07-28+ | v2 |
No error handling guidance. Code throws generic 'Serper API error: {status}' with no recovery hints. If API fails, LLM has no guidance on retry, fallback, or next steps. Missing pattern:recovery-guide.
Tool descriptions are generic and lack LLM-optimization. 'Search the web using Google via Serper API. Returns organic results, snippets, and links.' does not explain WHEN to use this vs news_search or image_search, or what fields are returned. Baseline: 194 chars avg, these are 80-120 chars.