Athenium Weather MCP - Documentation

Athenium Weather MCP

The Athenium Model Context Protocol (MCP) server connects large language models (LLMs) directly to enterprise-grade historical weather data. Stop wrestling with scattered weather APIs and inconsistent data quality - our MCP server delivers verified, granular weather observations that you can actually trust within a convenient AI workflow.

Built to the MCP standard, Athenium's weather MCP can connect to any model that accepts MCPs, including ChatGPT, Claude, Gemini, Copilot, Llama, and more.

Why Athenium Weather Data?

  • Conversational weather intelligence: Ask plain-language questions and receive data-driven answers that combine AI reasoning with high-resolution weather observations, forecasts, and climate analytics.
  • Comprehensive data coverage: Access historical weather, real-time observations, forecasts, severe weather analysis, tropical cyclone forecasts, climate normals, and property-level risk assessments.
  • Multi-resolution analysis: Query data at scales from 1km severe weather detection to 15km global forecasts, with specialized 2km CONUS coverage for wind analysis.
  • Intelligent context management: Built-in optimization automatically adjusts response formats based on query complexity, minimizing token usage while preserving analytical depth.
  • Production-ready: Enterprise-grade data with transparent billing and usage tracking.

Access

https://mcp.athenium.com/mcp

Please contact Athenium at customer.support@athenium.com for OAuth credentials or a bearer token.

Athenium MCP Tools

The Athenium MCP provides comprehensive weather, climate, and location intelligence tools powered by various data sources including NOAA, ECMWF, and proprietary Athenium datasets. Each tool provides specific capabilities for weather analysis, risk assessment, and geographic services.

Tool Description
forecast Retrieves weather forecasts with statistical summaries. Powered by Athenium Atlas forecast based on NOAA GFS - provides forecasts out to 7 days globally at 15km CONUS resolution. Supports hourly or daily intervals with customizable field packages (minimal, core, standard).
station_historical_data Enhanced station history with unified field packages and intelligent filtering. Access historical weather data from specific weather stations with flexible temporal filtering (months, days, hours, weekdays, seasons). Supports hourly, daily, or monthly intervals.
gridded_history_15km Unified gridded weather history with intelligent context optimization. Powered by ECMWF ERA5 reanalysis (1-week latency) and NOAA GFS analyses for recent data. Provides gridded coverage with automatic data source selection.
gridded_history_location_2km Enhanced gridded history at 2km resolution. Continental US only. Available for WIND (sustained and gust speeds) and TEMPERATURE (max, min, average) with advanced filtering modes.
precipitation_location Unified precipitation data retrieval with intelligent optimization. Powered by NOAA MRMS (1km), NOAA Stage IV (4km), and NOAA/NASA satellite (8km, global). Supports rainfall, snowfall, and freezing rain analysis.
station_climate_normals Enhanced climate normals. Provides 10 or 30-year climatological baselines for monthly, daily, or hourly intervals. Ideal for seasonal planning and baseline comparisons.
severe_weather_event_location Get high-resolution, post-event severe weather events at specific locations. Continental US only. Covers 7 perils: HAIL, RAINFALL, FREEZING RAIN, SNOWFALL, WIND, HEAT, COLD. Provides ground-truth intensity and precise temporal analysis.
severe_weather_location_1km Enhanced severe weather history at 1km resolution. Continental US only. Available for HAIL and TORNADIC_STORM perils with advanced filtering and threshold capabilities.
severe_weather_history_location Long-term history of severe weather events with intelligent summarization. Continental US only. Tracks HAIL (since June 2015, radar-estimated) and WIND (since January 2017, point-scale measurements) with customizable thresholds.
severe_weather_daily_analysis Nationwide daily digest of severe weather activity. Quick identification of significant severe weather days with state-level statistics, affected areas, and event magnitude analysis. Entry point for detailed analysis.
severe_weather_contours_summary Summary of peril-based contours without overwhelming context. Quick assessment of data availability, intensity distribution, geographic coverage, and severity categorization.
severe_weather_contours_radius Get peril contours within a specified radius of a point. Returns GeoJSON suitable for map visualization with geometry simplification and context optimization options (up to 300km radius).
severe_weather_multiday_area Build time series datasets from daily digest API. Construct multi-day analysis for outbreak pattern analysis, regional comparison, and event ranking within time periods.
severe_weather_multiday_intensity Advanced multiday severe weather analysis using direct S3 access. Comprehensive analysis across date ranges with state filtering, event thresholds, and multiple analysis types (summary, outbreak focus, regional comparison).
severe_weather_spc_reports NOAA Storm Prediction Center local storm reports for ground truth verification. Human-observed reports from trained spotters providing real measurements vs. radar estimates for hail, tornado, or wind events.
active_tropical_cyclones Get active tropical storms from Athenium's BeaconHurricane system. Returns current tropical cyclone activity with forecast initialization and tracking data.
tropical_cyclone_forecast Get tropical cyclone forecast data with intelligent context management. Includes Athenium Hurricane Forecast (Ensemble 888), Athenium Enhanced AI Forecast (Ensemble 999), and model mean tracks with wind, precipitation, and probability forecasts.
generate_hurricane_quicklook Generate interactive HTML hurricane forecast map. Creates color-coded wind probability swaths, category-colored tracks, and interactive tooltips with auto-centering on storm extent. Hosted with pre-signed URLs.
geolocator Enhanced geocoding and reverse geocoding. Powered by Mapbox Search Box API (POIs, landmarks) and Geocoding API (addresses). Supports single or batch processing with proximity biasing and radius filtering.
location_elevation Get elevation data from Athenium Gauge API. Supports single or batch coordinate processing with flexible units (feet, meters, or both).
location_property_data Get comprehensive property data from Athenium Gauge API. Returns property characteristics, tax assessments, market values, lot size, replacement costs, and geographic data including fire station distance.
location_weather_risk Get weather risk scores (0-10 scale) for CONUS locations. Covers 6 perils: HAIL, HURRICANE WIND, HURRICANE SURGE, RAINFALL, TORNADO, WIND. Includes probability distributions, monthly patterns, and severity breakdowns.
location_wildfire_risk Get wildfire risk scores (0-10 scale) for CONUS locations. Provides risk assessment, fire season timing, probability distributions, and historical fire occurrence data.
location_flood_risk Get flood risk scores for continental US locations. Returns river and flash flood risk scores, FEMA flood zone designations, inundation depths for various return periods, and soil drainage characteristics.
station_search Search for weather stations using various criteria. Supports text queries (ICAO codes, cities, countries), coordinate-based searches with radius, and predefined regional searches (midwest, northeast, california, etc.).
station_available_variables Get comprehensive information about available station data variables and field packages. Returns detailed information about field packages, individual variables, and optimization strategies.
generate_severe_weather_quicklook Generate interactive HTML quicklook map for severe weather events. Creates color-coded severity contours with interactive tooltips, zoom/pan controls, and auto-centering. Hosted on S3 with pre-signed URLs for 6 perils.

