Be the first to get access to new connectors. Get early access →
ConnectorBay Early access

Skyward — connector documentation

  • MCP endpoint: https://skyward.connectorbay.com/mcp
  • REST API: POST https://skyward.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://skyward.connectorbay.com/openapi.json
  • Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
  • Authentication: none required. An optional Authorization: Bearer <key> raises rate limits.
  • Health: https://skyward.connectorbay.com/health · Tool schemas: https://skyward.connectorbay.com/tools.json
  • Publisher: Unify Dynamics LLC · connectorbay.com/skyward · agent@connectorbay.com

What Skyward is for

Weather apps show numbers. People ask questions: is it safe for my kid to play soccer at 4, when does the rain stop, what do I wear for a 6 am run, is that warning something I act on, will we see the aurora tonight? Skyward answers those from the same public feeds the apps use — the National Weather Service, EPA AirNow, USGS, NOAA — and adds the layer the apps leave to you: an activity-aware comfort score for every forecast hour, feels-like temperatures with what to wear, precipitation start/stop windows, plain-English meaning and first steps for every NWS alert type, EPA's own air-quality guidance for sensitive groups, and sun, moon, tide, earthquake and aurora context.

Everything is read-only. Nothing is stored. No key is required for any source. Coverage: the United States, including Alaska, Hawaii and Puerto Rico; anywhere else returns a clear out_of_coverage error rather than a guess.

Locations

Every tool takes location ("Austin, TX", "94025", a street address, or "37.44,-122.19") or latitude + longitude. Resolution: coordinates → ZIP (zippopotam.us) → bundled GeoNames gazetteer of 7,500 U.S. places → U.S. Census geocoder for street addresses → OpenStreetMap Nominatim for small places. The resolved place, its timezone and how it was resolved come back in every response. Times are local to the location.

Tools

Conditions & forecasts

current_conditions — Right now at a U.S. location: temperature (°F/°C), feels-like, humidity, wind, sky, plus this hour's forecast, active alert count and current air quality in one call. Use for "what's it like outside" and as the first call for planning. Args: location, latitude, longitude.

forecast_daily — The NWS day/night forecast for up to 7 days: highs, lows, precipitation chance, wind and the forecaster's own wording. Use for "what's the weekend look like" and trip planning. Args: location, latitude, longitude, days.

forecast_hourly — Hour-by-hour temperature, precipitation chance, humidity, dew point, wind and conditions, in local time. Use for timing anything: a commute, a game, a walk, when to close the windows. Args: location, latitude, longitude, hours.

alerts — Active National Weather Service watches, warnings and advisories for a location, each with the official text, what it means in plain English, whether it needs action now, and the first steps. Use whenever safety, travel or outdoor plans could be affected, and whenever a user asks "is there a warning". Args: location, latitude, longitude.

Air & sun

air_quality — Current and forecast Air Quality Index from EPA AirNow for the nearest reporting area, with the primary pollutant, the official category and EPA's guidance for everyone and for sensitive groups. Use for "is it safe to be outside", smoke, ozone, allergies-plus-asthma questions. Args: location, latitude, longitude, sensitive.

uv_index — Today's peak UV index from the EPA (and the hourly curve when available) with the exposure category and how long unprotected skin takes to burn. Use for sunscreen, kids, beach, hiking and midday plans. Args: location, latitude, longitude.

sun_moon — Sunrise, sunset, solar noon, day length, civil/nautical/astronomical twilight, golden hour, moonrise/moonset, moon phase and illumination, next full and new moon, for any date. Computed locally. Use for photography, running before dark, Ramadan/fasting times, stargazing and "when does it get dark". Args: location, latitude, longitude, date.

Decisions

best_time_for — Scores every forecast hour for an activity — temperature comfort, rain, wind, humidity, air quality, UV, daylight (or darkness, for stargazing) — and returns the best windows with the reasons, plus what to wear then. Use for "when should I run tomorrow", "is Saturday or Sunday better for the picnic", "best time to take photos". Args: activity, location, latitude, longitude, window_hours, earliest_hour, latest_hour, sensitive.

