Educational Weather Stats MCP Service — powered by Open-Meteo and monetized via Tollbooth DPYC Bitcoin Lightning micropayments
Three weather tools with complete schemas and reasonable descriptions (120-180 chars each). All parameters have types and descriptions. However, critical issues: (1) npub and dpop_token parameters are marked required in descriptions but have empty string defaults, creating ambiguity about actual requirements; (2) no output schemas documented, LLMs cannot plan downstream operations; (3) error handling absent, no guidance on API failures, invalid coordinates, or date range violations; (4) tool names lack clarity on what distinguishes 'current' from 'forecast' at a glance; (5) parameter descriptions lack constraints (e.g., 'days: 1-16' stated in docstring but not in schema description). Follows basic patterns but falls short of production-grade tool design.
Get current weather conditions for a location. Returns temperature, wind speed, and weather code from Open-Meteo.
Get a multi-day weather forecast for a location. Returns daily high/low temperatures and precipitation for 1-16 days.
Get historical weather data for a location and date range. Returns daily temperature and precipitation from Open-Meteo's archived model runs, at roughly 2 km and covering 2018 onward.
No output schemas documented. LLMs cannot infer what fields are returned (temperature, wind_speed, precipitation, etc.), forcing them to guess downstream field names and breaking tool chaining.
npub and dpop_token parameters marked 'Required' in descriptions but have empty string defaults (''), creating ambiguity. Either make them truly required (no default) or clarify when they are optional.
Parameter constraints stated in docstrings (e.g., 'days: 1-16') but not in schema descriptions. LLMs read descriptions, not docstrings, constraints must be in the parameter description field.
No error handling guidance. No documentation of what happens if coordinates are out of range, dates are invalid, or the Open-Meteo API fails. Agents have no recovery path.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 57 | <=2025-11-25 | v2 |
Tool names 'current', 'forecast', 'historical' are generic and lack verb-noun clarity. 'get_current_weather', 'get_weather_forecast', 'get_historical_weather' would be more discoverable and self-documenting.