Weather MCP Server that provides weather alerts and forecasts using the National Weather Service API
Two tools with basic but incomplete definitions. Both have action-verb names (get-alerts, get-forecast) and descriptions present. Input schemas are visible with Zod validation (state length constraint, latitude/longitude bounds). However, descriptions are minimal (under 100 chars), lack context on when to use each tool, and output schemas are not documented. No error handling guidance. Parameters have descriptions but lack detail on expected formats or failure modes. Schemas are present but sparse.
Get weather alerts for a state
Get weather forecast for a location
Output schemas not documented. LLMs cannot predict response structure (fields, types, pagination). Clients must infer from examples or trial-and-error.
Descriptions lack context on when to use each tool and what they return. 'Get weather alerts for a state' does not explain prerequisites (state code format), return structure, or error cases.
No error handling guidance. Tool returns generic 'Failed to retrieve' messages without actionable recovery steps. LLM cannot determine if error is retryable or user-fixable.
Parameter descriptions lack format details. 'Two-letter state code (e.g. CA, NY)' uses example values instead of formal constraints. Latitude/longitude descriptions omit precision or rounding guidance.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 52 | 2026-07-28+ | v2 |
No pagination or result limits documented. If get-alerts returns hundreds of active alerts, response could exhaust context window. No limit parameter or cursor guidance.