A lightweight MCP server that returns news content in carousel/widget format
Single tool with adequate schema but weak descriptions and no error handling. Tool name 'get_news' follows verb_noun convention (+). Input schema is present with proper types and enums for format parameter (+). However, tool description is generic (28 chars, below 34 char p10 baseline), lacks context on when to use it, and provides no guidance on output structure. Parameters lack depth: 'topic' description is minimal (19 chars), 'limit' has no range constraints, and no documentation of what fields are returned. No error handling, no recovery guidance, no output schema documentation. Mock data implementation means tool is non-functional in production. Composition is minimal (single tool) so no chaining concerns, but the tool itself is underdeveloped for agent use.
Get news articles in carousel/card format
Tool description is too short (28 chars) and lacks context. Should explain WHAT it does, WHEN to use it, and what structure is returned. Current: 'Get news articles in carousel/card format', missing output schema, use cases, and prerequisites.
No output schema documented. LLMs cannot plan downstream operations or extract fields without knowing the response structure. Tool returns HTML strings but this is not declared in the tool definition.
Parameter descriptions are minimal. 'topic' (19 chars) and 'limit' (38 chars) lack actionable guidance. 'limit' has no min/max bounds, LLMs could pass 0, -1, or 10000. No constraint documentation.
No error handling or recovery guidance. Tool uses mock data and will always succeed, but production integration will fail silently. No error messages, no retry logic, no fallback behavior documented.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 44 | <=2025-11-25 | v2 |
Tool is non-functional in production. Mock articles are hardcoded; no actual news API integration. Tool will return identical results regardless of topic input, making it useless for real agents.