Two tools with basic verb-noun naming (get_alerts, get_forecast). Both have short descriptions (47 and 44 chars respectively) that meet minimum but lack context on when to use them or what they return. Input schemas are present with proper types and descriptions. However, output schemas are completely undocumented, tools return plain strings with no structured format guidance. No error handling guidance, no pagination support, no output field documentation. Follows minimal patterns; typical of community STDIO servers.
Get weather alerts for a US state.
Get weather forecast for a location.
No output schema documentation. Both tools return plain strings with no structured format, field names, or type guidance. LLMs cannot parse results reliably or chain to downstream tools.
Descriptions are too brief (35-47 chars, below 50-200 char baseline). Missing context on when to use each tool, what data is returned, and how results differ. LLMs cannot reliably select between tools.
No error handling guidance. Tools return generic 'Unable to fetch' strings with no recovery hints. LLMs cannot determine if errors are retryable, user-fixable, or fatal.
No pagination or result limits documented. get_forecast hardcodes 5 periods; get_alerts may return unbounded results. No limit parameter, no total count, no next_cursor.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 55 | 2026-07-28+ | v2 |
Parameter descriptions lack format/constraint details. 'state' should specify 'Two-letter uppercase US state code (e.g., CA, NY, TX)' with enum or pattern. Latitude/longitude lack range constraints (±90, ±180).