MCP server for adding index data to a big data platform and retrieving weather forecasts
The server has 3 tools with partial schema coverage but significant gaps in descriptions and parameter documentation. The add_index_data tool has a complete input schema with proper types and descriptions (compliant with production baseline of 100% A+ tools having documented schemas). However, get_alerts and get_forecast lack visible descriptions in the source code provided. All tools lack documented output schemas and error handling guidance. Parameter descriptions in add_index_data are present but generic (e.g., 'Two-letter US state code' for get_alerts is minimal). No tool output format is documented, violating the pattern:tool-description baseline of 100% A+ tools having output documentation. Tool naming follows verb_noun convention (add_, get_) which is positive.
向大数据平台添加指标数据
Get weather alerts for a US state.
Get weather forecast for a location.
Missing or trivial tool descriptions for get_alerts and get_forecast. Descriptions are under 20 characters in source visibility, violating the 10-1024 character baseline for tool descriptions.
No documented output schemas for any tool. The rubric baseline states 100% of A+ tools have documented return types. Tools return string (add_index_data) or inferred results with no schema definition visible in source.
add_index_data lacks error handling guidance. The function returns Dict[str, Any] with potential error fields but no documented error classification (retryable vs user-fixable vs fatal) or recovery suggestions.
Parameter descriptions in get_alerts ('Two-letter US state code') are minimal (under 40 chars baseline for A+ tools). No guidance on valid values, error cases, or what to do if the state is not found.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | F | 41 | <=2025-11-25 | v2 |
| 2026-03-09 | F | 37 | - | v1 |
add_index_data's time_period parameter accepts multiple formats (single time, CSV list, range with ~) but validation and error messages are not visible. Complex input parsing without clear error guidance violates param-validation-rules baseline.
period_type parameter in add_index_data should be declared as an enum constraint (REAL_TIME, MINUTE, HOUR, DAY, MONTH, YEAR) rather than free-form string. Currently accepts string with no enum validation visible, inviting hallucinated values.
No output schema documented for add_index_data. The function docstring is incomplete (truncated in source). Agents cannot infer success/failure structure or what data is returned on error.