io.github.OneWave-AI/gillby · v1.0.0 · data-and-databases
Gillby is healthy: it completed an MCP handshake in 1006 ms and exposes 96 tools.
Florida marine conditions, forecasts, tides, hazards and coastal places for AI agents.
Endpoint: https://gillby.vercel.app/mcp (streamable-http)
Repository · Website · JSON · Add to my inventory
| Users (last 30 days) | 0 |
| Handshake | Healthy |
| Auth needed | None |
| Tool count | 96 |
| Latency | 1006 ms |
| Last checked (UTC) | 2026-10-18T21:40:38.927Z |
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-10-18T21:40:38.927Z | Healthy | 1006 |
get_health | Rolls up whether the ingest worker is running, which feed families (ndbc, coops, nws, openmeteo, goes19, coastwatch...) have stale sources, government dataset status and the GLM lightning feed. status is ok | degraded | down; HTTP 503 only when down. Check this before trusting 'no data' from other t |
list_spots | Every named South Florida spot the app scores, with its lat/lon, kind, region and the NOAA stations used for it. Use the returned id with conditions, forecast, tides, hazards and briefing tools. include=status adds the current-hour go/caution/nogo band per activity. Use this for a map of verified co |
get_spot | A single spot record plus now.scores (go/caution/nogo per activity for the current hour) when the worker has scored it. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_conditions | The full conditions bundle for a named spot: current waves (ft, s, deg FROM), wind (kt), tide (ft MLLW), water temp (F), activity scores with reasons, 7-day hourly forecast, hi/lo tides, best windows, NWS alerts, rip/red tide/bacteria hazards, lightning and an AI briefing. Kitesurf: kiteboarding con |
get_forecast | Hourly forecast for a spot (or lat+lon) starting at `time` (default now) for `hours` hours: waves, swell/wind-wave split, wind, gusts, tide, current, precip/thunder chance, and go/caution/nogo scores with reasons per activity. Also returns 7 daily score rows and best windows. Units: ft, s, kt, deg F |
get_tides | Predicted high and low tides (ft above MLLW, NOAA CO-OPS) for the next `days` days at a spot or lat+lon, the hourly tide height curve and inlet current (kt, + flood / - ebb), plus sunrise/sunset and moon phase. Times are ISO with the Eastern offset. Interpretation: omit boat unless the user supplied |
get_hazards | Active NWS marine/coastal alerts (small craft, rip current, high surf, special marine, waterspout...) plus water hazards for a spot or lat+lon: rip current risk, red tide (FWC samples), bacteria (FDOH), sargassum, water clarity, king tide, Gulf Stream distance, lightning. Use before recommending swi |
get_briefing | A short headline + <=60-word body written from the live data (numbers validated against the fact sheet; falls back to a template when no model is available). source says claude/openai/template. Rate limited: may call an LLM on a cold cache. Units: ft, kt, s, F, mi; directions FROM. Returns data and |
get_lightning | GOES-19 GLM lightning. With lat+lon: level (clear | watch 10-25 mi | danger < 10 mi in the last 5 min), nearest strike distance (mi) and time, strikes in 15 min, all-clear time (30 min after the last strike within 10 mi), SPC thunder outlook, and the last 30 min of flashes. Without lat/lon: status p |
list_datasets | Index of government datasets (SFWMD discharges, Lake O, USGS, CoastWatch chlorophyll / SST fronts, coral heat, USCG notices, derelicts, MPAs, algae, fish kills, shark research and jellyfish/man-of-war observations) with ok/stale/unavailable status and last-good time. Units: ft, kt, s, F, mi; direct |
get_dataset | The latest payload of one dataset from list_datasets, including sharks and jellyfish. These marine-life records are dated observations, not live beach warnings; no records does not imply absence. bbox filters list datasets; category filters USCG notices (e.g. bridge,hazard); homeZone=true limits dis |
list_boats | Boats with published specs (LOA, beam, draft, deadrise, weight, hull type, fuel, cruise speed) and their sources. Pass a boat id to conditions/forecast/routes for boat-specific comfort and draft. The user's boat is contender-21-open-2008. Units: ft, kt, s, F, mi; directions FROM. Returns data and s |
get_boat | A single boat record from the library. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
plan_route | Chart-aware water routing between from/to spot IDs or lat,lon. Supply a confirmed library boat ID or measured draft, with beam, airDraft, ukc, bridgeMargin and speed overrides in feet/knots. Checks chart depths and tides along the geometry, samples across supplied beam, identifies bridges and restri |
get_my_vessel | Requires OAuth login to your Gillby account. Reads only your saved vessel and route clearance settings. No writes and no other account access. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
plan_my_route | Requires OAuth login. Uses your saved vessel, draft, air draft, speed, under-keel and bridge margins for actual chart routing. Explicit measurements override saved values. Never guesses missing required measurements. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metada |
get_depth | Actual NOAA ENC chart depth and optional DEM depth at a Florida coordinate, with charted hazards, channel context and restriction zones. A point check does not prove clearance along a route. Interpretation: omit boat unless the user supplied or confirmed it. Describe lightning as flashes observed or |
get_shark_research | Published Florida shark research occurrences with observation dates, location uncertainty, source credits and licenses. Historical acoustic detections and tag releases, not live shark tracking or beach warnings. No records does not mean sharks are absent. Use bbox to narrow the published sample; lim |
get_jellyfish_observations | Published Florida jellyfish, box jellyfish and man-of-war observations from OBIS and iNaturalist, with observation dates, uncertainty, observer credits and licenses. Includes official Boca Raton/Fort Lauderdale lifeguard-report links. Community records are not live beach warnings; no sightings does |
get_canal_discharges | Canal discharge and freshwater releases from the published agency dataset, with source and availability. Empty reports do not establish safe conditions. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_lake_okeechobee | Lake Okeechobee stage and releases from the published agency dataset, with source and availability. Empty reports do not establish safe conditions. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_usgs_water | USGS flow, salinity and water temperature from the published agency dataset, with source and availability. Empty reports do not establish safe conditions. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_chlorophyll | Satellite chlorophyll and water color from the published agency dataset, with source and availability. Empty reports do not establish safe conditions. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_temperature_fronts | Satellite sea temperature fronts from the published agency dataset, with source and availability. Empty reports do not establish safe conditions. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_coral_heat | Coral heat stress and bleaching outlook from the published agency dataset, with source and availability. Empty reports do not establish safe conditions. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_navigation_notices | USCG local notices to mariners from the published agency dataset, with source and availability. Empty reports do not establish safe conditions. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_derelict_vessels | Reported derelict vessels from the published agency dataset, with source and availability. Empty reports do not establish safe conditions. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_protected_areas | Marine protected areas from the published agency dataset, with source and availability. Empty reports do not establish safe conditions. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_algae_reports | Reported algae samples from the published agency dataset, with source and availability. Empty reports do not establish safe conditions. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_fish_kills | Reported fish kills from the published agency dataset, with source and availability. Empty reports do not establish safe conditions. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_pollution_notices | Pollution incident notices from the published agency dataset, with source and availability. Empty reports do not establish safe conditions. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_coastal_sensors | SECOORA coastal sensor observations from the published agency dataset, with source and availability. Empty reports do not establish safe conditions. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_park_alerts | Coastal national park alerts and closures from the published agency dataset, with source and availability. Empty reports do not establish safe conditions. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_sargassum_outlook | Sargassum research product availability from the published agency dataset, with source and availability. Empty reports do not establish safe conditions. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
find_marinas | Search published marinas by name or west,south,east,north bbox. Verify access and operating details with the facility. Bridge data is published, not a live clearance calculation. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
find_fuel_docks | Search published fuel docks by name or west,south,east,north bbox. Verify access and operating details with the facility. Bridge data is published, not a live clearance calculation. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
find_boat_ramps | Search published boat ramps by name or west,south,east,north bbox. Verify access and operating details with the facility. Bridge data is published, not a live clearance calculation. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
find_anchorages | Search published anchorages by name or west,south,east,north bbox. Verify access and operating details with the facility. Bridge data is published, not a live clearance calculation. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
find_reefs | Search published reefs by name or west,south,east,north bbox. Verify access and operating details with the facility. Bridge data is published, not a live clearance calculation. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
find_wrecks | Search published wrecks by name or west,south,east,north bbox. Verify access and operating details with the facility. Bridge data is published, not a live clearance calculation. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
find_dive_sites | Search published dive sites by name or west,south,east,north bbox. Verify access and operating details with the facility. Bridge data is published, not a live clearance calculation. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
find_beaches | Search published beaches by name or west,south,east,north bbox. Verify access and operating details with the facility. Bridge data is published, not a live clearance calculation. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
find_waterfront_dining | Search published waterfront restaurants by name or west,south,east,north bbox. Verify access and operating details with the facility. Bridge data is published, not a live clearance calculation. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
find_inlets | Search published inlets by name or west,south,east,north bbox. Verify access and operating details with the facility. Bridge data is published, not a live clearance calculation. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
find_piers | Search published piers by name or west,south,east,north bbox. Verify access and operating details with the facility. Bridge data is published, not a live clearance calculation. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
list_sandbars | Search published sandbars by name or west,south,east,north bbox. Verify access and operating details with the facility. Bridge data is published, not a live clearance calculation. For a named recreational/scored spot such as Lake Boca Sandbar, use list_spots first to get verified coordinates and IDs |
list_bridges | Search published bridges by name or west,south,east,north bbox. Verify access and operating details with the facility. Bridge data is published, not a live clearance calculation. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_water_temperature | Water temperature for a verified spot over the next hours. Includes timestamp, source status and explicit nulls when unavailable. Water temperature is F; atmospheric visibility is mi, not underwater visibility; current sign follows the assigned station convention. Units: ft, kt, s, F, mi; direction |
get_waves | Wave height, period and swell for a verified spot over the next hours. Includes timestamp, source status and explicit nulls when unavailable. Water temperature is F; atmospheric visibility is mi, not underwater visibility; current sign follows the assigned station convention. Units: ft, kt, s, F, m |
get_wind | Wind and gusts for a verified spot over the next hours. Includes timestamp, source status and explicit nulls when unavailable. Water temperature is F; atmospheric visibility is mi, not underwater visibility; current sign follows the assigned station convention. Units: ft, kt, s, F, mi; directions F |
get_rain | Rain probability and accumulation for a verified spot over the next hours. Includes timestamp, source status and explicit nulls when unavailable. Water temperature is F; atmospheric visibility is mi, not underwater visibility; current sign follows the assigned station convention. Units: ft, kt, s, |
get_thunder_forecast | Thunderstorm forecast for a verified spot over the next hours. Includes timestamp, source status and explicit nulls when unavailable. Water temperature is F; atmospheric visibility is mi, not underwater visibility; current sign follows the assigned station convention. Units: ft, kt, s, F, mi; direc |
get_uv_forecast | UV forecast for a verified spot over the next hours. Includes timestamp, source status and explicit nulls when unavailable. Water temperature is F; atmospheric visibility is mi, not underwater visibility; current sign follows the assigned station convention. Units: ft, kt, s, F, mi; directions FROM |
get_visibility | Atmospheric visibility for a verified spot over the next hours. Includes timestamp, source status and explicit nulls when unavailable. Water temperature is F; atmospheric visibility is mi, not underwater visibility; current sign follows the assigned station convention. Units: ft, kt, s, F, mi; dire |
get_air_temperature | Air temperature for a verified spot over the next hours. Includes timestamp, source status and explicit nulls when unavailable. Water temperature is F; atmospheric visibility is mi, not underwater visibility; current sign follows the assigned station convention. Units: ft, kt, s, F, mi; directions |
get_pressure | Air pressure for a verified spot over the next hours. Includes timestamp, source status and explicit nulls when unavailable. Water temperature is F; atmospheric visibility is mi, not underwater visibility; current sign follows the assigned station convention. Units: ft, kt, s, F, mi; directions FRO |
get_cloud_cover | Cloud cover for a verified spot over the next hours. Includes timestamp, source status and explicit nulls when unavailable. Water temperature is F; atmospheric visibility is mi, not underwater visibility; current sign follows the assigned station convention. Units: ft, kt, s, F, mi; directions FROM |
get_chop | Boat ride and chop (use get_chop_history for past trends) for a verified spot over the next hours. Includes timestamp, source status and explicit nulls when unavailable. Water temperature is F; atmospheric visibility is mi, not underwater visibility; current sign follows the assigned station convent |
get_currents | Predicted inlet currents for a verified spot over the next hours. Includes timestamp, source status and explicit nulls when unavailable. Water temperature is F; atmospheric visibility is mi, not underwater visibility; current sign follows the assigned station convention. Units: ft, kt, s, F, mi; di |
get_rip_risk | Rip current risk for a verified spot. Preserve source sample dates and unavailable states. Satellite clarity is a relative index, not measured dive visibility. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_beach_bacteria | Beach bacteria samples for a verified spot. Preserve source sample dates and unavailable states. Satellite clarity is a relative index, not measured dive visibility. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_red_tide | Red tide samples for a verified spot. Preserve source sample dates and unavailable states. Satellite clarity is a relative index, not measured dive visibility. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_water_clarity | Satellite water clarity for a verified spot. Preserve source sample dates and unavailable states. Satellite clarity is a relative index, not measured dive visibility. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_gulf_stream | Approximate Gulf Stream edge for a verified spot. Preserve source sample dates and unavailable states. Satellite clarity is a relative index, not measured dive visibility. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_sargassum | Local sargassum risk for a verified spot. Preserve source sample dates and unavailable states. Satellite clarity is a relative index, not measured dive visibility. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_surf_forecast | NWS surf zone forecast for a verified spot. Preserve source sample dates and unavailable states. Satellite clarity is a relative index, not measured dive visibility. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_king_tide | King tide forecast for a verified spot. Preserve source sample dates and unavailable states. Satellite clarity is a relative index, not measured dive visibility. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
search_pois | Search public marine POIs. Optional cats is a comma-separated category list. Fuel prices and current bridge clearance are not verified. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_poi | Look up a published coastal POI by its exact ID. Does not refresh facility details or calculate live bridge clearance. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
list_cams | Live source links and credits near a spot or coordinate; archived imagery may be unavailable. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_chop_history | Gillby's native 0-10 chop series for up to 31 days, daily mean/max, coverage and 7-day trends. Recorded outputs and historical model reconstructions are identified separately. Never replace these with assistant-defined Calm/Moderate/Rough cutoffs or fabricate gaps. For chop history or trends use get |
get_history | Read stored observations or forecast history for source and var. Forecast source uses forecast:model and requires spot. Maximum window 31 days; up to 1000 points. Latest revision/run wins. Rejected and suspect rows are excluded; unreviewed rows retain quality metadata. For chop history or trends use |
get_marine_alerts | Active and upcoming alerts for a spot, retaining start/end times and source links. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_source_status | Fresh, stale, unavailable and QC-rejected sources used by spot conditions. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_observations | Actual buoy and station observations for a spot with timestamps. These may differ from blended forecast conditions. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_wave_models | Published wave-model series and model spread for a spot; absent models stay unavailable. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_departure_windows | Published best windows filtered by activity. No windows means none were supplied, not a guarantee that every other hour is unsafe. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_activity_scores | Hourly published activity scores with reasons and vetoes. Missing activity scores are unscored. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
compare_spots | Compare current conditions for up to five verified comma-separated spot IDs. Partial failures remain explicit. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
check_route_conditions | Weather and marine conditions at up to five ordered spot IDs. Checks sampled stops only; does not create a navigable route or check depth, bridges, zones, or conditions between stops. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_data_coverage | Published dataset inventory and verified spot coverage; distinguishes unavailable data. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
list_my_places | Read your saved places and favorites. Requires your Gillby account and explicit account consent. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_my_place | Read one saved place. Requires your Gillby account and explicit account consent. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
save_my_place | Save a place or favorite. Supply a unique requestId and reuse it when retrying the same save; reused IDs with different input are rejected. Requires your Gillby account and explicit account consent. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
update_my_place | Update specified saved-place fields. Requires your Gillby account and explicit account consent. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
delete_my_place | Delete a saved place. Repeat deletes return deleted=false. Requires your Gillby account and explicit account consent. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
list_my_trips | Read your saved trips. Requires your Gillby account and explicit account consent. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_my_trip | Read one saved trip. Requires your Gillby account and explicit account consent. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
save_my_trip | Save a trip. Supply a unique requestId and reuse it on retry. Saving does not assess navigation safety. Requires your Gillby account and explicit account consent. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
update_my_trip | Update specified trip fields; this does not recheck route safety. Requires your Gillby account and explicit account consent. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
delete_my_trip | Delete a saved trip. Repeat deletes return deleted=false. Requires your Gillby account and explicit account consent. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_my_settings | Read saved vessel, preferences and notification settings. Missing vessel measurements remain null. Requires your Gillby account and explicit account consent. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
update_my_settings | Update only specified vessel or preference fields. Requires your Gillby account and explicit account consent. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_my_notification_settings | Read notification preferences and actual delivery availability. Requires your Gillby account and explicit account consent. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
update_my_notification_settings | Save notification preferences. Hosted delivery is in-app only; this does not enable push, email or notifications on this AI client. Requires your Gillby account and explicit account consent. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata. |
get_camera_image | Fetch a public camera JPEG with source timestamp metadata for the Gillby panel. Returns image bytes through MCP, without a browser network request. |