Weather MCP Server that provides weather alerts and forecasts using the National Weather Service API
Two tools with clear verb-noun naming (get-alerts, get-forecast) and basic parameter schemas using Zod. Descriptions are present but minimal (10-40 chars). Input schemas are properly typed with constraints (lat/lon bounds, state length). However, output schemas are undocumented, LLMs cannot predict response structure. Error handling returns text blobs without actionable guidance. No parameter descriptions beyond the schema constraints. Missing composition guidance (e.g., when to use alerts vs forecast). Typical community server quality.
Get weather alerts for a state
Get weather forecast for a location
Output schemas undocumented. Tools return text blobs; LLMs cannot predict structure or chain calls. No documented return types for alerts or forecast data.
Tool descriptions too brief (10-40 chars). 'Get weather alerts for a state' lacks context on when to use vs get-forecast, what data is returned, or prerequisites. Baseline is 194 chars.
Error responses are generic text ('Failed to retrieve alerts data'). No actionable recovery guidance. LLM cannot distinguish retryable vs fatal errors or what to try next.
Parameter descriptions missing. Schema declares 'state' as 2-letter code but description is in Zod constraint only. LLMs cannot read JSON Schema, they need text descriptions.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 45 | 2026-07-28+ | v2 |
No pagination or result limits documented. If alerts or forecast returns 100+ items, response bloats context window. No limit parameter or guidance on max results.