MCP server providing weather alerts and forecast tools via National Weather Service API
Single tool 'get-alerts' has a clear verb-noun name and basic schema with Zod validation. However, the description is minimal (47 chars), lacks context on when/why to use it, and does not explain the output structure. Parameter description is adequate but generic. No error handling guidance, no output schema documentation, and the tool returns mock data rather than real API integration. The implementation shows basic competence but falls short of production quality, descriptions are too terse, output structure is undocumented, and error paths are not actionable.
Get weather alerts for a state
Tool description is too short (47 chars) and lacks context. Does not explain what the output contains, when to call it instead of other tools, or what happens on error.
Output schema is not documented. The tool returns a text response with formatted alerts, but LLMs cannot plan downstream calls or extract structured data without knowing the response format.
No error handling guidance. If the API fails or returns no alerts, the tool returns a plain text message. LLMs cannot determine if the error is retryable, user-fixable, or fatal.
Mock API implementation. The tool does not call the real NWS API, it returns hardcoded mock data. This is not production-ready and will not work with real weather data.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 55 | 2026-07-28+ | v2 |
Parameter constraint not fully expressed in description. The Zod schema enforces length=2 and uppercase transform, but the description only mentions 'Two-letter state code' without stating the uppercase requirement or validation behavior.