Florida marine conditions, forecasts, tides, hazards and coastal places for AI agents.
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spots"
],
"properties": {
"spots": {
"type": "string",
"maxLength": 500,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spots"
],
"properties": {
"spots": {
"type": "string",
"maxLength": 500,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| path* | object |
{
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| path* | object |
{
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Search published boat ramps by name or west,south,east,north bbox. Follow with get_poi_details using the returned ID for contacts, parking counts, permits and closure notices. 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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Search published fuel docks by name or west,south,east,north bbox. Follow with get_poi_details using the returned ID for contacts, parking counts, permits and closure notices. 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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Search published marinas by name or west,south,east,north bbox. Follow with get_poi_details using the returned ID for contacts, parking counts, permits and closure notices. 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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Search published waterfront restaurants by name or west,south,east,north bbox. Follow with get_poi_details using the returned ID for contacts, parking counts, permits and closure notices. 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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
},
"hours": {
"type": "integer",
"default": 24,
"maximum": 168,
"minimum": 1
},
"activity": {
"enum": [
"boating",
"sailing",
"paddle",
"sup-surf",
"kite",
"skim",
"skim-wave",
"swim",
"dive",
"fishing-inshore",
"fishing-offshore",
"surf",
"inlet"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
},
"hours": {
"type": "integer",
"default": 24,
"maximum": 168,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"category": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}A single boat record from the library. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
| Argument | Type | Description |
|---|---|---|
| path* | object |
{
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "object",
"required": [
"boatId"
],
"properties": {
"boatId": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| path* | object |
{
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "object",
"required": [
"spotId"
],
"properties": {
"spotId": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1,
"description": "Spot id, e.g. boca-inlet"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Explain California API/MCP beta coverage, sources and missing capabilities. Check before claiming Florida parity, continuous advisories or break-level surf scores. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
No arguments.
{
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
}On-demand lake weather with wind/gusts kt, air F and source-dated gauge measurements. Preserve original elevation datum, units, CDEC source time and provisional flags. Each measurement includes freshness independently; the gauge source uses the oldest returned parameter so a new temperature cannot conceal old level or flow. Source clocks without verified UTC offsets have unknown freshness. No wave forecast or launch opening guarantee. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
| Argument | Type | Description |
|---|---|---|
| path* | object |
{
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "object",
"required": [
"lakeId"
],
"properties": {
"lakeId": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Paginated CDFW protected-area boundary geometry from a dated archive. Verify current CDFW fishing and access regulations; geometry alone does not establish permitted activities. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"default": 5,
"maximum": 10,
"minimum": 1
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 1000,
"minimum": 0
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Get source-dated USGS river flow cfs, local gauge height ft and water temperature F where available, plus weather. Preserve measurement units and provisional flags; stage is not navigable depth. Each measurement includes independent freshness; sourceStatus separates retrieval and observation time and uses the oldest returned parameter. No navigation or water-contact safety rating. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
| Argument | Type | Description |
|---|---|---|
| path* | object |
{
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "object",
"required": [
"riverId"
],
"properties": {
"riverId": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Get an on-demand California surf outlook for a forecastSupported spot ID from list_california_spots. Offshore swell ft/period s/directions FROM, wind kt/FROM, NOAA tide predictions ft MLLW and dated buoy observations. Offshore waves are not breaking-wave heights. Includes an experimental Gillby capped surf preference score (0–100), per-hour factors and model version. Missing essential inputs yield null. This is not a calibrated break-level surf rating; no beach advisory or shark-risk assessment is supplied. Includes parking guidance with checkedAt and official sources (availability null), localGuide where researched, exact NOAA tideEvents ft MLLW, dated NWS regional surf/rip-risk reports for supported Los Angeles spots, detailStatus with separate issues/retrieval time, and planning.days with morning/afternoon ranges in America/Los_Angeles. Null regional/localGuide means unavailable, not safe conditions. locationCameras matches the requested spot and supplies snapshotPath for refreshing JPEG previews, mediaType and unknown capture times; previews are not live video. cameras retains regional camera source links and provider-hosted YouTube IDs where available; these views may differ from the requested break and stream uptime is not guaranteed. Preserve issues and timestamps. sourceStatus distinguishes retrieval, observedAt, issuedAt (null when unknown), forecast validFrom/validThrough, current/stale/unavailable/unknown states, refreshAfterSec and maxObservationAgeSec (Gillby policies, not provider SLAs). Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Fetch a public camera JPEG with source timestamp metadata. First use list_cams and request only IDs with snapshotAvailable=true. Video-only cameras provide a liveUrl instead of a still. Returns image bytes through MCP.
| Argument | Type | Description |
|---|---|---|
| camId* | string |
{
"type": "object",
"required": [
"camId"
],
"properties": {
"camId": {
"type": "string",
"pattern": "^[a-z0-9-]+$",
"maxLength": 100
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"category": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"category": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
},
"hours": {
"type": "integer",
"default": 24,
"maximum": 168,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"to": {
"type": "string",
"format": "date-time"
},
"from": {
"type": "string",
"format": "date-time"
},
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
},
"hours": {
"type": "integer",
"default": 24,
"maximum": 168,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"category": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"category": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
},
"hours": {
"type": "integer",
"default": 24,
"maximum": 168,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Published dataset inventory and verified spot coverage; distinguishes unavailable data. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
No arguments.
{
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| path* | object | |
| query | object |
{
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "object",
"required": [
"datasetId"
],
"properties": {
"datasetId": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
},
"query": {
"type": "object",
"required": [],
"properties": {
"bbox": {
"type": "string",
"pattern": "^-?\\d+(\\.\\d+)?(,-?\\d+(\\.\\d+)?){3}$",
"description": "w,s,e,n in decimal degrees"
},
"category": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40
}
},
"geometry": {
"type": "boolean"
},
"homeZone": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
},
"activity": {
"enum": [
"boating",
"sailing",
"paddle",
"sup-surf",
"kite",
"skim",
"skim-wave",
"swim",
"dive",
"fishing-inshore",
"fishing-offshore",
"surf",
"inlet"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"maximum": 31,
"minimum": 24
},
"lon": {
"type": "number",
"maximum": -78,
"minimum": -88
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"category": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"category": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Published state-isolated Florida and California fishing evidence (state defaults to florida; California default species california-halibut): 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. state selects separate publications; species must belong to that state. Publication checks older than 26 hours are stale; query last-good times preserve partial outage age. California uses bounded OBIS/iNaturalist occurrences, not a comprehensive catch survey. 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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"to": {
"type": "string",
"maxLength": 10,
"minLength": 1
},
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"from": {
"type": "string",
"maxLength": 10,
"minLength": 1
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
},
"month": {
"type": "integer",
"default": 0,
"maximum": 12,
"minimum": 0
},
"state": {
"enum": [
"florida",
"california"
],
"type": "string",
"default": "florida"
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 100000,
"minimum": 0
},
"species": {
"enum": [
"mahi",
"blue-marlin",
"white-marlin",
"tarpon",
"snook",
"california-halibut",
"kelp-bass",
"pacific-yellowtail",
"lingcod"
],
"type": "string"
},
"weighting": {
"enum": [
"recent",
"historical"
],
"type": "string",
"default": "recent"
},
"catchesOnly": {
"type": "boolean",
"default": false
},
"cellDegrees": {
"enum": [
0.25,
0.1,
0.05,
0.02,
0.01,
0.005
],
"type": "number",
"default": 0.05
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Published state-isolated Florida and California fishing evidence (state defaults to florida; California default species california-halibut): 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. state selects separate publications; species must belong to that state. Publication checks older than 26 hours are stale; query last-good times preserve partial outage age. California uses bounded OBIS/iNaturalist occurrences, not a comprehensive catch survey. 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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"to": {
"type": "string",
"maxLength": 10,
"minLength": 1
},
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"from": {
"type": "string",
"maxLength": 10,
"minLength": 1
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
},
"month": {
"type": "integer",
"default": 0,
"maximum": 12,
"minimum": 0
},
"state": {
"enum": [
"florida",
"california"
],
"type": "string",
"default": "florida"
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 100000,
"minimum": 0
},
"species": {
"enum": [
"mahi",
"blue-marlin",
"white-marlin",
"tarpon",
"snook",
"california-halibut",
"kelp-bass",
"pacific-yellowtail",
"lingcod"
],
"type": "string"
},
"weighting": {
"enum": [
"recent",
"historical"
],
"type": "string",
"default": "recent"
},
"catchesOnly": {
"type": "boolean",
"default": false
},
"cellDegrees": {
"enum": [
0.25,
0.1,
0.05,
0.02,
0.01,
0.005
],
"type": "number",
"default": 0.05
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Published state-isolated Florida and California fishing evidence (state defaults to florida; California default species california-halibut): 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. state selects separate publications; species must belong to that state. Publication checks older than 26 hours are stale; query last-good times preserve partial outage age. California uses bounded OBIS/iNaturalist occurrences, not a comprehensive catch survey. 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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"to": {
"type": "string",
"maxLength": 10,
"minLength": 1
},
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"from": {
"type": "string",
"maxLength": 10,
"minLength": 1
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
},
"month": {
"type": "integer",
"default": 0,
"maximum": 12,
"minimum": 0
},
"state": {
"enum": [
"florida",
"california"
],
"type": "string",
"default": "florida"
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 100000,
"minimum": 0
},
"species": {
"enum": [
"mahi",
"blue-marlin",
"white-marlin",
"tarpon",
"snook",
"california-halibut",
"kelp-bass",
"pacific-yellowtail",
"lingcod"
],
"type": "string"
},
"weighting": {
"enum": [
"recent",
"historical"
],
"type": "string",
"default": "recent"
},
"catchesOnly": {
"type": "boolean",
"default": false
},
"cellDegrees": {
"enum": [
0.25,
0.1,
0.05,
0.02,
0.01,
0.005
],
"type": "number",
"default": 0.05
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Florida USGS lake monitoring inventory, levels with original vertical datum, temperature and storage where measured; historical stations and stale readings identified 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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"category": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Florida NOAA river and water gauges, observed readings and separate forecast summaries 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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"category": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude, decimal degrees (WGS84)"
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude, decimal degrees (WGS84)"
},
"boat": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1,
"description": "Boat id from GET /api/v1/boats (adds boat-specific chop comfort), or 'custom' with loa/beam/draft/deadrise/hull/cat/name"
},
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1,
"description": "Spot id from GET /api/v1/spots, e.g. boca-inlet. Use this or lat+lon."
},
"time": {
"type": "string",
"format": "date-time",
"description": "window start, ISO with offset (default now)"
},
"hours": {
"type": "integer",
"default": 48,
"maximum": 168,
"minimum": 1
},
"kiteStyle": {
"enum": [
"freeride",
"waves",
"foil"
],
"type": "string",
"default": "freeride"
},
"kiteMaxWindKt": {
"type": "number",
"maximum": 60,
"minimum": 1,
"description": "Rider-supplied equipment wind maximum; must exceed minimum"
},
"kiteMinWindKt": {
"type": "number",
"maximum": 60,
"minimum": 1,
"description": "Rider-supplied equipment wind minimum; never infer"
},
"kiteExperience": {
"enum": [
"beginner",
"independent",
"advanced"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude, decimal degrees (WGS84)"
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude, decimal degrees (WGS84)"
},
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1,
"description": "Spot id from GET /api/v1/spots, e.g. boca-inlet. Use this or lat+lon."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"detail": {
"type": "boolean",
"default": false
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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. This is a stored source archive. source=forecast:* returns model estimates or predictions, even when valid times are in the past; it does not establish observed rainfall. For measured historical daily precipitation use get_rainfall_history and preserve coverage. For chop trends use get_chop_history with recorded/reconstructed provenance and gaps. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"source",
"var"
],
"properties": {
"to": {
"type": "string",
"format": "date-time"
},
"var": {
"type": "string",
"maxLength": 40,
"minLength": 1
},
"from": {
"type": "string",
"format": "date-time"
},
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
},
"source": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"maxPoints": {
"type": "integer",
"default": 500,
"maximum": 1000,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Search 26 completed seasons of NOAA NHC HURDAT2 best-track history (2000–2025), Atlantic and eastern/central Pacific. Includes tropical cyclones, not only hurricanes. Filter by basin, year range, name, storm ID, hurricane strength or recorded landfall. Paginated summaries by default; includeTrack=true returns UTC positions, sustained wind kt, pressure mb, status, special-event flags and 34/50/64 kt wind radii in nautical miles ordered NE, SE, SW, NW. Missing measurements are null. Landfall flags cover any coastline, not specifically the US. Finalized retrospective tracks are not forecasts; current 2026 advisories use get_hurricanes. Historical tracks alone do not measure local damage or future risk. Units: sustained wind kt; pressure mb; coordinates degrees; UTC track timestamps; wind radii nautical miles ordered NE, SE, SW, NW. Missing measurements are null. Returns data and source/freshness metadata.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"id": {
"type": "string",
"pattern": "^(al|ep|cp)[0-9]{6}$",
"maxLength": 8
},
"name": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"basin": {
"enum": [
"all",
"al",
"ep",
"cp"
],
"type": "string",
"default": "all"
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 10000,
"minimum": 0
},
"endYear": {
"type": "integer",
"default": 2025,
"maximum": 2025,
"minimum": 2000
},
"startYear": {
"type": "integer",
"default": 2000,
"maximum": 2025,
"minimum": 2000
},
"includeTrack": {
"type": "boolean",
"default": false
},
"landfallOnly": {
"type": "boolean",
"default": false
},
"hurricanesOnly": {
"type": "boolean",
"default": false
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Active NHC tropical cyclones in the Atlantic and eastern/central Pacific. Returns position, maximum sustained wind (kt), pressure (mb), movement (degrees toward and kt), advisory timestamps and official advisory/forecast/cone links. Preserve stale/unavailable status. An empty active-storm list does not rule out developing systems or local hazards. The cone is not an impact boundary. Follow official local warnings. Units: sustained wind and movement speed kt; pressure mb; coordinates degrees; movement bearings TOWARD. Advisory and retrieval timestamps are separate. Returns data and source/freshness metadata.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"basin": {
"enum": [
"all",
"al",
"ep",
"cp"
],
"type": "string",
"default": "all"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"category": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
No arguments.
{
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| path* | object |
{
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
No arguments.
{
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| path* | object |
{
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
No arguments.
{
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"category": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"category": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Discover checked Florida or California launch/trailer and beach parking guides. Supply state, optionally an exact guide ID; omit id to list available guides and IDs. Returns official sources, checkedAt (research date, not publication time), entrance directions when researched, permit/fee/access guidance, construction notices and published capacity where supplied. Coverage is selected locations, not every launch. Unknown IDs return no guide. availability is always null: no live occupancy, opening or reopening feed is connected. Never substitute ordinary car-lot parking for trailer permission. Facility inventory is available through get_poi_details for supported Florida POI IDs. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"state"
],
"properties": {
"id": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"state": {
"enum": [
"florida",
"california"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Look up a published coastal POI by its exact ID. Use get_poi_details with this ID for supported facility parking, contacts and source facts; this listing does not calculate live bridge clearance. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Read source-linked details for a published Florida boat ramp, marina, fuel dock or waterfront restaurant by exact POI ID returned by a place search. Includes contact details, parking trailer/car/accessible space counts where published, hours, fees, slips, amenities and per-field sources/dates. Launch parking includes 84 collected FWC records and checked operator guidance at selected facilities; launch:notice facts may describe construction or closure and take priority over routine hours/rates. Published capacity is not live availability. Preserve unknown values, source dates and conflicting records. Does not establish current ramp reopening, trailer permission, dock access, live fuel prices or navigable depth. California directory IDs use list_california_facilities; use get_parking_guides for checked California parking guidance. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+$",
"maxLength": 160,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Same bundle as get_conditions for an arbitrary point inside Florida coverage, including the Keys and Everglades. Model cache points round to 0.02 deg; station references are used only near configured spots. Hosted cold pins request worker publication and return 503 with Retry-After while pending; retry the same coordinate. Source times and coverage remain explicit. Returns 422 unprocessable when the point is on land (details.nearestSpot suggests a spot). Cold point processing can take longer than a named-spot read. Rate limited. 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.
| Argument | Type |
|---|
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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"category": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
},
"hours": {
"type": "integer",
"default": 24,
"maximum": 168,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"category": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Rain forecast probability and amount 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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
},
"hours": {
"type": "integer",
"default": 24,
"maximum": 168,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Observed daily precipitation from NOAA NCEI GHCN-Daily at one of six selected Florida airport stations, not archived forecasts. Required station, start and end (YYYY-MM-DD); completed dates only, 1900 onward, at most 366 inclusive days per request. Public, no API key. Returns daily values in inches, original flags, coverage, monthly summaries and totals. totalIn is null for incomplete coverage; partialTotalIn is only the sum of accepted reported values. Trace is not dry. Presumed-zero, incomplete-period and quality-flagged reports are excluded. Reporting dates are station climate days, not UTC hours. A station does not measure rainfall at a nearby beach, inlet or across a region. Recent records may lag or be revised. Use for how much precipitation fell: NOAA observed station records, not forecast archives. Preserve station, reporting dates, trace days, missing/excluded counts and coverage. Never present partialTotalIn as a complete monthly/yearly total. Station rainfall is not an area-wide measurement. Use get_rain for future amounts and get_history source=forecast:om_weather_best var=precip_in only for archived model estimates. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"station",
"start",
"end"
],
"properties": {
"end": {
"type": "string",
"format": "date"
},
"start": {
"type": "string",
"format": "date"
},
"station": {
"enum": [
"USW00012844",
"USW00012839",
"USW00012836",
"USW00012842",
"USW00012815",
"USW00013899"
],
"type": "string",
"description": "USW00012844 = West Palm Beach airport; USW00012839 = Miami International Airport; USW00012836 = Key West International Airport; USW00012842 = Tampa International Airport; USW00012815 = Orlando International Airport; USW00013899 = Pensacola airport"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Read the current Gillby release version, date, supported MCP protocol and dated changes shared by the API and MCP. API URL versions are separate from product release versions. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
No arguments.
{
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"category": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| path* | object |
{
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "object",
"required": [
"spotId"
],
"properties": {
"spotId": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1,
"description": "Spot id, e.g. boca-inlet"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"category": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
},
"hours": {
"type": "integer",
"default": 24,
"maximum": 168,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude, decimal degrees (WGS84)"
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude, decimal degrees (WGS84)"
},
"days": {
"type": "integer",
"default": 3,
"maximum": 7,
"minimum": 1
},
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1,
"description": "Spot id from GET /api/v1/spots, e.g. boca-inlet. Use this or lat+lon."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}USGS flow, local gauge height, 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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"category": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
},
"hours": {
"type": "integer",
"default": 24,
"maximum": 168,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
},
"hours": {
"type": "integer",
"default": 24,
"maximum": 168,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
},
"hours": {
"type": "integer",
"default": 24,
"maximum": 168,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
},
"hours": {
"type": "integer",
"default": 24,
"maximum": 168,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
},
"hours": {
"type": "integer",
"default": 24,
"maximum": 168,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"maxLength": 60,
"minLength": 2,
"description": "make/model search"
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1
},
"category": {
"type": "string",
"maxLength": 40
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Paginated dated State Parks boating-facility source records. Unverified facilities have no map coordinates; opening/access and amenities require operator confirmation. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"maxLength": 100
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"county": {
"type": "string",
"maxLength": 80
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 10000,
"minimum": 0
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}List California lake IDs, model point coordinates and gauge references. Lake centers are approximate, not surveyed launches. Use get_california_lake for weather and gauge data. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"maxLength": 100
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Browse dated California station, access and port source records from a packaged archive. This is historical source data, not continuous live conditions. Times on observations may precede archive download time. No current beach-advisory status. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"maxLength": 100
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 10000,
"minimum": 0
},
"region": {
"enum": [
"south",
"central",
"bay",
"north",
"lakes",
"rivers"
],
"type": "string"
},
"category": {
"enum": [
"station",
"access",
"port"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}List configured California river gauge IDs and source references. Use get_california_river for observations and local forecast; stage is local gauge height, not navigation depth. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"maxLength": 100
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}List California surf locations with source links, coordinate roles and forecastSupported flags. Includes 10 configured locations plus coordinate-based model outlooks for official surfing-access, historical and community listings; overlapping source records are not a unique verified surf-break count. Pagination uses offset/limit. Use a forecastSupported ID with get_california_surf. Directory locations have no verified beach orientation or preference score. Preserve model limitations and source gaps. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"maxLength": 100
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 10000,
"minimum": 0
},
"region": {
"enum": [
"south",
"central",
"bay",
"north",
"lakes",
"rivers"
],
"type": "string"
},
"forecastOnly": {
"type": "boolean",
"default": false
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
No arguments.
{
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
}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.
No arguments.
{
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
}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.
No arguments.
{
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Every named 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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"region": {
"enum": [
"lake-o",
"keys",
"miami-dade",
"broward",
"palm-beach",
"treasure-coast",
"space-coast",
"ne-fl",
"sw-fl",
"tampa-bay",
"nature-coast",
"big-bend",
"panhandle"
],
"type": "string"
},
"include": {
"enum": [
"status"
],
"type": "string",
"description": "status = add now.scores per activity"
},
"homeZone": {
"type": "boolean",
"description": "only the Deerfield/Boca/Pompano home zone"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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 metadata.
| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"ukc": {
"type": "number",
"maximum": 10,
"minimum": 0
},
"via": {
"type": "string",
"maxLength": 800,
"minLength": 1,
"description": "Up to eight required stops in order: spot IDs or lat,lon separated by semicolons. Stops may snap up to 300 m; inspect reached offsets. No straight-line gaps are implied safe."
},
"beam": {
"type": "number",
"maximum": 60,
"minimum": 1
},
"from": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"time": {
"type": "string",
"format": "date-time"
},
"draft": {
"type": "number",
"maximum": 15,
"minimum": 0.3
},
"speed": {
"type": "number",
"maximum": 60,
"minimum": 3
},
"airDraft": {
"type": "number",
"maximum": 150,
"minimum": 0
},
"corridor": {
"enum": [
"any",
"icw"
],
"type": "string",
"default": "any",
"description": "icw is a hard USACE/FWC published ICW channel boundary, with no ocean fallback. Unknown/missing channel or depth coverage returns no verified route."
},
"bridgeMargin": {
"type": "number",
"maximum": 20,
"minimum": 0
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | object |
Save a named map pin with name, lat, lon and activity, or a catalog favorite with spotId. Saved coordinates can be used with get_point_conditions. 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.
| Argument | Type | Description |
|---|---|---|
| body* | object |
{
"type": "object",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"requestId",
"place"
],
"properties": {
"place": {
"type": "object",
"required": [],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"kind": {
"type": "string",
"maxLength": 30,
"minLength": 1
},
"name": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"sort": {
"type": "number",
"maximum": 1000000,
"minimum": -1000000
},
"notes": {
"type": [
"string",
"null"
],
"maxLength": 2000,
"minLength": 1
},
"boatId": {
"type": [
"string",
"null"
],
"maxLength": 80,
"minLength": 1
},
"spotId": {
"type": [
"string",
"null"
],
"maxLength": 80,
"minLength": 1
},
"activity": {
"enum": [
"boating",
"sailing",
"paddle",
"sup-surf",
"kite",
"skim",
"skim-wave",
"swim",
"dive",
"fishing-inshore",
"fishing-offshore",
"surf",
"inlet"
],
"type": "string"
}
},
"additionalProperties": false
},
"requestId": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{8,80}$",
"maxLength": 80,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| body* | object |
{
"type": "object",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"requestId",
"trip"
],
"properties": {
"trip": {
"type": "object",
"required": [
"name",
"from",
"to",
"departAt"
],
"properties": {
"to": {
"type": "object",
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"label": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
},
"via": {
"type": "array",
"items": {
"type": "object",
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"label": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 20
},
"from": {
"type": "object",
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"label": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
},
"name": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"notes": {
"type": [
"string",
"null"
],
"maxLength": 2000,
"minLength": 1
},
"ukcFt": {
"type": "number",
"maximum": 20,
"minimum": 0
},
"boatId": {
"type": [
"string",
"null"
],
"maxLength": 80,
"minLength": 1
},
"status": {
"enum": [
"planned",
"underway",
"done",
"cancelled"
],
"type": "string"
},
"draftFt": {
"type": [
"number",
"null"
],
"maximum": 30,
"minimum": 0.1
},
"speedKt": {
"type": "number",
"maximum": 80,
"minimum": 1
},
"activity": {
"enum": [
"boating",
"sailing",
"paddle",
"sup-surf",
"kite",
"skim",
"skim-wave",
"swim",
"dive",
"fishing-inshore",
"fishing-offshore",
"surf",
"inlet"
],
"type": "string"
},
"departAt": {
"type": "string",
"format": "date-time",
"maxLength": 80,
"minLength": 1
},
"returnAt": {
"type": [
"string",
"null"
],
"format": "date-time",
"maxLength": 80,
"minLength": 1
}
},
"additionalProperties": false
},
"requestId": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{8,80}$",
"maxLength": 80,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query | object |
{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"bbox": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"cats": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| body* | object |
{
"type": "object",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"required": [],
"properties": {
"enabled": {
"type": "boolean"
},
"quietEnd": {
"type": "string",
"pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
"maxLength": 5,
"minLength": 1
},
"bestWindow": {
"type": "boolean"
},
"quietStart": {
"type": "string",
"pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
"maxLength": 5,
"minLength": 1
},
"lightningMi": {
"type": "number",
"maximum": 50,
"minimum": 1
},
"chopThreshold": {
"type": "string",
"maxLength": 30,
"minLength": 1
},
"macNotifications": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Update specified saved-place fields, including name to rename a saved pin. Requires your Gillby account and explicit account consent. Units: ft, kt, s, F, mi; directions FROM. Returns data and source/freshness metadata.
| Argument | Type | Description |
|---|---|---|
| body* | object | |
| path* | object |
{
"type": "object",
"required": [
"path",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"kind": {
"type": "string",
"maxLength": 30,
"minLength": 1
},
"name": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"sort": {
"type": "number",
"maximum": 1000000,
"minimum": -1000000
},
"notes": {
"type": [
"string",
"null"
],
"maxLength": 2000,
"minLength": 1
},
"boatId": {
"type": [
"string",
"null"
],
"maxLength": 80,
"minLength": 1
},
"spotId": {
"type": [
"string",
"null"
],
"maxLength": 80,
"minLength": 1
},
"activity": {
"enum": [
"boating",
"sailing",
"paddle",
"sup-surf",
"kite",
"skim",
"skim-wave",
"swim",
"dive",
"fishing-inshore",
"fishing-offshore",
"surf",
"inlet"
],
"type": "string"
}
},
"additionalProperties": false
},
"path": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| body* | object |
{
"type": "object",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"required": [],
"properties": {
"view": {
"enum": [
"auto",
"desktop",
"mobile"
],
"type": "string"
},
"theme": {
"enum": [
"auto",
"light",
"dark"
],
"type": "string"
},
"ukcFt": {
"type": "number",
"maximum": 20,
"minimum": 0
},
"units": {
"type": "object",
"required": [],
"properties": {
"temp": {
"enum": [
"F",
"C"
],
"type": "string"
},
"distance": {
"enum": [
"nm",
"mi"
],
"type": "string"
}
},
"additionalProperties": false
},
"alerts": {
"type": "object",
"required": [],
"properties": {
"enabled": {
"type": "boolean"
},
"quietEnd": {
"type": "string",
"pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
"maxLength": 5,
"minLength": 1
},
"bestWindow": {
"type": "boolean"
},
"quietStart": {
"type": "string",
"pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
"maxLength": 5,
"minLength": 1
},
"lightningMi": {
"type": "number",
"maximum": 50,
"minimum": 1
},
"chopThreshold": {
"type": "string",
"maxLength": 30,
"minLength": 1
},
"macNotifications": {
"type": "boolean"
}
},
"additionalProperties": false
},
"boatId": {
"type": [
"string",
"null"
],
"maxLength": 80,
"minLength": 1
},
"draftFt": {
"type": [
"number",
"null"
],
"maximum": 30,
"minimum": 0.1
},
"cruiseKt": {
"type": [
"number",
"null"
],
"maximum": 80,
"minimum": 1
},
"airDraftFt": {
"type": [
"number",
"null"
],
"maximum": 150,
"minimum": 1
},
"homeSpotIds": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"maxItems": 50
},
"bridgeMarginFt": {
"type": "number",
"maximum": 20,
"minimum": 0
},
"defaultActivity": {
"enum": [
"boating",
"sailing",
"paddle",
"sup-surf",
"kite",
"skim",
"skim-wave",
"swim",
"dive",
"fishing-inshore",
"fishing-offshore",
"surf",
"inlet"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| body* | object | |
| path* | object |
{
"type": "object",
"required": [
"path",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [],
"properties": {
"to": {
"type": "object",
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"label": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
},
"via": {
"type": "array",
"items": {
"type": "object",
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"label": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 20
},
"from": {
"type": "object",
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"label": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
},
"name": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"notes": {
"type": [
"string",
"null"
],
"maxLength": 2000,
"minLength": 1
},
"ukcFt": {
"type": "number",
"maximum": 20,
"minimum": 0
},
"boatId": {
"type": [
"string",
"null"
],
"maxLength": 80,
"minLength": 1
},
"status": {
"enum": [
"planned",
"underway",
"done",
"cancelled"
],
"type": "string"
},
"draftFt": {
"type": [
"number",
"null"
],
"maximum": 30,
"minimum": 0.1
},
"speedKt": {
"type": "number",
"maximum": 80,
"minimum": 1
},
"activity": {
"enum": [
"boating",
"sailing",
"paddle",
"sup-surf",
"kite",
"skim",
"skim-wave",
"swim",
"dive",
"fishing-inshore",
"fishing-offshore",
"surf",
"inlet"
],
"type": "string"
},
"departAt": {
"type": "string",
"format": "date-time",
"maxLength": 80,
"minLength": 1
},
"returnAt": {
"type": [
"string",
"null"
],
"format": "date-time",
"maxLength": 80,
"minLength": 1
}
},
"additionalProperties": false
},
"path": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}| Argument | Type | Description |
|---|---|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"spot"
],
"properties": {
"cat": {
"type": "string",
"maxLength": 40,
"description": "custom boat category"
},
"loa": {
"type": "number",
"maximum": 200,
"minimum": 1,
"description": "custom boat length overall, ft"
},
"beam": {
"type": "number",
"maximum": 60,
"minimum": 1,
"description": "custom boat beam, ft"
},
"boat": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1,
"description": "Boat id from GET /api/v1/boats (adds boat-specific chop comfort), or 'custom' with loa/beam/draft/deadrise/hull/cat/name"
},
"hull": {
"type": "string",
"maxLength": 40,
"description": "custom boat hull type"
},
"name": {
"type": "string",
"maxLength": 60,
"description": "custom boat name"
},
"spot": {
"type": "string",
"pattern": "^[A-Za-z0-9:._-]+$",
"maxLength": 120,
"minLength": 1,
"description": "Spot id, e.g. boca-inlet"
},
"view": {
"enum": [
"full",
"summary"
],
"type": "string",
"default": "full",
"description": "summary = compact (~10 KB) for LLMs and widgets; full = every hourly point (~250 KB)"
},
"draft": {
"type": "number",
"maximum": 30,
"minimum": 0.1,
"description": "custom boat draft, ft"
},
"cruise": {
"type": "number",
"maximum": 80,
"minimum": 1,
"description": "custom boat cruise speed, kt"
},
"weight": {
"type": "number",
"maximum": 200000,
"minimum": 1,
"description": "custom boat weight, lb"
},
"deadrise": {
"type": "number",
"maximum": 40,
"minimum": 1,
"description": "custom boat deadrise at transom, deg"
},
"kiteStyle": {
"enum": [
"freeride",
"waves",
"foil"
],
"type": "string",
"default": "freeride"
},
"kiteMaxWindKt": {
"type": "number",
"maximum": 60,
"minimum": 1,
"description": "Rider-supplied equipment wind maximum; must exceed minimum"
},
"kiteMinWindKt": {
"type": "number",
"maximum": 60,
"minimum": 1,
"description": "Rider-supplied equipment wind minimum; never infer"
},
"kiteExperience": {
"enum": [
"beginner",
"independent",
"advanced"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}{
"type": "object",
"required": [],
"properties": {
"query": {
"type": "object",
"required": [],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude, decimal degrees (WGS84)"
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude, decimal degrees (WGS84)"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}| Description |
|---|
| query* | object |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude, decimal degrees (WGS84)"
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude, decimal degrees (WGS84)"
},
"view": {
"enum": [
"full",
"summary"
],
"type": "string",
"default": "full",
"description": "summary = compact (~10 KB) for LLMs and widgets; full = every hourly point (~250 KB)"
},
"briefing": {
"type": "boolean",
"default": false,
"description": "also generate an AI briefing (slower)"
},
"kiteStyle": {
"enum": [
"freeride",
"waves",
"foil"
],
"type": "string",
"default": "freeride"
},
"kiteMaxWindKt": {
"type": "number",
"maximum": 60,
"minimum": 1,
"description": "Rider-supplied equipment wind maximum; must exceed minimum"
},
"kiteMinWindKt": {
"type": "number",
"maximum": 60,
"minimum": 1,
"description": "Rider-supplied equipment wind minimum; never infer"
},
"kiteExperience": {
"enum": [
"beginner",
"independent",
"advanced"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"ukc": {
"type": "number",
"maximum": 10,
"minimum": 0
},
"via": {
"type": "string",
"maxLength": 800,
"minLength": 1,
"description": "Up to eight required stops in order: spot IDs or lat,lon separated by semicolons. Stops may snap up to 300 m; inspect reached offsets. No straight-line gaps are implied safe."
},
"beam": {
"type": "number",
"maximum": 60,
"minimum": 1
},
"boat": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"from": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"time": {
"type": "string",
"format": "date-time"
},
"draft": {
"type": "number",
"maximum": 15,
"minimum": 0.3
},
"speed": {
"type": "number",
"maximum": 60,
"minimum": 3
},
"airDraft": {
"type": "number",
"maximum": 150,
"minimum": 0
},
"corridor": {
"enum": [
"any",
"icw"
],
"type": "string",
"default": "any",
"description": "icw is a hard USACE/FWC published ICW channel boundary, with no ocean fallback. Unknown/missing channel or depth coverage returns no verified route."
},
"bridgeMargin": {
"type": "number",
"maximum": 20,
"minimum": 0
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}