AuroraReach

Finds AuroraReach-tracked locations with a currently open/flagged aurora sighting event (status=active), optionally restricted to a country or a lat/lng radius. This is a narrower signal than a forecast score - most places, most of the time, have nothing formally flagged even when their forecast score is reasonable, so an empty result is common and expected, not broken. For "should I go look" or a ranked comparison of nearby options regardless of whether anything is formally flagged, use find_best_viewing_locations instead.

find_active_locations

AuroraReach's opinionated answer to "where nearby should I drive?" - evaluates AuroraReach-tracked locations near an origin using the real forecast engine (same as get_aurora_forecast) for the requested date/time, and returns them ranked with score, conditions, distance, and a `why` explaining how each one compares to the top pick. Bounded to a small number of forecast lookups regardless of radius/limit to avoid excess upstream load. Includes relevant offers by default.

find_best_viewing_locations

AuroraReach's primary forecast tool: returns AuroraReach's own interpreted forecast for a location (not raw upstream NOAA/weather data) - a 0-100 score, a yes/maybe/no recommendation, a heuristic confidence, the best viewing window in the next 24h, cloud/weather impact, darkness/viewing suitability, and the individual signals behind the score. Optionally target a specific future date/time (within AuroraReach's ~3-day coverage window); omit it for the current hour. Includes a few relevant bookable offers by default. Use should_i_go_outside instead for a single opinionated yes/no answer, or plan_aurora_experience for a full evening plan.

get_aurora_forecast

Country-level aurora intelligence: top AuroraReach-tracked locations (ranked by observation/activity volume, the most consistently available popularity signal), an aggregate kp range, `active_sighting_score_range` (null when nothing is currently formally flagged anywhere in the country - that is expected, not broken), a recent community-sighting count, the canonical AuroraReach country page, and (by default) relevant offers. Use this for "where in <country> should I look" or "tell me about aurora in <country>" questions; use find_active_locations or find_best_viewing_locations for a live/forecast-based comparison instead of the observation-based ranking here.

get_country_aurora_summary

Get everything AuroraReach knows about a single location in one call: basic metadata, its current aurora condition/score, a historical sighting-report summary, nearby AuroraReach-tracked locations, a link to the full AuroraReach page for this location (more photos, detail and booking options live there), and (by default) a few relevant bookable offers. Use this for "tell me about <place>" or as a follow-up after search_locations. For a dedicated "can I see it right now" answer use get_current_conditions instead; for the full forward-looking forecast use get_aurora_forecast.

get_location

Returns the structured data behind AuroraReach's map view for a bounded circular area: AuroraReach-tracked locations and their current scores within radius_km of a centre point. Always requires a bounded scope (centre + radius, capped) - never returns an unbounded global dataset. Does not include per-point cloud cover or light pollution (not available at this scale/AuroraReach does not model light pollution) - use get_aurora_forecast for weather-level detail on one location.

get_map_conditions

Surfaces AuroraReach-tracked locations (towns/cities, not individual lookout points or photo spots) near a destination that are historically well-regarded for aurora viewing (ranked by rating and observation volume), plus a count of recent community aurora check-ins nearby as a real-activity signal, with an explicit date range and radius. Never fabricates hotspot data - everything returned already exists in AuroraReach's places/checkins data. Includes relevant offers by default.

get_viewing_hotspots

Returns bookable aurora experiences/tours through AuroraReach's existing commercial offers integration (AuroraReach Partner Services, Viator, GetYourGuide, and AuroraReach's own activity/trip offers). Use this whenever booking/commercial intent is central, e.g. "find me an aurora tour in Levi". Affiliate URLs are AuroraReach's own tracked links, returned unmodified - never reconstruct a direct provider URL. Returns an empty offers array (not an error) when nothing is available. Provide `location` or `country` for relevant results - without either, results reflect the server's own location, not the user's.

get_offers

Returns AuroraReach community check-ins reported specifically at one location within an explicit time window, e.g. to answer "are people actually seeing auroras around Rovaniemi right now?". Only public fields are returned - no private user data or exact device GPS. For a wider area or country-level view use get_recent_checkins instead.

get_location_checkins

Answers "can I see the aurora right now?" for a location - a concise snapshot of AuroraReach's current score, yes/maybe/no recommendation, live aurora activity signals (kp gap, Bz, solar wind), current cloud/visibility conditions, darkness state, the reasoning behind the recommendation, a link to the live AuroraReach page for this location, and (by default) a few relevant bookable offers. For a forward-looking forecast (best time tonight, future dates) use get_aurora_forecast instead.

get_current_conditions