what_to_wear — What to wear for a span of time outdoors: feels-like temperature (wind chill / heat index), layers, rain gear, sun protection and a mask if smoke is bad. Use for "what should the kids wear to school", "do I need a jacket tonight". Args: location, latitude, longitude, when, hours_out.

rain_timing — When precipitation starts and stops: the next wet and dry windows from the hourly forecast, in local time, with peak chances. Use for "when will it stop raining", "do I have time to walk the dog", "will the game get rained out". Args: location, latitude, longitude, hours.

week_planner — Day-by-day plan for the next 6–7 days: high/low, precipitation, wind, the NWS wording, air quality forecast, active alerts, and — if an activity is given — the best day and hour for it. One call for "plan my week". Args: location, latitude, longitude, activity.

compare_locations — Side-by-side conditions for several places on one day: high/low, precipitation chance, wind, wording, air quality and alerts. Use for "Tahoe or the coast this weekend", "which office should I work from", trip decisions. Args: locations, date.

Hazards & sky

severe_weather_outlook — The Storm Prediction Center's thunderstorm risk for today, tomorrow and the day after (marginal → high), any active tropical storms or hurricanes with distance from the location, and current watches/warnings. Use for "should I worry about storms this week", travel days, outdoor events. Args: location, latitude, longitude.

tides — High and low tide times and heights from the nearest NOAA tide station (within 150 km), in local time, with the best low-tide window for tidepooling or beach walks. Use for beach, fishing, kayaking, clamming, coastal photos. Args: location, latitude, longitude, date, days.

earthquakes_nearby — Recent earthquakes near a location from the USGS: magnitude, distance, depth, time, felt reports. Use for "was that an earthquake", "anything shaking near my parents", after-shock context. Args: location, latitude, longitude, radius_km, days, min_magnitude.

aurora_forecast — Chances of seeing the northern lights tonight: NOAA's current aurora probability at your coordinates, the Kp forecast for the next 3 days, whether your latitude is far enough north for that Kp, tonight's cloud cover and moon, and the dark window. Use for "will I see the aurora tonight" and geomagnetic storm questions. Args: location, latitude, longitude.

Response conventions

  • ok: true with the payload, or ok: false with error.code in bad_input, out_of_coverage, no_monitor, no_station, no_data, upstream_error. On upstream_error the feed was down; say so rather than guessing.
  • degraded: [...] on a successful result means an optional source (air quality, UV, observations) was unreachable.
  • Every response carries attribution. NWS data is public domain; GeoNames is CC BY 4.0; OpenStreetMap is ODbL.
  • Temperatures are °F (°C alongside in daily forecasts); wind mph; heights feet (MLLW); distances km.

Scoring in best_time_for

Each forecast hour starts at 100 and loses points for: temperature outside the activity's ideal band, precipitation chance (weighted per activity), wind above the activity's limit, mugginess (dew point ≥ 65°F), AQI above 50 (weighted; ×1.6 for sensitive people), UV ≥ 6 in daylight, darkness for daylight activities, and, for stargazing, twilight, cloud cover and moonlight. Golden hour adds a bonus for photography. Windows are runs of hours within 15 points of the best. why_not_higher lists what cost points so the agent can explain the trade-off.

Rate limits

Free tier: 60 tool calls per minute and 300 per day per client (agent user id, client id header, or IP). A Pro key raises this to 300/min and 5,000/day. Over the limit returns HTTP 429 with Retry-After. initialize and tools/list are never counted.

Sources

NOAA/NWS api.weather.gov · EPA AirNow public data files (files.airnowtech.org) · EPA Envirofacts UV index · USGS Earthquake Hazards FDSN · NOAA CO-OPS tides and currents · NOAA SWPC planetary K-index and OVATION aurora · NOAA SPC convective outlooks · NHC current storms · U.S. Census Bureau geocoder · zippopotam.us · GeoNames · OpenStreetMap Nominatim. Alert guidance summarises NWS, FEMA and Ready.gov public safety guidance; the alert's own instruction text always takes precedence.