# eddy.guide
> Missouri Ozarks float trip planning platform with real-time river conditions, access points, float times, and weather.
> For a version with live river data and conditions, see: ${BASE_URL}/llms-full.txt

## About
Eddy is a free river guide for planning float trips on Missouri's Ozark rivers. It provides live water conditions from USGS gauge stations, detailed access point information, float time calculations based on vessel type and water level, hazard warnings, and weather forecasts. Data is sourced from USGS, NPS, and community reports.

## Rivers Covered
Eddy covers float rivers in Missouri's Ozarks region including the Current River, Jacks Fork, Eleven Point, Meramec, Huzzah Creek, Courtois Creek, Big Piney, Niangua, and Beaver Creek. Each river has detailed access points, hazards, points of interest, and real-time gauge data.

## Key Content Pages
- https://eddy.guide/rivers — Browse all rivers with current conditions
- https://eddy.guide/rivers/{slug} — Individual river page with conditions, access points, float planning
- https://eddy.guide/rivers/{slug}/access/{accessSlug} — Access point details (coordinates, amenities, parking, facilities)
- https://eddy.guide/gauges — Real-time USGS gauge stations with water levels and flow trends
- https://eddy.guide/blog — Float trip guides, safety tips, gear reviews, and river profiles
- https://eddy.guide/about — How Eddy works, FAQ about river conditions and float planning

## Public API
All API endpoints return JSON. AI agents accessing the API programmatically should use the x402 payment protocol (see below).

- GET https://eddy.guide/api/rivers — List all active rivers with current conditions
- GET https://eddy.guide/api/rivers/{slug} — River details with GeoJSON geometry
- GET https://eddy.guide/api/rivers/{slug}/access-points — Access points with coordinates and amenities
- GET https://eddy.guide/api/rivers/{slug}/hazards — Active hazards (dams, rapids, strainers)
- GET https://eddy.guide/api/rivers/{slug}/pois — Points of interest (springs, caves, scenic spots)
- GET https://eddy.guide/api/rivers/{slug}/services — Nearby outfitters, campgrounds, shuttle services
- GET https://eddy.guide/api/conditions/{riverId} — Current water conditions (level, flow, trend)
- GET https://eddy.guide/api/gauges — All gauge stations with latest readings and thresholds
- GET https://eddy.guide/api/gauges/{siteId}/history — Historical gauge readings
- GET https://eddy.guide/api/plan?riverId={id}&startId={id}&endId={id}&vesselTypeId={id} — Calculate a float plan with distance, time, drive-back, hazards
- GET https://eddy.guide/api/vessel-types — Vessel types (canoe, kayak, tube, raft) with speed profiles
- GET https://eddy.guide/api/weather/{riverSlug} — Current weather for a river
- GET https://eddy.guide/api/weather/{riverSlug}/forecast — Weather forecast
- GET https://eddy.guide/api/blog — Published blog posts
- GET https://eddy.guide/api/blog/{slug} — Full blog post content

## Machine-Readable Specifications
- OpenAPI 3.1 spec: https://eddy.guide/api/openapi.json
- MCP Server: https://eddy.guide/api/mcp (Model Context Protocol for AI agent tool use)
- Data Export: https://eddy.guide/api/export/rivers.json (complete dataset for RAG pipelines)

## x402 Payment Protocol
API endpoints are gated for AI agents via the x402 payment protocol. See pricing and payment details at:
- https://eddy.guide/.well-known/x402

Content pages (rivers, blog, gauges, about) are freely accessible to AI crawlers for indexing and grounding.

## Data Freshness
- River conditions: Updated every hour from USGS gauge stations
- Weather: Real-time from weather APIs
- Access points & hazards: Community-maintained, updated as conditions change
- Blog content: Published periodically with guides and seasonal updates

## Contact
Eddy is a community project. Submit feedback or corrections at https://eddy.guide via the feedback form.