MCP server providing market research tools through web scraping: organization search, job vacancies, price lists, reviews, and legal data
WebScout provides 6 tools with basic descriptions and parameter schemas, but falls short of production quality. All tools have descriptions (positive), but they are brief (avg ~80 chars, below the 194-char baseline) and lack actionable guidance for LLM selection. Parameter descriptions exist but are minimal and often repeat the parameter name. No output schemas are documented, LLMs cannot predict response structure. Error handling is absent; tools return JSON strings with minimal guidance on failure modes. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite all being read-only operations. Parameter validation rules are not stated (e.g., max_results bounds, source enum constraints). Tools are well-named (verb_noun pattern) and single-responsibility, but lack the depth needed for confident agent composition.
Получить полную карточку одной организации по URL.
Получить прайс-лист организации из CRM-виджета.
Найти организации на картографических сервисах.
Собрать отзывы об организации.
Найти юридическую информацию об организации.
Найти вакансии на job-платформах.
No output schemas documented. Tools return JSON strings; LLMs cannot predict field names, types, or structure for downstream composition.
Parameter descriptions lack validation rules. 'max_results' has no bounds; 'source' enum values not formally constrained; LLMs may pass invalid values.
No error handling guidance. Tools return JSON error objects with no recovery hints. LLMs cannot determine if errors are retryable or require user intervention.
Tool descriptions are brief (45 - 50 chars) and lack context for LLM selection. No explanation of when to use each tool vs. alternatives or prerequisites.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 53 | 2026-07-28+ | v2 |
No tool annotations. All tools are read-only but lack readOnlyHint annotation. Agents cannot infer safety properties without explicit hints.