io.github.outdoorithm/outdoorithm

create_alert

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.

list_alerts

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.

toggle_alert

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.

delete_alert

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.

build_packing_list

Generate a context-aware packing checklist for a camping trip. Returns categorized items from the gear catalog, adjusted for campground amenities, activities, weather, and group size. Args: campground_id: Optional CUID to personalize based on campground amenities trip_type: car_camping, backpacking, rv, or glamping (default car_camping) season: spring, summer, fall, or winter (optional) adults: Number of adults (default 2) children: Number of children (default 0) has_pets: Whether bringing pets (default false) activities: Planned activities (hiking, fishing, swimming, kayaking, biking, beach) nights: Number of nights (default 2)

calculate_drive_times

Calculate realistic drive times from an origin to multiple campgrounds using Mapbox routing with live traffic. Uses the Mapbox Matrix API for traffic-aware routing. Maximum 9 destinations per request. Args: origin_latitude: Latitude of starting location origin_longitude: Longitude of starting location destinations: List of {campground_id: str, latitude: float, longitude: float} (max 9)

check_availability

Check real-time campground availability for specific dates. Queries the camply-service to check live campsite availability against reservation systems. Supports 30+ providers including RecreationDotGov, ReserveCalifornia, state parks, and county parks. Args: campground_id: Campground CUID (e.g., "ReserveCalifornia:uuid:725") start_date: Check-in date in YYYY-MM-DD format end_date: Check-out date in YYYY-MM-DD format min_nights: Minimum consecutive nights required (1-7, default 1)

check_safety

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_gear

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)

find_similar_campgrounds

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_campground_details

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_gear_for_campground

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_weather

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)

prepare_reservation

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.

search_campgrounds

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_gear

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)

health_check

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

No parameters.