Two tools with minimal documentation. get_tutorial_summary has no parameters but lacks depth in description (returns static text, not actionable). somar has proper parameter types and descriptions but both tools lack output schema documentation. No error handling, no composition guidance, no security considerations. Descriptions are present but generic. Parameter descriptions for somar are adequate (72 chars avg baseline met), but tool descriptions fall short of LLM-optimization standards (10-1024 char range; both are under 100 chars, losing context).
Returns the summary of an MCP Server Tutorial
Soma dois números inteiros e retorna o resultado.
No output schemas documented for either tool. LLMs cannot plan downstream calls or extract structured data without knowing return types.
get_tutorial_summary description is too generic (47 chars). Does not explain WHEN to use it, WHAT it returns, or WHY an LLM should call it. Lacks actionable context.
No error handling or recovery guidance. If somar receives non-integer input or somar fails, the LLM has no guidance on what to do next.
get_tutorial_summary returns unstructured multi-line text. Should return structured JSON with fields (e.g., title, steps, prerequisites) so LLMs can extract and compose data.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 43 | 2026-07-28+ | v2 |
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). Both tools are read-only but this is not declared in the schema.