Servidor MCP para consultar información del clima utilizando la API Open-Meteo
Single tool 'Weather by ACN' has a clear action verb and reasonable description (Spanish, ~80 chars). Input schema is visible with three parameters (location, days, details) all typed and described. However, critical gaps: (1) output schema is NOT documented, the code shows WeatherResponse interface but tool registration does not expose it to the LLM; (2) parameter descriptions lack constraints (days says '1-7' but no enum/min/max in schema); (3) no error handling guidance, processWeatherRequest returns error objects but tool definition does not explain recovery paths; (4) no tool annotations (readOnlyHint present via Risk: READ_ONLY in metadata, but not in schema); (5) description is in Spanish, limiting LLM understanding in English-first contexts. Baseline: 194 chars avg description (this is ~80), 4 params avg (this has 3, acceptable), 100% of A+ tools document output (this does not).
Obtiene información meteorológica para una ubicación específica
Output schema not documented. Code defines WeatherResponse interface but tool registration does not expose return type to LLM. LLM cannot plan downstream calls or extract fields reliably.
Parameter constraints not enforced in schema. 'days' description says '1-7' but schema lacks minimum/maximum. LLM may pass invalid values (0, 8, 100) that fail at runtime.
Error handling provides no recovery guidance. processWeatherRequest returns error objects but tool definition does not explain what LLM should do next (retry, call search, ask user).
Tool description in Spanish ('Obtiene información meteorológica...') limits LLM understanding in English-first deployments. Should be English or bilingual.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 57 | 2026-07-28+ | v2 |
No tool annotations in schema. Risk metadata (READ_ONLY) exists in repo metadata but not in tool's input schema. LLM cannot see idempotency or safety hints.