{"openapi":"3.1.0","info":{"title":"Skyward API","version":"0.1.0","description":"Weather, air and sky for the U.S., from public government feeds, composed into decisions.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://skyward.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/skyward/docs"},"termsOfService":"https://connectorbay.com/skyward/terms"},"servers":[{"url":"https://skyward.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/skyward/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/current_conditions":{"post":{"operationId":"current_conditions","summary":"Right now at a U.S. location: temperature (°F/°C), feels-like, humidity, wind, sky, plus this hour's forecast, active","description":"Right now at a U.S. location: temperature (°F/°C), feels-like, humidity, wind, sky, plus this hour's forecast, active\n    alert count and current air quality in one call. Use for \"what's it like outside\" and as the first call for planning.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Where: 'Austin, TX', a ZIP code, a street address, or 'lat,lon'. U.S. only.","examples":["Menlo Park, CA","94025","1600 Pennsylvania Ave NW, Washington, DC","37.44,-122.19"],"title":"Location"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"description":"Latitude, if you have coordinates instead of a place name.","title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"description":"Longitude.","title":"Longitude"}},"title":"current_conditionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/forecast_daily":{"post":{"operationId":"forecast_daily","summary":"The NWS day/night forecast for up to 7 days: highs, lows, precipitation chance, wind and the forecaster's own","description":"The NWS day/night forecast for up to 7 days: highs, lows, precipitation chance, wind and the forecaster's own\n    wording. Use for \"what's the weekend look like\" and trip planning.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Where: 'Austin, TX', a ZIP code, a street address, or 'lat,lon'. U.S. only.","examples":["Menlo Park, CA","94025","1600 Pennsylvania Ave NW, Washington, DC","37.44,-122.19"],"title":"Location"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"description":"Latitude, if you have coordinates instead of a place name.","title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"description":"Longitude.","title":"Longitude"},"days":{"default":5,"description":"How many days ahead (1–7).","maximum":7,"minimum":1,"title":"Days","type":"integer"}},"title":"forecast_dailyArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/forecast_hourly":{"post":{"operationId":"forecast_hourly","summary":"Hour-by-hour temperature, precipitation chance, humidity, dew point, wind and conditions, in local time. Use for","description":"Hour-by-hour temperature, precipitation chance, humidity, dew point, wind and conditions, in local time. Use for\n    timing anything: a commute, a game, a walk, when to close the windows.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Where: 'Austin, TX', a ZIP code, a street address, or 'lat,lon'. U.S. only.","examples":["Menlo Park, CA","94025","1600 Pennsylvania Ave NW, Washington, DC","37.44,-122.19"],"title":"Location"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"description":"Latitude, if you have coordinates instead of a place name.","title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"description":"Longitude.","title":"Longitude"},"hours":{"default":24,"description":"How many hours ahead (1–156).","maximum":156,"minimum":1,"title":"Hours","type":"integer"}},"title":"forecast_hourlyArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/alerts":{"post":{"operationId":"alerts","summary":"Active National Weather Service watches, warnings and advisories for a location, each with the official text,","description":"Active National Weather Service watches, warnings and advisories for a location, each with the official text,\n    what it means in plain English, whether it needs action now, and the first steps. Use whenever safety, travel or\n    outdoor plans could be affected, and whenever a user asks \"is there a warning\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Where: 'Austin, TX', a ZIP code, a street address, or 'lat,lon'. U.S. only.","examples":["Menlo Park, CA","94025","1600 Pennsylvania Ave NW, Washington, DC","37.44,-122.19"],"title":"Location"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"description":"Latitude, if you have coordinates instead of a place name.","title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"description":"Longitude.","title":"Longitude"}},"title":"alertsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/air_quality":{"post":{"operationId":"air_quality","summary":"Current and forecast Air Quality Index from EPA AirNow for the nearest reporting area, with the primary pollutant,","description":"Current and forecast Air Quality Index from EPA AirNow for the nearest reporting area, with the primary pollutant,\n    the official category and EPA's guidance for everyone and for sensitive groups. Use for \"is it safe to be outside\",\n    smoke, ozone, allergies-plus-asthma questions.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Where: 'Austin, TX', a ZIP code, a street address, or 'lat,lon'. U.S. only.","examples":["Menlo Park, CA","94025","1600 Pennsylvania Ave NW, Washington, DC","37.44,-122.19"],"title":"Location"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"description":"Latitude, if you have coordinates instead of a place name.","title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"description":"Longitude.","title":"Longitude"},"sensitive":{"default":false,"description":"True if the person has asthma/lung or heart disease, is a child, older adult, pregnant, or works outdoors.","title":"Sensitive","type":"boolean"}},"title":"air_qualityArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/uv_index":{"post":{"operationId":"uv_index","summary":"Today's peak UV index from the EPA (and the hourly curve when available) with the exposure category and how","description":"Today's peak UV index from the EPA (and the hourly curve when available) with the exposure category and how\n    long unprotected skin takes to burn. Use for sunscreen, kids, beach, hiking and midday plans.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Where: 'Austin, TX', a ZIP code, a street address, or 'lat,lon'. U.S. only.","examples":["Menlo Park, CA","94025","1600 Pennsylvania Ave NW, Washington, DC","37.44,-122.19"],"title":"Location"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"description":"Latitude, if you have coordinates instead of a place name.","title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"description":"Longitude.","title":"Longitude"}},"title":"uv_indexArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/sun_moon":{"post":{"operationId":"sun_moon","summary":"Sunrise, sunset, solar noon, day length, civil/nautical/astronomical twilight, golden hour, moonrise/moonset,","description":"Sunrise, sunset, solar noon, day length, civil/nautical/astronomical twilight, golden hour, moonrise/moonset,\n    moon phase and illumination, next full and new moon, for any date. Computed locally. Use for photography, running\n    before dark, Ramadan/fasting times, stargazing and \"when does it get dark\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Where: 'Austin, TX', a ZIP code, a street address, or 'lat,lon'. U.S. only.","examples":["Menlo Park, CA","94025","1600 Pennsylvania Ave NW, Washington, DC","37.44,-122.19"],"title":"Location"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"description":"Latitude, if you have coordinates instead of a place name.","title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"description":"Longitude.","title":"Longitude"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date as YYYY-MM-DD in the location's local time. Default: today.","examples":["2026-09-23"],"title":"Date"}},"title":"sun_moonArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/best_time_for":{"post":{"operationId":"best_time_for","summary":"Scores every forecast hour for an activity — temperature comfort, rain, wind, humidity, air quality, UV, daylight","description":"Scores every forecast hour for an activity — temperature comfort, rain, wind, humidity, air quality, UV, daylight\n    (or darkness, for stargazing) — and returns the best windows with the reasons, plus what to wear then. Use for\n    \"when should I run tomorrow\", \"is Saturday or Sunday better for the picnic\", \"best time to take photos\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"activity":{"description":"What they want to do: run, walk, dog walk, bike, hike, outdoor dining, picnic, playground, yard work, painting, car wash, photography, stargazing, beach, outdoor workout, kids soccer, grilling — or free text.","examples":["run","walk the dog","paint the fence"],"title":"Activity","type":"string"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Where: 'Austin, TX', a ZIP code, a street address, or 'lat,lon'. U.S. only.","examples":["Menlo Park, CA","94025","1600 Pennsylvania Ave NW, Washington, DC","37.44,-122.19"],"title":"Location"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"description":"Latitude, if you have coordinates instead of a place name.","title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"description":"Longitude.","title":"Longitude"},"window_hours":{"default":36,"description":"How far ahead to look (6–72 hours).","maximum":72,"minimum":6,"title":"Window Hours","type":"integer"},"earliest_hour":{"default":6,"description":"Earliest local hour to consider (0–23).","maximum":23,"minimum":0,"title":"Earliest Hour","type":"integer"},"latest_hour":{"default":21,"description":"Latest local hour to consider (1–24).","maximum":24,"minimum":1,"title":"Latest Hour","type":"integer"},"sensitive":{"default":false,"description":"Person has asthma/lung or heart disease, is a child or older adult (weights air quality and UV more).","title":"Sensitive","type":"boolean"}},"required":["activity"],"title":"best_time_forArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/what_to_wear":{"post":{"operationId":"what_to_wear","summary":"What to wear for a span of time outdoors: feels-like temperature (wind chill / heat index), layers, rain gear, sun","description":"What to wear for a span of time outdoors: feels-like temperature (wind chill / heat index), layers, rain gear, sun\n    protection and a mask if smoke is bad. Use for \"what should the kids wear to school\", \"do I need a jacket tonight\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Where: 'Austin, TX', a ZIP code, a street address, or 'lat,lon'. U.S. only.","examples":["Menlo Park, CA","94025","1600 Pennsylvania Ave NW, Washington, DC","37.44,-122.19"],"title":"Location"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"description":"Latitude, if you have coordinates instead of a place name.","title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"description":"Longitude.","title":"Longitude"},"when":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"now","description":"Local time as 'YYYY-MM-DD HH:MM', or 'now' / 'morning' / 'afternoon' / 'evening' / 'tomorrow morning'.","title":"When"},"hours_out":{"default":2,"description":"How long they'll be out (1–12 h): the answer covers the whole span.","maximum":12,"minimum":1,"title":"Hours Out","type":"integer"}},"title":"what_to_wearArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/rain_timing":{"post":{"operationId":"rain_timing","summary":"When precipitation starts and stops: the next wet and dry windows from the hourly forecast, in local time, with","description":"When precipitation starts and stops: the next wet and dry windows from the hourly forecast, in local time, with\n    peak chances. Use for \"when will it stop raining\", \"do I have time to walk the dog\", \"will the game get rained out\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Where: 'Austin, TX', a ZIP code, a street address, or 'lat,lon'. U.S. only.","examples":["Menlo Park, CA","94025","1600 Pennsylvania Ave NW, Washington, DC","37.44,-122.19"],"title":"Location"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"description":"Latitude, if you have coordinates instead of a place name.","title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"description":"Longitude.","title":"Longitude"},"hours":{"default":24,"description":"How far ahead to look (6–72).","maximum":72,"minimum":6,"title":"Hours","type":"integer"}},"title":"rain_timingArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/week_planner":{"post":{"operationId":"week_planner","summary":"Day-by-day plan for the next 6–7 days: high/low, precipitation, wind, the NWS wording, air quality forecast,","description":"Day-by-day plan for the next 6–7 days: high/low, precipitation, wind, the NWS wording, air quality forecast,\n    active alerts, and — if an activity is given — the best day and hour for it. One call for \"plan my week\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Where: 'Austin, TX', a ZIP code, a street address, or 'lat,lon'. U.S. only.","examples":["Menlo Park, CA","94025","1600 Pennsylvania Ave NW, Washington, DC","37.44,-122.19"],"title":"Location"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"description":"Latitude, if you have coordinates instead of a place name.","title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"description":"Longitude.","title":"Longitude"},"activity":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional: an outdoor activity to rank the days for (see best_time_for).","title":"Activity"}},"title":"week_plannerArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/compare_locations":{"post":{"operationId":"compare_locations","summary":"Side-by-side conditions for several places on one day: high/low, precipitation chance, wind, wording, air quality","description":"Side-by-side conditions for several places on one day: high/low, precipitation chance, wind, wording, air quality\n    and alerts. Use for \"Tahoe or the coast this weekend\", \"which office should I work from\", trip decisions.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"locations":{"description":"2–5 places to compare, e.g. ['Tahoe City, CA', 'Santa Cruz, CA'].","items":{"type":"string"},"maxItems":5,"minItems":2,"title":"Locations","type":"array"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date as YYYY-MM-DD in the location's local time. Default: today.","examples":["2026-09-23"],"title":"Date"}},"required":["locations"],"title":"compare_locationsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/severe_weather_outlook":{"post":{"operationId":"severe_weather_outlook","summary":"The Storm Prediction Center's thunderstorm risk for today, tomorrow and the day after (marginal → high), any","description":"The Storm Prediction Center's thunderstorm risk for today, tomorrow and the day after (marginal → high), any\n    active tropical storms or hurricanes with distance from the location, and current watches/warnings. Use for\n    \"should I worry about storms this week\", travel days, outdoor events.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Where: 'Austin, TX', a ZIP code, a street address, or 'lat,lon'. U.S. only.","examples":["Menlo Park, CA","94025","1600 Pennsylvania Ave NW, Washington, DC","37.44,-122.19"],"title":"Location"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"description":"Latitude, if you have coordinates instead of a place name.","title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"description":"Longitude.","title":"Longitude"}},"title":"severe_weather_outlookArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/tides":{"post":{"operationId":"tides","summary":"High and low tide times and heights from the nearest NOAA tide station (within 150 km), in local time, with the","description":"High and low tide times and heights from the nearest NOAA tide station (within 150 km), in local time, with the\n    best low-tide window for tidepooling or beach walks. Use for beach, fishing, kayaking, clamming, coastal photos.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Where: 'Austin, TX', a ZIP code, a street address, or 'lat,lon'. U.S. only.","examples":["Menlo Park, CA","94025","1600 Pennsylvania Ave NW, Washington, DC","37.44,-122.19"],"title":"Location"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"description":"Latitude, if you have coordinates instead of a place name.","title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"description":"Longitude.","title":"Longitude"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date as YYYY-MM-DD in the location's local time. Default: today.","examples":["2026-09-23"],"title":"Date"},"days":{"default":1,"description":"Days of predictions (1–7).","maximum":7,"minimum":1,"title":"Days","type":"integer"}},"title":"tidesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/earthquakes_nearby":{"post":{"operationId":"earthquakes_nearby","summary":"Recent earthquakes near a location from the USGS: magnitude, distance, depth, time, felt reports. Use for","description":"Recent earthquakes near a location from the USGS: magnitude, distance, depth, time, felt reports. Use for\n    \"was that an earthquake\", \"anything shaking near my parents\", after-shock context.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Where: 'Austin, TX', a ZIP code, a street address, or 'lat,lon'. U.S. only.","examples":["Menlo Park, CA","94025","1600 Pennsylvania Ave NW, Washington, DC","37.44,-122.19"],"title":"Location"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"description":"Latitude, if you have coordinates instead of a place name.","title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"description":"Longitude.","title":"Longitude"},"radius_km":{"default":150,"description":"Search radius in km (10–500).","maximum":500,"minimum":10,"title":"Radius Km","type":"integer"},"days":{"default":7,"description":"Look back this many days (1–30).","maximum":30,"minimum":1,"title":"Days","type":"integer"},"min_magnitude":{"default":2.5,"description":"Minimum magnitude (1.0–7.0).","maximum":7.0,"minimum":1.0,"title":"Min Magnitude","type":"number"}},"title":"earthquakes_nearbyArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/aurora_forecast":{"post":{"operationId":"aurora_forecast","summary":"Chances of seeing the northern lights tonight: NOAA's current aurora probability at your coordinates, the Kp","description":"Chances of seeing the northern lights tonight: NOAA's current aurora probability at your coordinates, the Kp\n    forecast for the next 3 days, whether your latitude is far enough north for that Kp, tonight's cloud cover and\n    moon, and the dark window. Use for \"will I see the aurora tonight\" and geomagnetic storm questions.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Where: 'Austin, TX', a ZIP code, a street address, or 'lat,lon'. U.S. only.","examples":["Menlo Park, CA","94025","1600 Pennsylvania Ave NW, Washington, DC","37.44,-122.19"],"title":"Location"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"description":"Latitude, if you have coordinates instead of a place name.","title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"description":"Longitude.","title":"Longitude"}},"title":"aurora_forecastArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}