io.github.outdoorithm/outdoorithm

Check campgrounds for safety issues, community atmosphere, and active alerts. Checks: - Greenbook community safety (vibe scores, discrimination reports, flag status) - Active campground alerts (closures, restrictions) from enriched data - Red flag detection (prevents recommending unsafe campgrounds) Args: campground_ids: List of campground CUIDs to check

Compare 2-3 gear items side-by-side with specs, pros/cons, verdicts, and comparison summary. Supports lookup by unique_id with slug fallback. Use search_gear first if the user hasn't named specific products. Args: gear_ids: List of 2-3 gear item identifiers (unique_id or slug)

Create a campsite availability alert that monitors for openings and notifies the user. Requires an Outdoorithm API key (generate at outdoorithm.com/dashboard/api-keys). The alert runs continuously, checking every 2-15 minutes depending on subscription tier. Args: api_key: User's Outdoorithm API key from their dashboard settings. campground_ids: List of campground CUIDs to monitor. All must use the same reservation provider. Get CUIDs from search_campgrounds or get_campground_details. Example: ["RecreationDotGov:232447:2991"] start_date: Earliest check-in date to monitor (YYYY-MM-DD). Required for all date types. end_date: Latest check-out date (YYYY-MM-DD). Required when date_type is "range". date_type: How dates are interpreted. "range" monitors a specific date window (default), "perpetual" monitors rolling 6 months from start_date, "specific_months" monitors only certain months each year. specific_months: Month numbers 1-12 to monitor. Required when date_type is "specific_months". min_nights: Minimum consecutive nights needed (1-14, default 1). max_nights: Maximum consecutive nights (1-14, must be >= min_nights). Omit for no max. days_of_week: Preferred check-in days as integers (0=Monday through 6=Sunday). Omit for any day. notify_email: Send email when availability found (default true). notify_sms: Send SMS when availability found (default false, requires phone on account). name: Display name for this alert. Auto-generated from campground and dates if omitted.

Permanently delete a campsite availability alert. This cannot be undone. All associated notification history will also be deleted. Consider using toggle_alert to pause instead of deleting. Requires an Outdoorithm API key (generate at outdoorithm.com/dashboard/api-keys). Args: api_key: User's Outdoorithm API key from their dashboard settings. alert_id: UUID of the alert to delete. Get this from list_alerts.

Find campgrounds similar to a given campground using vector embedding similarity. Uses pre-computed embeddings combining review text (semantic) and structured attributes (amenities, terrain, activities) for nuanced similarity matching. Args: campground_id: CUID of the target campground to find similar ones for result_limit: Number of results (1-50, default 20) max_distance_km: Optional max distance in km (omit for nationwide search) semantic_weight: Weight for text/review similarity (0-1, default 0.6) structured_weight: Weight for attribute similarity (0-1, default 0.4)

Get comprehensive details for a specific campground including amenities, reviews, safety, and seasonal ratings. Returns ~80 curated fields (not the raw 214-column dump) including: - Identity, location, fees, site info - All amenity and activity booleans + descriptions - Review summaries, best campsites, common complaints, tips - Greenbook community safety (vibe score, flag status) - Seasonal LLM ratings (spring/summer/fall/winter) - Sentiment trend direction - Hero image with credits Note: a missing or empty field is a data gap, not proof a feature is absent. Do not tell the user a feature, trail, or amenity "doesn't exist" just because it isn't listed here; say it isn't in our records and suggest confirming with the operator. Args: campground_id: Unique campground identifier (CUID format, e.g., "RecreationDotGov:232447:1074")

Get personalized gear recommendations for a specific campground. Returns pre-computed recommendations across slot types: essential (must-have), activity (activity-matched), comfort (nice-to-have), amenity_gap (compensates for missing amenities). Each includes product details and purchase links. Args: campground_id: Campground CUID slot_type: Optional filter — one of essential/activity/comfort/amenity_gap

Get camping-specific 7-day weather forecast with suitability ratings and gear recommendations. Uses the Open-Meteo API (no key required) to provide: - Daily high/low temps, conditions, precipitation, wind - Camping suitability rating per day (excellent/good/fair/poor/not_recommended) - Gear recommendations based on conditions - Safety warnings for extreme weather - Best camping days in the forecast period Args: latitude: Campground latitude longitude: Campground longitude campground_name: Campground name for context (optional) check_in_date: Planned check-in date ISO format (optional) check_out_date: Planned check-out date ISO format (optional)

Check server health and connectivity. Returns: Dictionary with health status including: - status: "healthy" or "unhealthy" - version: Server version - environment: Current environment (dev/staging/prod)

