MCP server providing access to Oxylabs web scraping and search tools (Google Search Scraper, Universal Scraper, and others)
Both tools have minimal descriptions (under 100 chars) and lack comprehensive parameter documentation. Input schemas are present but sparse: google_search_scraper has 2 params with basic types; universal_scraper has 3 params with basic types. No output schemas documented. No error handling guidance. Tool names are verb-noun but descriptions are too terse to guide LLM selection. Parameters lack constraints (enums, ranges, format hints). No indication of idempotency, side effects, or retry safety. Schemas lack the depth needed for production agent composition.
Search Google and optionally parse results
Scrape a URL with optional rendering and output format specification
Descriptions are too brief (under 100 chars each). 'Search Google and optionally parse results' and 'Scrape a URL with optional rendering and output format specification' lack WHEN to use, WHAT is returned, and prerequisites. LLMs cannot reliably select between tools or understand side effects.
No output schemas documented. Callers cannot know what fields to expect from google_search_scraper (does it return URLs, titles, snippets, parsed content?) or universal_scraper (markdown structure, metadata, error indicators?). Agents cannot plan downstream tool calls or extract required data.
Parameter descriptions are minimal or missing context. 'parse' is described as 'Whether to parse the results' but does not explain what 'parsed' means (structured JSON? markdown? HTML stripped?). 'output_format' lists examples ('md', 'html') but should use an enum constraint instead. 'render' is vague ('Rendering mode (e.g., 'html' to render JavaScript)'), unclear what values are valid or when to use it.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 43 | 2026-07-28+ | v2 |
No error handling guidance. If google_search_scraper returns zero results, or universal_scraper fails to render a page, what should the agent do? Retry? Call a different tool? Ask the user? No recovery hints provided.
No indication of idempotency or side effects. Are these tools safe to retry? Do they have rate limits? Can they be called multiple times with the same input without duplication? Agents need this information to plan safely.