Weather MCP Server that provides weather alerts and forecasts using the National Weather Service API
Two tools with basic schemas and descriptions. Both tools have proper input schemas with type constraints (string length, numeric bounds), which is good. Descriptions are present but minimal (18-27 chars), below the 50-200 char LLM-optimized baseline. No output schemas documented. No error handling guidance. Tool names follow verb_noun pattern correctly. Parameters are typed but lack depth in descriptions.
Get weather alerts for a state
Get weather forecast for a location
Descriptions are too short (18-27 chars). LLM-optimized descriptions should be 50-200 chars and answer WHAT, WHEN, and WHAT IT RETURNS. Current descriptions lack context for tool selection.
No output schemas documented. LLMs cannot plan downstream calls or extract required fields without knowing the response structure. Both tools lack return type documentation.
Parameter descriptions are minimal. 'Two-letter state code (e.g. CA, NY)' is acceptable, but latitude/longitude descriptions lack context on what the forecast covers or how results are structured.
No error handling guidance. If NWS API fails or coordinates are invalid, tools return null silently. LLMs need actionable error messages: 'Invalid coordinates. Latitude must be -90 to 90, longitude -180 to 180.'
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 47 | 2026-07-28+ | v2 |
No pagination or result limits documented. If alerts or forecast periods are large, responses could bloat context. Tools should cap results and document limits in descriptions.