List all campsite availability alerts for an Outdoorithm user. Requires an Outdoorithm API key (generate at outdoorithm.com/dashboard/api-keys). Args: api_key: User's Outdoorithm API key from their dashboard settings. status: Filter by alert status. One of: "active", "paused", "expired", "error", or "permanent_error". Omit to return all alerts.

Prepare a one-tap booking handoff for the user's chosen campground/dates. Returns a pre-filled deep link to the operator's reservation page plus the booking-window context (release date/time, ToS-compliant guidance, alert suggestion) the agent needs to advise the user. Does NOT book on behalf — third-party booking is prohibited by Recreation.gov, ReserveCalifornia, ReserveAmerica, and every other supported public-land operator. Pair with ``check_availability`` first to confirm the dates are reservable and to surface site-specific ``booking_url`` values when available. Args: campground_id: Outdoorithm CUID (e.g. ``RecreationDotGov:232447``). start_date: Check-in date (YYYY-MM-DD). end_date: Check-out date (YYYY-MM-DD). party_size: Optional group size. Surfaced in the user-facing summary; most operators don't accept this in URL params, so it isn't embedded in the deep link.

Execute a read-only SQL query against Outdoorithm's campground and gear database. The query MUST be a SELECT statement with a LIMIT clause (max 50 rows). Only the tables listed below are accessible. AVAILABLE TABLES AND COLUMNS: ## composite_campground_details (PREFERRED — enriched campground view) Identity: cuid, name, state, nearest_city, rec_area_name, seo_slug, latitude, longitude, elevation Quality: avg_sentiment (0-5), review_count, google_total_reviews Sentiment Trends: sentiment_trend_direction ('improving'/'declining'/'stable'), sentiment_trend_change, sentiment_trend_baseline, sentiment_trend_recent Greenbook Safety: greenbook_vibe_score (0-100), greenbook_flag_status ('ok'/'caution'/'yellow_flag'/'red_flag'), greenbook_discrimination_count, greenbook_review_count Seasonal (1-5): best_season, summer_score, fall_score, winter_score, spring_score Experience (1-5 + bool): family_friendly_score, is_family_friendly, solitude_score, is_secluded, adventure_score, is_adventure, relaxation_score, is_relaxation Activity Scores: stargazing_score, has_stargazing, kayaking_score, has_kayaking Terrain (1-5 + bool): mountain_score/is_mountain, forest_score/is_forest, lakeside_score/is_lakeside, riverside_score/is_riverside, beach_score/is_beach, desert_score/is_desert, coastal_score/is_coastal Cell Coverage: cell_coverage_avg, cell_coverage_verizon, cell_coverage_att, cell_coverage_tmobile, cell_coverage_no_signal_pct Pricing: standard_site_fee, fee_low, fee_high Amenities (bool): potable_water, water_hookups, electricity_hookups, sewer_hookups, showers, flush_toilets, vault_toilets, dump_station, camp_store, wifi, cell_phone_service, pets_allowed Camping Types (bool): tent, rv, primitive, group, cabin_lodging, glamping Activities (bool): hiking, fishing, swimming, boating, biking, wildlife_viewing, climbing, beach_activities Features (text): accessibility_features, natural_features_and_scenery, proximity_to_water_features, sites_privacy, sites_size, best_campsites Reviews (text): common_complaints, common_criticisms, positive_highlights, user_reviews_summary, hazards, pet_related_reviews Practical (text): cell_phone_service_description, weather_and_seasons, open_and_closed_season, tips_and_recommendations, hiking_description, fishing_description, swimming_description Reservations: reservable (bool), reservation_platforms (text) ## campground_dimension_scores cuid, dimension_key (hiking_quality/fishing_quality/family_friendliness/etc.), raw_score (1-5), state_percentile (0-1), national_percentile (0-1), activity_mention_count, mention_sentiment_avg, confidence, evidence, state, is_applicable ## campground_community_scores (Greenbook detail) cuid, community_vibe_score (0-100), greenbook_flag_status, total_classified_reviews, discrimination_report_count, severe_discrimination_count, high_discrimination_count, staff_discrimination_count, camper_discrimination_count, friendly_staff_count, unfriendly_staff_count, friendly_campers_count, unfriendly_campers_count, safety_concern_mentions, hostile_symbol_mentions ## campground_details (LEGACY — prefer composite_campground_details) cuid, name, state, avg_sentiment (0-5), review_count ## gear_items Product catalog with "Name", "Price", "Manufacturer", "Weight", "ProductOverview", "Keywords", "RecommendationCategory", unique_id, slug ## campground_gear_recommendations campground_cuid, gear_item_id, slot_type, rank, recommendation_reason, match_score EXAMPLE QUERIES: - SELECT name, state, avg_sentiment FROM composite_campground_details WHERE state = 'CA' AND avg_sentiment >= 4.0 ORDER BY avg_sentiment DESC LIMIT 10 - SELECT cuid, dimension_key, raw_score, state_percentile FROM campground_dimension_scores WHERE dimension_key = 'hiking_quality' AND raw_score >= 4.0 ORDER BY state_percentile DESC LIMIT 20 - SELECT cuid, community_vibe_score, greenbook_flag_status FROM campground_community_scores WHERE greenbook_flag_status = 'ok' AND community_vibe_score >= 70 ORDER BY community_vibe_score DESC LIMIT 20 Args: sql_query: A SELECT query with LIMIT clause (max 50 rows) explanation: Brief description of what you're looking for (for logging)