Support

Billing Model

Athenium MCP uses a transparent, predictable billing structure:

Query-Based Billing

Most historical/time-series tools bill based on data processed, not data returned:

  • 1 credit = 120 lines of data processed
  • Calculated as: date range × interval

Examples:

• 60 days hourly = 1,440 lines = 12 credits
• 30 days daily = 30 lines = 1 credit
• 120 hours hourly = 120 lines = 1 credit

Per-Request Billing

Some tools bill per request/generation:

  • Daily analysis: 1 credit per date
  • Maps/visualizations: 1 credit per map
  • Climate normals: 1 credit per request
  • Station search: 1 credit per search
  • Location services: 1 credit per location

Per-Peril Billing

Severe weather event location: 1 credit per peril per date

  • Multiple perils = multiple credits
  • Example: "HAIL,WIND" on same date = 2 credits

Important Notes

  • Charges apply regardless of whether data is returned (API call cost)
  • Optimization modes don't affect billing (based on query parameters)
  • Batch operations bill per item processed

Coverage Notes

Geographic Coverage

  • Global: 15km gridded forecasts, 8km precipitation
  • US + Canada: 1km/4km precipitation
  • CONUS Only: 2km gridded wind/temp, 1km severe weather, natural hazard risk scores

Temporal Coverage

  • Station historical: Varies by station, often decades
  • ERA5 gridded: 1979-present (1 week lag)
  • Hail detection: June 2015-present
  • Wind detection: January 2017-present
  • Precipitation MRMS: Real-time, hourly updates
  • Forecasts: 7 days out

Error Handling

Common Issues

  • No data available: Tool returns empty result, still charged
  • Coordinates out of bounds: CONUS-only tools reject locations outside coverage
  • Date out of range: Historical tools have minimum dates (varies by peril)
  • Radius too large: Some tools cap search radius (e.g., 5km for hail history)

Recommendations

  • Always check tool documentation for coverage limits
  • Use station_search to find valid station IDs
  • Use severe_weather_daily_analysis to confirm data availability
  • Use severe_weather_contours_summary before fetching full contours

API Status & Uptime

Monitor real-time system performance and historical uptime at our status page. You can:

  • View current operational status of all services
  • Review incident history and postmortems

For immediate assistance during an outage, contact customer.support@athenium.com.

For all other support questions or needs, please contact customer.support@athenium.com.