MCP server that provides weather forecasts using Weather.gov API for USA locations
Single tool with critical definition gaps. The tool 'weather_forecast' has a basic description in Portuguese ('Busca previsão do tempo da Weather.gov (USA)') but lacks depth, actionability, and LLM-optimized context. Parameter descriptions are minimal (only field names, no usage guidance). Output schema is entirely undocumented, the tool returns 'any' type with no structure guidance. Error handling returns raw errors without recovery guidance. No tool annotations (readOnlyHint, idempotentHint) despite being read-only. Overall, this is a minimalist implementation that would confuse LLMs about when/how to use it and what to expect back.
Busca previsão do tempo da Weather.gov (USA)
Tool description is minimal (Portuguese text, 52 chars) and lacks actionable context. Missing: WHEN to call (coordinates needed), WHAT it returns (forecast structure), WHAT formats the coordinates accept (decimal vs DMS), and WHY to use this over alternatives.
Input parameters 'lat' and 'lon' are typed as strings but lack format specification. No description of valid range (-90 to +90 for lat, -180 to +180 for lon), precision (decimal places), or error behavior if out of bounds. LLMs may hallucinate invalid coordinates.
Output schema is completely undocumented. Tool returns 'any' type with no schema definition. Callers cannot know what fields to expect (forecast data, temperature, confidence, etc.). No pagination or result limiting documented despite potentially large forecast datasets.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | F | 37 | 2026-07-28+ | v2 |
| 2026-03-09 | F | 24 | - | v1 |
Error handling returns raw API errors without recovery guidance. Example: 'erro na API de clima: <error>' provides no actionable next step for the LLM. Missing: error categorization (retryable vs user-fixable), suggested alternative tools, or validation hints.
No tool annotations despite clear read-only intent. The mcp.Tool definition omits readOnlyHint=true, leaving clients unable to optimize caching or execution order. The risk field in metadata says 'READ_ONLY' but this is not expressed in the schema.
Tool description is in Portuguese, not English. MCP tooling ecosystem defaults to English. Multilingual descriptions require explicit locale negotiation not present here.