Search for campgrounds with 40+ filters including location, amenities, activities, and community safety. Requires at least one location constraint: near_location, latitude+longitude, or states. Args: near_location: City, address, or landmark (e.g., "Oakland, CA", "Yosemite") latitude: Latitude coordinate longitude: Longitude coordinate max_distance_miles: Maximum distance from location in miles states: US state codes to filter by (e.g., ["CA", "OR"]) max_price_per_night: Maximum price filter min_price_per_night: Minimum price filter requires_accessibility: Require wheelchair/ADA accessible features requires_water_hookups: Require water hookups requires_electric_hookups: Require electric hookups requires_potable_water: Require potable water requires_showers: Require shower facilities requires_flush_toilets: Require flush toilets requires_dump_station: Require RV dump station prefers_family_friendly: Prefer family-friendly campgrounds prefers_secluded: Prefer secluded/private campgrounds prefers_adventure: Prefer adventure-oriented campgrounds prefers_relaxation: Prefer relaxation-focused campgrounds prefers_quiet: Prefer quiet campgrounds prefers_privacy: Prefer private campsites prefers_lakefront: Prefer lakefront locations prefers_oceanfront: Prefer ocean/beach locations prefers_riverfront: Prefer riverside locations prefers_mountain: Prefer mountain settings prefers_forest: Prefer forested settings prefers_beach: Prefer beach settings prefers_desert: Prefer desert settings prefers_stargazing: Prefer dark sky areas prefers_kayaking: Prefer kayaking access prefers_hiking: Prefer hiking trails prefers_fishing: Prefer fishing access prefers_swimming: Prefer swimming areas prefers_boating: Prefer boating access preferred_season: Preferred season (summer/fall/winter/spring) min_seasonal_score: Minimum seasonal score (1-5) require_greenbook_safe: Only show campgrounds with OK safety status min_greenbook_vibe_score: Minimum community vibe score (0-100) no_discrimination_reports: Exclude campgrounds with discrimination reports requires_cell_coverage: Require cell phone coverage preferred_carrier: Preferred carrier (verizon/att/tmobile) min_cell_coverage_score: Minimum cell coverage score (1-5) min_review_count: Minimum number of reviews min_avg_sentiment: Minimum average sentiment (0-5) sentiment_trending: Filter by trend (improving/stable/declining) only_improving_sentiment: Only show campgrounds with improving reviews camping_type: Camping type (tent/rv/primitive/group/cabin/glamping) allows_pets: Only show pet-friendly campgrounds limit: Maximum results (1-50, default 20)

Search the Outdoorithm gear catalog by keyword, category, price range, kit, necessity, or recommendation tier. Returns matching products with prices, verdicts, and purchase links. For campground-specific recommendations, see get_gear_for_campground. Args: query: Text search across product name, manufacturer, keywords, and description kit_name: Filter by kit (e.g., Basics, Camp Kitchen, Hiking, Cold Weather) category_name: Filter by category (e.g., Shelter, Sleeping Gear, Furniture, Electronics) max_price: Maximum price in USD min_price: Minimum price in USD necessity: Filter by level — Essential, Helpful, or Optional recommendation_tier: Filter by tier — Our Pick, Value Pick, or Comfort Pick limit: Max results (1-20, default 10)

Pause or resume a campsite availability alert. If the alert is active, it will be paused (stops checking for availability). If the alert is paused, it will be resumed (starts checking again). Requires an Outdoorithm API key (generate at outdoorithm.com/dashboard/api-keys). Args: api_key: User's Outdoorithm API key from their dashboard settings. alert_id: UUID of the alert to toggle. Get this from list_alerts.