MCP server for the Webclaw API - web data extraction and lead discovery service
Two tools with minimal documentation. Both have basic descriptions (50-60 chars) and input schemas present but sparse. 'extract' and 'search' lack parameter descriptions entirely, the schema shows only type and top-level description, no per-parameter guidance. No output schema documented. No error handling guidance. Naming is verb-based but generic ('extract', 'search'). No evidence of idempotency, pagination, or composition patterns. Tools appear inferred from API wrapper code rather than explicitly registered with full MCP metadata.
Extract structured data from a website URL using a custom JSON schema
Search the web for listing pages matching a plain-language query
No parameter descriptions. 'url' and 'schema' parameters lack descriptions explaining what values are valid, expected format, or constraints. LLMs cannot infer whether 'schema' expects a JSON object inline or a schema ID.
No output schema documented. Callers do not know what fields 'extract' returns or what structure 'search' produces. This forces LLMs to guess and breaks tool chaining.
No error handling guidance. If extraction fails or search returns no results, the tool provides no recovery hints. LLMs cannot self-correct or retry intelligently.
Generic tool names. 'extract' and 'search' are vague, they do not convey domain (web scraping, lead enrichment) or distinguish from other extraction/search tools. Better names: 'extract_website_data', 'search_listing_pages'.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 44 | 2026-07-28+ | v2 |
No pagination or result limits documented. 'search' accepts 'num_results' but no guidance on max, default, or whether results are paginated. Large result sets risk context window exhaustion.