Tool Reference
Complete reference for all Barocline tools.
Forecast & Gridded
| Tool | Title | Description |
|---|
ath_forecast | Forecast Data | 7-day weather forecast (NOAA GFS, 15km CONUS / 30km global). Use geolocator first for coordinates. |
gridded_history_15km | Gridded Weather - Global 15km | Global 15km gridded weather history (ERA5 + NOAA GFS). Use geolocator first for coordinates. |
gridded_history_location_2km | Gridded Weather - CONUS 2km | Preferred tool for CONUS temperature and wind history — higher resolution (2km) and purpose-built |
precipitation_location | Gridded Precipitation | High-resolution precipitation data (1km/4km/8km). Use geolocator first for coordinates. |
Station Observations
| Tool | Title | Description |
|---|
station_climate_normals | Station Data - Climate Normals | 10- or 30-year climate normals. Use station_search first for station IDs, or geolocator for coordinates. |
station_historical_data | Station Historical Data | Historical weather station data. Returns METAR/SYNOP-derived weather observations for a single station. |
station_search | Station Search | Search for weather stations by text, coordinates, or region. Use geolocator first for coordinate searches. |
Severe Weather
| Tool | Title | Description |
|---|
severe_weather_event_location | Storm Data - Multi-Peril Event | Point-scale severe weather events at a CONUS location. Use geolocator first for coordinates. |
severe_weather_history_location | Storm Data - History | Long-term severe weather history at a CONUS point. Use geolocator first for coordinates. |
severe_weather_location_1km | Storm Data - CONUS 1km | 1km CONUS severe weather history (HAIL or TORNADIC_STORM). Use geolocator first for coordinates. |
severe_weather_multiday_area | Storm Data - Area Analysis | Severe weather area/occurrence analysis from state-level daily digests — single day or multi-day. |
severe_weather_multiday_intensity | Storm Data - Intensity Analysis | Severe weather intensity analysis from contour data — single day or multi-day, |
severe_weather_spc_reports | Storm Data - SPC Reports | NOAA SPC ground-truth storm reports. Use to verify radar-derived contour data. One peril per call. |
Tropical Cyclones
| Tool | Title | Description |
|---|
active_tropical_cyclones | Active Tropical Cyclones | Lists tropical cyclones active at a given time. Call first to get storm IDs for tropical_cyclone_forecast. |
generate_hurricane_quicklook | Hurricane Forecast Map | Generates a hurricane forecast map (wind swath + track) as a hosted quicklook page (link). |
tropical_cyclone_forecast | Hurricane Forecast Data | Tropical cyclone forecast track and swath. Use active_tropical_cyclones first for storm IDs. |
Risk Scoring
| Tool | Title | Description |
|---|
location_flood_risk | Flood Risk | Flood risk scores (0-10) for CONUS locations. Use geolocator first for coordinates. |
location_roof_damage_risk_hail | Roof Damage Risk | Estimates roof hail damage risk and expected repair cost for a single location. Requires roofing material, square footage, building year, and roof complexity. Returns a damage risk score, estimated repair cost, and hail exposure metrics. |
location_weather_risk | Weather Risk | Weather risk scores (0-10) for CONUS locations. Use geolocator first for coordinates. |
location_wildfire_risk | Wildfire Risk | Wildfire risk scores (0-10) for CONUS locations. Use geolocator first for coordinates. |
Location Intelligence
| Tool | Title | Description |
|---|
geolocator | Geolocator | Convert addresses/place names to coordinates, or reverse geocode coordinates to addresses. |
location_elevation | Elevation | Gets elevation for one or more locations. Use geolocator first for coordinates. |
Other
| Tool | Title | Description |
|---|
add_hurricane_swath_layer | Add Hurricane Swath Layer | Fetch a hurricane wind or precipitation swath as a map layer dict ready to render on an already-open hurricane map. Swath products exist for the 'official' and 'ai_enhanced' tracks only. Called on-demand from the interactive_map_app iframe when a swath entry in the layer menu is activated; also callable directly. |
add_hurricane_track_layer | Add Hurricane Track Layer | Fetch one hurricane forecast-track ensemble ('official'=Athenium Official, 'ai_enhanced'=AI Enhanced, 'model_means'=per-system model means; legacy numeric codes accepted) as map layer dicts ready to render on an already-open hurricane map. Called on-demand from the interactive_map_app iframe when a track entry in the layer menu is activated; also callable directly. |
add_spc_layer | Add SPC Reports Layer | Fetch SPC ground-truth storm reports for one date + peril and return a map layer dict ready to render. Called on-demand from the interactive_map_app iframe when the user toggles 'Add SPC reports'. |
add_tor_survey_layer | Add NWS Tornado Survey Layer | Fetch NWS post-storm tornado damage survey geometry (damage polygons, tracks, and points) for one date and return map layer dicts ready to render. Called on-demand from the interactive_map_app iframe when the user toggles 'Add NWS Tornado Survey' on a TORNADIC_STORM map. |
data_dictionary | Data Dictionary | What weather data exists for a topic, and which tool serves it. Free, no credits. |
geocode_address | Geocode Address / POI Search | Geocode an address/place name to coordinates, or search points of interest. App-initiated backend for the interactive_map_app search box; also usable directly. `place_type` filters result classes (e.g. 'address,locality,region' for addresses, 'poi' for points of interest); `poi_category` (e.g. 'health_services') searches a POI category instead of free text. Optional proximity biases results toward the current view; `limit` caps results (1-10). |
interactive_map_app | Weather & Hazard Map | Render an INTERACTIVE map (MCP App iframe): severe-weather contours, hurricane tracks, or custom GeoJSON, with pan/zoom, hover popups, legends, POI search, and time sliders. |
load_map_geojson | Load Map GeoJSON | Resolve one weather map's GeoJSON layers server-side and return them to the app UI only. App-initiated companion to `interactive_map_app`: the open call returns params + a geometry-free summary (model-visible); this call delivers the full FeatureCollection geometry to the iframe over the tool bridge so it never enters the model's context. Accepts the same params as `interactive_map_app`. |
set_map_display | Set Map Display | Change what an ALREADY-OPEN interactive map displays without re-opening it: toggle layers from the map's `display.layers` manifest on or off, move the camera, and drive the time slider. Do NOT call this immediately after interactive_map_app to configure the initial view — layer/camera/time seeds belong in that tool's `display_defaults` and `time_defaults` parameters. Use this tool only to change a map that is already open, in response to a new instruction or user interaction. Pass the `session` from the interactive_map_app result (it identifies ONE map). Only `available:true` manifest ids are legal; layers the user toggled themselves (owner:'user' / user_touched:true) are skipped unless `override_user:true` — set that only when the user explicitly asked; the same arbitration guards a user-owned camera (they panned/zoomed) and time state (they scrubbed). `camera` pans/zooms: {"bbox": [w,s,e,n]} or {"center": [lon,lat], "zoom": n} (+ optional animate_ms). `time` drives the slider: any of bin, mode ('hour'|'cumulative'), show_all, playing, speed_ms. Combine for a zoomed animation: camera={"bbox": ...}, time={"playing": true, "mode": "cumulative", "speed_ms": 250}. Call with no changes to read the current display state. For a different date/peril/storm, re-run interactive_map_app instead. Display sessions are ephemeral UI state (recreatable, server-side TTL), not durable user data. |
