Florida marine conditions, forecasts, tides, hazards and coastal places for AI agents.
Model Context Protocol (MCP) Server: io.github.OneWave-AI/gillby
The MCP server io.github.OneWave-AI/gillby provides Florida marine context for AI agents, covering conditions, forecasts, tides, hazards, and coastal places. The description indicates it is oriented around coastal information and marine situational awareness for automated consumers.
🛠️ Key Features
Florida marine conditions
Forecasts
Tides
Hazards
Coastal places
🚀 Use Cases
Supplying AI agents with current and forecast marine conditions
Contextualizing agent behavior with tide and hazard information
Helping agents reference coastal places relevant to Florida waters
⚡ Developer Benefits
Centralized MCP access to marine context described by the server
Clear domain scope focused on Florida marine information
⚠️ Limitations
Only Florida-focused marine context is indicated
No additional capabilities (e.g., tools count, detailed interfaces) are provided in the available data
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 tools. detail=true lists every source.
Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
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 coastal spots: the MCP app panel renders an interactive Florida map with selectable spots, nearby camera markers and conditions. Coordinates are geographic locations, not safe navigation routes.
Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
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.
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 contains rider-specific weather screening and unverified launch status; supply kiteStyle, kiteExperience, kiteMinWindKt and kiteMaxWindKt. No overall kite score or verified launch is implied. Activities: kite, surf, skim (flatland), skim-wave (wave riding), paddle (flatwater paddleboard), sup-surf (SUP surf). Skim scores are absent without shoreline observations; do not substitute other activity scores. Prefer view=summary unless you need every hour. boat=<id> adds boat-specific chop comfort. For an arbitrary lat/lon use get_point_conditions.
Start here for a current spot question with view=summary: this single result includes forecast, tides, scores, advisories, hazards, lightning and source status. Avoid duplicate hazard/tide calls unless a needed detail is absent. For beach questions, sea-model wave heights and NWS breaking-surf heights measure different things; their difference alone is not a forecast conflict. A swim no-go must not be followed by a recommendation to wade.
Interpretation: omit boat unless the user supplied or confirmed it. Describe lightning as flashes observed or not detected in the stated window, never a clear/safe guarantee. Report unavailable/QC-failed sources even when freshness.stale=false; fresh does not mean every source is usable. Model sea height is not breaking surf height. Tide heights at different local MLLW gauges do not establish relative channel depths. High tide is not necessarily slack current. For kitesurfing use get_conditions with kiteStyle (freeride/waves/foil), kiteExperience and rider-supplied kiteMinWindKt/kiteMaxWindKt. Read kiteboarding for weather screening, gust spread and explicitly unverified launch status. Never infer the rider wind range, legal launch access or rescue coverage. Activity keys: kite, surf, skim (flatland), skim-wave (wave riding), paddle (flatwater paddleboard), sup-surf (SUP surf). Skim suitability is unscored without shoreline observations; missing scores must not inherit another activity. Offshore wind can favor surf while increasing paddleboard drift risk. A point depth cannot prove route clearance. Do not invent detection percentages, future readings, vessel ownership, or app settings instructions.
Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
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 FROM, F.
Use one call per spot for a time-window comparison; request only the hours needed. Hourly rows include tide/current and score reasons. Do not infer one inlet has deeper water by comparing local tide heights.
Interpretation: omit boat unless the user supplied or confirmed it. Describe lightning as flashes observed or not detected in the stated window, never a clear/safe guarantee. Report unavailable/QC-failed sources even when freshness.stale=false; fresh does not mean every source is usable. Model sea height is not breaking surf height. Tide heights at different local MLLW gauges do not establish relative channel depths. High tide is not necessarily slack current. For kitesurfing use get_conditions with kiteStyle (freeride/waves/foil), kiteExperience and rider-supplied kiteMinWindKt/kiteMaxWindKt. Read kiteboarding for weather screening, gust spread and explicitly unverified launch status. Never infer the rider wind range, legal launch access or rescue coverage. Activity keys: kite, surf, skim (flatland), skim-wave (wave riding), paddle (flatwater paddleboard), sup-surf (SUP surf). Skim suitability is unscored without shoreline observations; missing scores must not inherit another activity. Offshore wind can favor surf while increasing paddleboard drift risk. A point depth cannot prove route clearance. Do not invent detection percentages, future readings, vessel ownership, or app settings instructions.
Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
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 or confirmed it. Describe lightning as flashes observed or not detected in the stated window, never a clear/safe guarantee. Report unavailable/QC-failed sources even when freshness.stale=false; fresh does not mean every source is usable. Model sea height is not breaking surf height. Tide heights at different local MLLW gauges do not establish relative channel depths. High tide is not necessarily slack current. For kitesurfing use get_conditions with kiteStyle (freeride/waves/foil), kiteExperience and rider-supplied kiteMinWindKt/kiteMaxWindKt. Read kiteboarding for weather screening, gust spread and explicitly unverified launch status. Never infer the rider wind range, legal launch access or rescue coverage. Activity keys: kite, surf, skim (flatland), skim-wave (wave riding), paddle (flatwater paddleboard), sup-surf (SUP surf). Skim suitability is unscored without shoreline observations; missing scores must not inherit another activity. Offshore wind can favor surf while increasing paddleboard drift risk. A point depth cannot prove route clearance. Do not invent detection percentages, future readings, vessel ownership, or app settings instructions.
Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
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 swimming, diving or running an inlet.
Interpretation: omit boat unless the user supplied or confirmed it. Describe lightning as flashes observed or not detected in the stated window, never a clear/safe guarantee. Report unavailable/QC-failed sources even when freshness.stale=false; fresh does not mean every source is usable. Model sea height is not breaking surf height. Tide heights at different local MLLW gauges do not establish relative channel depths. High tide is not necessarily slack current. For kitesurfing use get_conditions with kiteStyle (freeride/waves/foil), kiteExperience and rider-supplied kiteMinWindKt/kiteMaxWindKt. Read kiteboarding for weather screening, gust spread and explicitly unverified launch status. Never infer the rider wind range, legal launch access or rescue coverage. Activity keys: kite, surf, skim (flatland), skim-wave (wave riding), paddle (flatwater paddleboard), sup-surf (SUP surf). Skim suitability is unscored without shoreline observations; missing scores must not inherit another activity. Offshore wind can favor surf while increasing paddleboard drift risk. A point depth cannot prove route clearance. Do not invent detection percentages, future readings, vessel ownership, or app settings instructions.
Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
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 source/freshness metadata.
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 per spot. When the feed is stale, status is null and unavailableReason explains why (never a false 'clear').
Prefer list_spots for named spot coordinates. State no flashes detected in the observed window rather than no lightning exists. Stale/incomplete coverage means unknown. Do not supply detection rates that are absent from this result.
Interpretation: omit boat unless the user supplied or confirmed it. Describe lightning as flashes observed or not detected in the stated window, never a clear/safe guarantee. Report unavailable/QC-failed sources even when freshness.stale=false; fresh does not mean every source is usable. Model sea height is not breaking surf height. Tide heights at different local MLLW gauges do not establish relative channel depths. High tide is not necessarily slack current. For kitesurfing use get_conditions with kiteStyle (freeride/waves/foil), kiteExperience and rider-supplied kiteMinWindKt/kiteMaxWindKt. Read kiteboarding for weather screening, gust spread and explicitly unverified launch status. Never infer the rider wind range, legal launch access or rescue coverage. Activity keys: kite, surf, skim (flatland), skim-wave (wave riding), paddle (flatwater paddleboard), sup-surf (SUP surf). Skim suitability is unscored without shoreline observations; missing scores must not inherit another activity. Offshore wind can favor surf while increasing paddleboard drift risk. A point depth cannot prove route clearance. Do not invent detection percentages, future readings, vessel ownership, or app settings instructions.
Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
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; directions FROM. Returns data and source/freshness metadata.
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 discharges to the home zone; geometry=true includes MPA polygons. 503 when the dataset has never loaded.
Shark, jellyfish and man-of-war records are dated published observations, not live tracking, beach warnings, abundance estimates or swimming-safety scores. Preserve observation dates, uncertainty, attribution and source availability. No records does not mean the animals are absent. Source checked time is not observation time. Man-of-war are siphonophores, not true jellyfish. Local lifeguard links are not ingested current warnings; check the source report date. Never apply NOAA's Chesapeake sea-nettle forecast to Florida.
Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
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 source/freshness metadata.
Requires a free Gillby account (OAuth sign-in). 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 restrictions, checks predicted MHW bridge clearance when data permits, and adds route weather samples. Does not infer saved vessel settings. Supports ordered via stops and a hard corridor=icw constraint. Cold charts may take 110 seconds.
Interpretation: omit boat unless the user supplied or confirmed it. Describe lightning as flashes observed or not detected in the stated window, never a clear/safe guarantee. Report unavailable/QC-failed sources even when freshness.stale=false; fresh does not mean every source is usable. Model sea height is not breaking surf height. Tide heights at different local MLLW gauges do not establish relative channel depths. High tide is not necessarily slack current. For kitesurfing use get_conditions with kiteStyle (freeride/waves/foil), kiteExperience and rider-supplied kiteMinWindKt/kiteMaxWindKt. Read kiteboarding for weather screening, gust spread and explicitly unverified launch status. Never infer the rider wind range, legal launch access or rescue coverage. Activity keys: kite, surf, skim (flatland), skim-wave (wave riding), paddle (flatwater paddleboard), sup-surf (SUP surf). Skim suitability is unscored without shoreline observations; missing scores must not inherit another activity. Offshore wind can favor surf while increasing paddleboard drift risk. A point depth cannot prove route clearance. Do not invent detection percentages, future readings, vessel ownership, or app settings instructions.
Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
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.
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 not detected in the stated window, never a clear/safe guarantee. Report unavailable/QC-failed sources even when freshness.stale=false; fresh does not mean every source is usable. Model sea height is not breaking surf height. Tide heights at different local MLLW gauges do not establish relative channel depths. High tide is not necessarily slack current. For kitesurfing use get_conditions with kiteStyle (freeride/waves/foil), kiteExperience and rider-supplied kiteMinWindKt/kiteMaxWindKt. Read kiteboarding for weather screening, gust spread and explicitly unverified launch status. Never infer the rider wind range, legal launch access or rescue coverage. Activity keys: kite, surf, skim (flatland), skim-wave (wave riding), paddle (flatwater paddleboard), sup-surf (SUP surf). Skim suitability is unscored without shoreline observations; missing scores must not inherit another activity. Offshore wind can favor surf while increasing paddleboard drift risk. A point depth cannot prove route clearance. Do not invent detection percentages, future readings, vessel ownership, or app settings instructions.
Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
Published Florida mahi, blue/white marlin, tarpon and snook evidence: dated NOAA commercial catches and research/community occurrences, source/license credits, coordinate uncertainty, seasonal record counts and configurable 0.25/0.10/0.05/0.02/0.01/0.005-degree heatmap cells. Historical records are not live fish locations, migration tracks, abundance, catch rates or catch probabilities. Sampling/fishing effort is uncorrected; absent records do not establish fish absence. from/to are inclusive YYYY-MM-DD observation dates; month pools all selected years. Source check time is not observation time. Recency weighting defaults to recent: exponential 365-day half-life based on observation dates, not source retrieval. weighting=historical gives equal weights. No upstream downloads on tool calls.
Preserve species, observation dates, source credits, coordinate uncertainty, query coverage, partial/stale flags and fishing-effort bias. Heatmap color is record density, never fish abundance or catch odds. Commercial catches and occurrences must remain distinguishable. No generated migration paths.
Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
Published Florida mahi, blue/white marlin, tarpon and snook evidence: dated NOAA commercial catches and research/community occurrences, source/license credits, coordinate uncertainty, seasonal record counts and configurable 0.25/0.10/0.05/0.02/0.01/0.005-degree heatmap cells. Historical records are not live fish locations, migration tracks, abundance, catch rates or catch probabilities. Sampling/fishing effort is uncorrected; absent records do not establish fish absence. from/to are inclusive YYYY-MM-DD observation dates; month pools all selected years. Source check time is not observation time. Recency weighting defaults to recent: exponential 365-day half-life based on observation dates, not source retrieval. weighting=historical gives equal weights. No upstream downloads on tool calls.
Preserve species, observation dates, source credits, coordinate uncertainty, query coverage, partial/stale flags and fishing-effort bias. Heatmap color is record density, never fish abundance or catch odds. Commercial catches and occurrences must remain distinguishable. No generated migration paths.
Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
Published Florida mahi, blue/white marlin, tarpon and snook evidence: dated NOAA commercial catches and research/community occurrences, source/license credits, coordinate uncertainty, seasonal record counts and configurable 0.25/0.10/0.05/0.02/0.01/0.005-degree heatmap cells. Historical records are not live fish locations, migration tracks, abundance, catch rates or catch probabilities. Sampling/fishing effort is uncorrected; absent records do not establish fish absence. from/to are inclusive YYYY-MM-DD observation dates; month pools all selected years. Source check time is not observation time. Recency weighting defaults to recent: exponential 365-day half-life based on observation dates, not source retrieval. weighting=historical gives equal weights. No upstream downloads on tool calls.
Preserve species, observation dates, source credits, coordinate uncertainty, query coverage, partial/stale flags and fishing-effort bias. Heatmap color is record density, never fish abundance or catch odds. Commercial catches and occurrences must remain distinguishable. No generated migration paths.
Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
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; limit defaults to 20 (maximum 100).
Shark, jellyfish and man-of-war records are dated published observations, not live tracking, beach warnings, abundance estimates or swimming-safety scores. Preserve observation dates, uncertainty, attribution and source availability. No records does not mean the animals are absent. Source checked time is not observation time. Man-of-war are siphonophores, not true jellyfish. Local lifeguard links are not ingested current warnings; check the source report date. Never apply NOAA's Chesapeake sea-nettle forecast to Florida.
Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
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 not establish absence. Man-of-war are siphonophores. Use bbox to narrow the sample; limit defaults to 20 (maximum 100).
Shark, jellyfish and man-of-war records are dated published observations, not live tracking, beach warnings, abundance estimates or swimming-safety scores. Preserve observation dates, uncertainty, attribution and source availability. No records does not mean the animals are absent. Source checked time is not observation time. Man-of-war are siphonophores, not true jellyfish. Local lifeguard links are not ingested current warnings; check the source report date. Never apply NOAA's Chesapeake sea-nettle forecast to Florida.
Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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. This search is for places absent from the spot catalog; avoid repeated searches for an already cataloged spot.
Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
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.
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; directions FROM. Returns data and source/freshness metadata.
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, mi; directions FROM. Returns data and source/freshness metadata.
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 FROM. Returns data and source/freshness metadata.
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, F, mi; directions FROM. Returns data and source/freshness metadata.
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; directions FROM. Returns data and source/freshness metadata.
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. Returns data and source/freshness metadata.
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; directions FROM. Returns data and source/freshness metadata.
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 FROM. Returns data and source/freshness metadata.
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 FROM. Returns data and source/freshness metadata.
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. Returns data and source/freshness metadata.
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 convention.
For chop history or trends use get_chop_history with a verified spot ID. Preserve recorded versus reconstructed provenance, native 0–10 index and labels, coverage and gaps. Never invent assistant-defined rough/calm thresholds or silently substitute wave/wind series for native chop.
Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
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; directions FROM. Returns data and source/freshness metadata.
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.
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.
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.
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.
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.
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.
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.
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 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.
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.
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.
Gillby's native 0-10 chop series: the latest 72 hours publicly, up to 31 days with a free Gillby account (OAuth sign-in); 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_chop_history with a verified spot ID. Preserve recorded versus reconstructed provenance, native 0–10 index and labels, coverage and gaps. Never invent assistant-defined rough/calm thresholds or silently substitute wave/wind series for native chop.
Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
Read stored observations or forecast history for source and var. Forecast source uses forecast:model and requires spot. Public access covers the latest 72 hours; a free Gillby account (OAuth sign-in) allows windows up to 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_chop_history with a verified spot ID. Preserve recorded versus reconstructed provenance, native 0–10 index and labels, coverage and gaps. Never invent assistant-defined rough/calm thresholds or silently substitute wave/wind series for native chop.
Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
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.
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.
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.
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.
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.
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 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.
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.
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.
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 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.
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.
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 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 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.
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.
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.
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.
Florida marine conditions for AI agents. Tides, waves, wind, marine forecasts, hazards, red tide, rip currents, depth-aware boat routing and 84 verified coastal spots, through one remote MCP server and a public HTTP API.
Connect any MCP-compatible agent (Claude, ChatGPT, Cursor, Windsurf, Claude Code) to Gillby, a guide to Florida water. Public data needs no API key, no login, no signup: point your agent at https://gillby.vercel.app/mcp and ask.
The Gillby coastal panel inside an AI assistant, showing spots across Florida on a map
Why Gillby exists
I'm newer to boating. I'm not from Florida, but I've been down here for years. My wife said it first: it was way too hard to get a good read on the weather without checking five different things, and when we asked an AI, it didn't have good answers on its own.
So I built Gillby. It's a hobby and a passion project: one map and one clock for a day on Florida water, plus this MCP server so your assistant can answer from real water data instead of guessing. More in Why I built Gillby.
"Can I run Boca Inlet tomorrow morning?" · "Is the Gulf Stream close off Palm Beach?" · "Any red tide on the Gulf coast?" · "Will my 2.5 ft draft make it to the sandbar at low tide?"
What makes it different
One map, one clock. Wind, waves, tide, radar and lightning line up on the same timeline, per spot.
Chop for your boat. Ride comfort accounts for boat size and hull, so a 21-foot center console gets a different answer than a big sportfish.
Bridge clearance at today's tide. 97 bridges, with charted clearance adjusted for the NOAA tide prediction and the nearest live water-level gauge when it passes checks.
Calibrated rain and thunder chances. Probabilities are recalibrated against airport observations, so a stated chance matches how often it actually rains.
A 16-day outlook with honest confidence. Ensemble ranges and a trend against normal. From day 10 on, every day is labeled "Low confidence: trend only."
Sources stay attached. Every answer carries source names, observation times, freshness and anything unavailable.
Endpoint
code
https://gillby.vercel.app/mcp
Streamable HTTP transport. Public data tools are open; personal vessel, route, places, trips and settings tools require the user's Gillby OAuth.
Quick connect
Claude (claude.ai and Claude Desktop)
Open Settings, then Connectors. Choose Add connector, then Add custom connector.
Enter Gillby as the name and paste the server URL above. Choose no sign-in for public conditions, then Add and Connect.
Start a new conversation with Gillby enabled and approve tool use when asked.
Connectors added on claude.ai also show up in Claude Desktop.
ChatGPT
Open Plugins (some accounts call it Apps or Connectors). Choose Add, then Add custom MCP server. Workspaces may need admin access.
Enter Gillby as the name, paste the server URL, and choose No authentication for public conditions. Create it, then Connect.
Start a new chat and select Gillby from your tools.
Claude Code
bash
claude mcp add --transport http gillby https://gillby.vercel.app/mcp
Try it: "Use Gillby to check current conditions at Boca Inlet. Include source freshness and any unavailable data." Full steps and troubleshooting: connection guide.
Claude Code plugin
This repo is also a Claude Code plugin: the Gillby MCP server plus 9 skills and 5 agents.
On Claude Code 2.1.275+ this is one step: /plugin install gillby --marketplace OneWave-AI/gillby-mcp.
Agents and evals call tools as mcp__plugin_gillby_gillby__<tool>. If you also connected Gillby as a claude.ai connector, the same tools appear twice; either works with the skills.
Skills
Use for
gillby-conditions
Live read at any spot, compare spots
gillby-go-no-go
Boating / fishing / inlet trip call with departure windows
evals/ holds 6 cases (spot conditions, go/no-go, route asks for draft, kite asks for wind range, swim no-go with no wading, captain agent). MCP calls are answered by mocks recorded from the live server (evals/mocks/gillby/), so runs need no network access to Gillby.
code
claude plugin eval . --judge-model sonnet
Tools
96 tools on the hosted server, generated from the live tool reference. Start with list_spots and get_conditions with view=summary; that one result carries the forecast, tides, scores, advisories, hazards, lightning and source freshness.
All 96 tools by category
Start here (7)
Tool
What it does
get_health
Worker heartbeat, stale feed families, government dataset status and the GLM lightning feed
list_spots
Every named Florida spot the app scores, with its lat/lon, kind, region and the NOAA stations used for it
get_spot
A single spot record plus now.scores (go/caution/nogo per activity for the current hour) when the worker has scored it
get_conditions
Full bundle for a spot: waves, wind, tide, water temp, activity scores with reasons, 7-day hourly forecast, tides, alerts, hazards, lightning and a briefing
get_briefing
Short headline and body written from live data, with numbers validated against the inputs
get_source_status
Fresh, stale, unavailable and QC-rejected sources used by spot conditions
get_data_coverage
Published dataset inventory and verified spot coverage; distinguishes unavailable data
Forecast and conditions (22)
Tool
What it does
get_forecast
Hourly forecast for a spot or lat/lon: waves, swell split, wind, gusts, tide, current, rain and thunder chance, and activity scores
get_water_temperature
Water temperature for a verified spot over the next hours
get_waves
Wave height, period and swell for a verified spot over the next hours
get_wind
Wind and gusts for a verified spot over the next hours
get_rain
Rain probability and accumulation for a verified spot over the next hours
get_thunder_forecast
Thunderstorm forecast for a verified spot over the next hours
get_uv_forecast
UV forecast for a verified spot over the next hours
get_visibility
Atmospheric visibility for a verified spot over the next hours
get_air_temperature
Air temperature for a verified spot over the next hours
get_pressure
Air pressure for a verified spot over the next hours
get_cloud_cover
Cloud cover for a verified spot over the next hours
get_chop
Boat ride and chop (use get_chop_history for past trends) for a verified spot over the next hours
get_currents
Predicted inlet currents for a verified spot over the next hours
get_gulf_stream
Approximate Gulf Stream edge for a verified spot
get_surf_forecast
NWS surf zone forecast for a verified spot
get_chop_history
Gillby's native 0-10 chop series for up to 31 days, daily mean/max, coverage and 7-day trends
get_history
Read stored observations or forecast history for source and var
get_observations
Actual buoy and station observations for a spot with timestamps
get_wave_models
Published wave-model series and model spread for a spot; absent models stay unavailable
get_departure_windows
Published best windows filtered by activity
get_activity_scores
Hourly published activity scores with reasons and vetoes
compare_spots
Compare current conditions for up to five verified comma-separated spot IDs
Tides, hazards and alerts (9)
Tool
What it does
get_tides
High and low tides (ft above MLLW, NOAA CO-OPS), hourly tide curve, inlet current, sunrise/sunset and moon phase
get_hazards
Active NWS marine alerts plus rip risk, red tide, bacteria, sargassum, water clarity, king tide, Gulf Stream distance and lightning
get_lightning
GOES-19 GLM lightning
get_navigation_notices
USCG local notices to mariners from the published agency dataset, with source and availability
get_derelict_vessels
Reported derelict vessels from the published agency dataset, with source and availability
get_park_alerts
Coastal national park alerts and closures from the published agency dataset, with source and availability
get_rip_risk
Rip current risk for a verified spot
get_king_tide
King tide forecast for a verified spot
get_marine_alerts
Active and upcoming alerts for a spot, retaining start/end times and source links
Routes, depth and boats (7)
Tool
What it does
list_boats
Boats with published specs (LOA, beam, draft, deadrise, weight, hull type, fuel, cruise speed) and their sources
get_boat
A single boat record from the library
plan_route
Chart-aware water routing between from/to spot IDs or lat,lon
get_depth
NOAA ENC chart depth and optional DEM depth at a Florida coordinate, with charted hazards, channels and restriction zones
list_sandbars
Search published sandbars by name or west,south,east,north bbox
list_bridges
Search published bridges by name or west,south,east,north bbox
check_route_conditions
Weather and marine conditions at up to five ordered spot IDs
Places and cams (16)
Tool
What it does
get_protected_areas
Marine protected areas from the published agency dataset, with source and availability
find_marinas
Search published marinas by name or west,south,east,north bbox
find_fuel_docks
Search published fuel docks by name or west,south,east,north bbox
find_boat_ramps
Search published boat ramps by name or west,south,east,north bbox
find_anchorages
Search published anchorages by name or west,south,east,north bbox
find_reefs
Search published reefs by name or west,south,east,north bbox
find_wrecks
Search published wrecks by name or west,south,east,north bbox
find_dive_sites
Search published dive sites by name or west,south,east,north bbox
find_beaches
Search published beaches by name or west,south,east,north bbox
find_waterfront_dining
Search published waterfront restaurants by name or west,south,east,north bbox
find_inlets
Search published inlets by name or west,south,east,north bbox
find_piers
Search published piers by name or west,south,east,north bbox
search_pois
Search public marine POIs
get_poi
Look up a published coastal POI by its exact ID
list_cams
Live source links and credits near a spot or coordinate; archived imagery may be unavailable
get_camera_image
Fetch a public camera JPEG with source timestamp metadata for the Gillby panel
Water quality and marine life (17)
Tool
What it does
get_shark_research
Published Florida shark research occurrences with observation dates, location uncertainty, source credits and licenses
get_jellyfish_observations
Published Florida jellyfish, box jellyfish and man-of-war observations from OBIS and iNaturalist, with dates and credits
get_canal_discharges
Canal discharge and freshwater releases from the published agency dataset, with source and availability
get_lake_okeechobee
Lake Okeechobee stage and releases from the published agency dataset, with source and availability
get_usgs_water
USGS flow, salinity and water temperature from the published agency dataset, with source and availability
get_chlorophyll
Satellite chlorophyll and water color from the published agency dataset, with source and availability
get_temperature_fronts
Satellite sea temperature fronts from the published agency dataset, with source and availability
get_coral_heat
Coral heat stress and bleaching outlook from the published agency dataset, with source and availability
get_algae_reports
Reported algae samples from the published agency dataset, with source and availability
get_fish_kills
Reported fish kills from the published agency dataset, with source and availability
get_pollution_notices
Pollution incident notices from the published agency dataset, with source and availability
get_coastal_sensors
SECOORA coastal sensor observations from the published agency dataset, with source and availability
get_sargassum_outlook
Sargassum research product availability from the published agency dataset, with source and availability
get_beach_bacteria
Beach bacteria samples for a verified spot
get_red_tide
Red tide samples for a verified spot
get_water_clarity
Satellite water clarity for a verified spot
get_sargassum
Local sargassum risk for a verified spot
Datasets (2)
Tool
What it does
list_datasets
Index of government datasets (discharges, Lake O, USGS, CoastWatch, coral heat, USCG notices and more) with status and last-good time
get_dataset
The latest payload of one dataset from list_datasets, including sharks and jellyfish
Your account (OAuth) (16)
Tool
What it does
get_my_vessel
Requires OAuth login to your Gillby account
plan_my_route
Requires OAuth login
list_my_places
Read your saved places and favorites
get_my_place
Read one saved place
save_my_place (writes to your account)
Save a place or favorite
update_my_place (writes to your account)
Update specified saved-place fields
delete_my_place (writes to your account)
Delete a saved place
list_my_trips
Read your saved trips
get_my_trip
Read one saved trip
save_my_trip (writes to your account)
Save a trip
update_my_trip (writes to your account)
Update specified trip fields; this does not recheck route safety
delete_my_trip (writes to your account)
Delete a saved trip
get_my_settings
Read saved vessel, preferences and notification settings
update_my_settings (writes to your account)
Update only specified vessel or preference fields
get_my_notification_settings
Read notification preferences and actual delivery availability
update_my_notification_settings (writes to your account)
Save notification preferences
HTTP API
Everything is also available over ordinary HTTP GET. Public endpoints need no key; account endpoints need OAuth and the user's consent.
Rate limits. About 60 data requests per minute per client, shared between the API and MCP. Over the limit you get HTTP 429 with Retry-After; honor it and back off. A request without a spot returns 400 spot_required.
Data and credits
Data comes from NOAA and NWS (forecasts, marine zones, alerts), NDBC buoys, NOAA CO-OPS tides and water levels, NOAA GOES-19 lightning, Open-Meteo and ECMWF/GFS models, NOAA CoastWatch, USGS, FWC, FDEP, FDOH, USCG and other public sources. Each response names the sources it used.
Gillby is for planning, not navigation. Check official charts, notices and conditions on the water.
License
The plugin, skills, agents, evals and docs in this repo are MIT. The Gillby name and logo, the hosted service, its source code and the data it returns are not; see LICENSE for the scope. Changes are listed in the changelog.
