Server definition
- Hash
- sha256:c00b4d00c1d19925682d830a25768a04d1ed43084f9364c04032288e1d9002de
- What it is
- What a remote MCP server returned when asked what it offers: 8 tools
The blob, as servednamed by its sha256
{
"instructions": "US marine conditions from NOAA CO-OPS and NDBC: CO-OPS is coastal-gauge tide and tidal-current predictions plus observed water levels, NDBC is live buoy observation, and every water height is referenced to MLLW, the US nautical chart datum, unless another datum is requested. Start with noaa_marine_find_stations to resolve a place name, a coordinate pair, or a bare station number to a station ID — its types filter names what each station can serve, and an ID from one source never works on a tool that reads the other. That source split is also what separates the two current tools: noaa_marine_get_currents returns CO-OPS tidal-current predictions, noaa_marine_get_current_profile an observed NDBC ADCP measurement.",
"tools": [
{
"description": "Find CO-OPS tide, water-level and current stations and NDBC buoys near a location, by name, or by station ID, returning a unified list with source, data capabilities, coordinates, and — for NDBC — the physical platform class. This is the required first step for resolving a place name, a coordinate pair, or a bare station number to the station IDs the data tools take: CO-OPS tide and water-level IDs are numeric (e.g. 9447130 for Seattle), CO-OPS current IDs are alphanumeric (e.g. ACT4176), and NDBC buoy IDs are 5-character alphanumeric codes (e.g. 46041). Two axes are reported separately — capabilities and type name the data products a station serves (tide, current, water_level, met, current_profile, water_quality), while platform is the NDBC physical classification (buoy, fixed, oilrig, dart, tao, usv, other) that CO-OPS stations do not carry. Supply latitude and longitude together for a proximity search, or query for a name-or-ID substring matched against both sources, or state for CO-OPS coverage in one state; the filters combine, and results lead with an exact ID match unless a proximity search is ordering them by distance. A search that matches nothing is a success with total_found: 0 carrying an echo of the filters that were applied, and a search whose catalogs did not all answer says which source is missing. CO-OPS prediction stations carry a third axis as well, prediction_class, which says what a station can actually answer: a tide station is either reference, serving both hilo and the 6-minute curve, or subordinate, serving hilo only, while a current station carries its class per depth bin in bins[] — a harmonic or subordinate bin serves the normal flood/ebb/slack series, and a weak_and_variable bin may instead answer noaa_marine_get_currents with a coverage statement and no events, or report that CO-OPS publishes no predictions for it at all, so prefer a harmonic bin when one is in range.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"latitude": {
"description": "Center latitude in decimal degrees for proximity search. Required together with longitude — supplying only one is rejected rather than silently ignored. Optionally pair with radius_km.",
"maximum": 90,
"minimum": -90,
"type": "number"
},
"limit": {
"default": 20,
"description": "Maximum number of stations to return. Defaults to 20.",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"longitude": {
"description": "Center longitude in decimal degrees for proximity search. Required together with latitude — supplying only one is rejected rather than silently ignored. Optionally pair with radius_km.",
"maximum": 180,
"minimum": -180,
"type": "number"
},
"query": {
"description": "Station name or station ID substring to match, case-insensitive, on both sources. E.g. \"seattle\", \"puget sound\", \"9447130\", \"46041\". A station whose ID matches exactly is returned ahead of name matches, unless latitude/longitude were supplied — a proximity search orders by distance instead. Blank or whitespace-only values are treated as omitted.",
"type": "string"
},
"radius_km": {
"default": 100,
"description": "Search radius in kilometers when latitude/longitude are provided. Defaults to 100 km.",
"maximum": 1000,
"minimum": 1,
"type": "number"
},
"source": {
"default": "all",
"description": "Data source to search: coops (tide/water-level/current stations), ndbc (buoys), or all (default).",
"enum": [
"coops",
"ndbc",
"all"
],
"type": "string"
},
"state": {
"description": "Filter by 2-letter US state or territory code. Applies to CO-OPS stations only — providing it restricts results to CO-OPS and excludes NDBC buoys (which carry no state). A station matches on its own catalog code, or — when its catalog rows carry none, as with every current station — on the state of the nearest state-bearing CO-OPS tide or water-level station within 25 km, which can be wrong on waters shared across a state or national border. E.g. \"WA\", \"CA\", \"PR\".",
"enum": [
"AL",
"AK",
"AZ",
"AR",
"CA",
"CO",
"CT",
"DE",
"FL",
"GA",
"HI",
"ID",
"IL",
"IN",
"IA",
"KS",
"KY",
"LA",
"ME",
"MD",
"MA",
"MI",
"MN",
"MS",
"MO",
"MT",
"NE",
"NV",
"NH",
"NJ",
"NM",
"NY",
"NC",
"ND",
"OH",
"OK",
"OR",
"PA",
"RI",
"SC",
"SD",
"TN",
"TX",
"UT",
"VT",
"VA",
"WA",
"WV",
"WI",
"WY",
"DC",
"PR",
"VI",
"GU",
"AS",
"MP"
],
"type": "string"
},
"types": {
"description": "Filter by data capability or NDBC platform class. Every returned station matches at least one requested value — a capability value against its capabilities list, or buoy against its platform class. Omit to return all stations.",
"items": {
"description": "Filter value. Six are data capabilities, matched against a station's capabilities list: tide (CO-OPS tide predictions → noaa_marine_get_tide_predictions), current (CO-OPS tidal-current predictions → noaa_marine_get_currents), water_level (CO-OPS observed water levels → noaa_marine_get_water_level, and their verified monthly means → noaa_marine_get_monthly_means), met (NDBC meteorological → noaa_marine_get_conditions), current_profile (NDBC observed ocean-current depth profile → noaa_marine_get_current_profile; note this is a different data product and source than CO-OPS `current`), water_quality (NDBC sub-surface water-column sensors → noaa_marine_get_ocean_observations). The seventh, buoy, is a physical-platform filter (NDBC platform class equals buoy), not a data capability — use it to select buoy-class platforms regardless of what data they serve.",
"enum": [
"tide",
"current",
"water_level",
"met",
"current_profile",
"water_quality",
"buoy"
],
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"name": "noaa_marine_find_stations",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"stations",
"total_found"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"applied_search": {
"additionalProperties": false,
"description": "The narrowing dimensions this search applied, echoed when nothing matched so the caller can see which filter emptied the result.",
"properties": {
"catalogs_read": {
"description": "Catalogs this search actually fetched. Empty when source and state cancelled each other out and no catalog was read.",
"items": {
"description": "Catalog name: coops or ndbc.",
"type": "string"
},
"type": "array"
},
"center": {
"additionalProperties": false,
"description": "Proximity-search center, present only when latitude and longitude were supplied.",
"properties": {
"latitude": {
"description": "Center latitude the proximity filter used.",
"type": "number"
},
"longitude": {
"description": "Center longitude the proximity filter used.",
"type": "number"
}
},
"required": [
"latitude",
"longitude"
],
"type": "object"
},
"query": {
"description": "The name/ID substring as the server used it — trimmed and lowercased. Omitted when no query was supplied or it was blank.",
"type": "string"
},
"radius_km": {
"description": "Radius bound in km, present only when a center was given. Applies whenever a center is present and defaults to 100 km.",
"type": "number"
},
"source": {
"description": "The source filter applied: coops, ndbc, or all.",
"type": "string"
},
"state": {
"description": "The state filter applied, matched against each station's resolved state: its own catalog code, or for a station publishing none the state of the nearest state-bearing CO-OPS tide or water-level station within 25 km. Restricts results to CO-OPS and excludes NDBC.",
"type": "string"
},
"types": {
"description": "The resolved types filter. Omitted when no types filter narrowed the search.",
"items": {
"description": "A requested capability or platform filter value.",
"type": "string"
},
"type": "array"
},
"types_by_source": {
"additionalProperties": false,
"description": "The requested types split by the source that can carry them — every value belongs to exactly one source, so a single-source types filter reduces the search to that source.",
"properties": {
"coops": {
"description": "Requested values only a CO-OPS row can carry.",
"items": {
"description": "CO-OPS-only filter value.",
"type": "string"
},
"type": "array"
},
"ndbc": {
"description": "Requested values only an NDBC row can carry.",
"items": {
"description": "NDBC-only filter value.",
"type": "string"
},
"type": "array"
}
},
"required": [
"coops",
"ndbc"
],
"type": "object"
}
},
"required": [
"catalogs_read",
"source"
],
"type": "object"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `incomplete_coordinates`: Only one of latitude/longitude was supplied — proximity search needs the pair. `sources_unavailable`: Every station catalog this search needed failed to load, so no station list could be searched. Other values are possible when a failure originates below the handler.",
"examples": [
"incomplete_coordinates",
"sources_unavailable"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"notice": {
"description": "Guidance about the result set: why a search matched nothing, which catalog did not answer, or that the list was capped.",
"type": "string"
},
"sources": {
"additionalProperties": false,
"description": "Which station catalogs were attempted, answered, and failed. Present only when a catalog fetch rejected, so a partial result set is never read as a complete one.",
"properties": {
"answered": {
"description": "Catalogs that returned a station list — the results cover these only.",
"items": {
"description": "Catalog name: coops or ndbc.",
"type": "string"
},
"type": "array"
},
"attempted": {
"description": "Catalogs this search needed, after source and state decided which to read.",
"items": {
"description": "Catalog name: coops or ndbc.",
"type": "string"
},
"type": "array"
},
"failed": {
"description": "Catalogs whose fetch rejected. A station served only by one of these is missing.",
"items": {
"description": "Catalog name: coops or ndbc.",
"type": "string"
},
"type": "array"
}
},
"required": [
"answered",
"attempted",
"failed"
],
"type": "object"
},
"stations": {
"description": "Stations matching the search criteria, sorted by distance (if lat/lon provided) or by exact ID match then name. Empty when nothing matched.",
"items": {
"additionalProperties": false,
"description": "A single station matching the search criteria.",
"properties": {
"bins": {
"description": "Depth bins this current station publishes predictions for, in the order CO-OPS publishes them. Each bin has its own depth and prediction class, and its bin number is what noaa_marine_get_currents takes as bin. Omitted for a station with no current-prediction rows.",
"items": {
"additionalProperties": false,
"description": "One depth bin CO-OPS publishes current predictions for at this station, with its depth and prediction class.",
"properties": {
"bin": {
"description": "CO-OPS bin number — pass it as the bin input of noaa_marine_get_currents. Omitting bin there selects the shallowest bin.",
"type": "number"
},
"depth": {
"description": "Bin depth in FEET. The catalog publishes one figure with no unit switch, unlike the depth noaa_marine_get_currents echoes, which follows that call's units. Null when CO-OPS publishes no depth for the bin, which is usual where depth_type is U.",
"type": [
"number",
"null"
]
},
"depth_type": {
"description": "CO-OPS depth-reference code as published: B, S, or U. A U bin usually carries no depth. Omitted when the catalog row has none.",
"type": "string"
},
"prediction_class": {
"description": "CO-OPS prediction class for this bin: harmonic (predicted from the bin's own harmonic analysis) or subordinate (derived by offsets from a reference station) both serve the normal flood/ebb/slack series, while weak_and_variable may instead answer noaa_marine_get_currents with a coverage statement and no events, or report that no predictions are published at all. The class is per bin because one station can mix classes across its bins. An unrecognized catalog code is passed through verbatim.",
"type": "string"
}
},
"required": [
"bin",
"depth"
],
"type": "object"
},
"type": "array"
},
"capabilities": {
"description": "Data products available at this station: any of tide, current, water_level (CO-OPS) or met, current_profile, water_quality (NDBC). Empty when the station reports no data capability — platform still identifies it.",
"items": {
"description": "Capability identifier, e.g. \"tide\", \"water_level\".",
"type": "string"
},
"type": "array"
},
"distance_km": {
"description": "Distance in km from the search center (only present when lat/lon search was used).",
"type": "number"
},
"latitude": {
"description": "Station latitude in decimal degrees.",
"type": "number"
},
"longitude": {
"description": "Station longitude in decimal degrees.",
"type": "number"
},
"name": {
"description": "Station name.",
"type": "string"
},
"platform": {
"description": "NDBC physical platform class: buoy, fixed, oilrig, dart, tao, usv, or other. A different axis than type/capabilities (which describe data products). Omitted for CO-OPS stations — CO-OPS publishes no platform taxonomy.",
"type": "string"
},
"prediction_class": {
"description": "CO-OPS TIDE-prediction class: reference (predicted from the station's own harmonic analysis, serving both hilo and the 6-minute curve) or subordinate (high and low events derived as offsets from a reference station, hilo only — noaa_marine_get_tide_predictions rejects interval=\"6min\" for it). A third axis beside type/capabilities (data products) and platform (NDBC physical class). Omitted for a station with no tide-prediction row; a current station carries its class per bin in bins[], where subordinate means something different. An unrecognized catalog code is passed through verbatim.",
"type": "string"
},
"reference_id": {
"description": "The reference station a subordinate tide station derives its offsets from — the station to request a 6-minute curve from. Omitted for a reference station and for any station with no tide-prediction row.",
"type": "string"
},
"source": {
"description": "Data source: coops (CO-OPS) or ndbc (NDBC buoy).",
"enum": [
"coops",
"ndbc"
],
"type": "string"
},
"state": {
"description": "US state or territory code (CO-OPS stations only): the station's own catalog code, or — when its catalog rows carry none, as with every current station — the state of the nearest state-bearing CO-OPS tide or water-level station within 25 km, marked by state_derived. A derived state can be wrong on waters shared across a state or national border. When neither applies, the station's own non-code catalog value (e.g. FM) is shown as published and unmarked — no state filter returns such a station, since the filter takes codes only. Omitted when the station publishes nothing at all and no state-bearing station is that close.",
"type": "string"
},
"state_derived": {
"description": "True when state was derived from the nearest state-bearing CO-OPS tide or water-level station within 25 km, because the station's own catalog rows carry no state code. Omitted when state is the station's own.",
"type": "boolean"
},
"station_id": {
"description": "Station identifier — use this ID with data tools.",
"type": "string"
},
"type": {
"description": "The data capability this row leads with — always one of the values in capabilities. When a types filter of capability values is set this is the first requested capability the station has, so it never contradicts the filter; otherwise it is the first capability. Omitted when the station has no data capability (e.g. a bare buoy/fixed platform matched only by a platform filter) — read platform for its identity. This is a data-product axis, never the physical platform class.",
"type": "string"
}
},
"required": [
"station_id",
"name",
"source",
"latitude",
"longitude",
"capabilities"
],
"type": "object"
},
"type": "array"
},
"total_found": {
"description": "Total stations matching the filters before the limit was applied. Zero when nothing matched.",
"type": "number"
},
"truncated": {
"description": "True when total_found exceeds the limit and not all matching stations are returned. Increase limit or narrow filters to see more.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "Live marine conditions from an NDBC buoy: wave height, period and direction, wind speed, gust and direction, sea-surface temperature, air temperature, barometric pressure, and dew point. All values are SI units — wind in m/s, wave height in m, pressure in hPa, temperatures in °C — except TIDE, which is in feet, and VIS, in nautical miles, both rarely populated at offshore buoys; a numeric field is null when the buoy sensor did not report a value, which is normal offshore. Row cadence varies by station from 5 to 60 minutes, so observed_at can be that old, and NDBC writes each block of columns on its own cycle, so any block can resolve from an earlier row within 90 minutes of observed_at. Waves carry their own waves_observed_at, null when no wave sample falls inside that window, and any other block read from an earlier row is named with its measurement time in the response notice. Use noaa_marine_find_stations with source=\"ndbc\" and types=[\"met\"] to find station IDs near a location, since met-flagged stations are the ones most likely to serve live conditions: roughly a third of active NDBC stations report neither meteorological nor current data, most of those have no observation file, and omitting the types filter surfaces station IDs this tool cannot read.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"station_id": {
"description": "NDBC buoy station ID (5-character alphanumeric, e.g. \"46041\" for Cape Elizabeth). Obtain from noaa_marine_find_stations with source=\"ndbc\" and types=[\"met\"].",
"pattern": "^[A-Za-z0-9_-]{1,20}$",
"type": "string"
}
},
"required": [
"station_id"
],
"type": "object"
},
"name": "noaa_marine_get_conditions",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"station_id",
"station_name",
"latitude",
"longitude",
"observed_at",
"source",
"wind_direction_deg",
"wind_speed_ms",
"gust_speed_ms",
"wave_height_m",
"dominant_period_sec",
"average_period_sec",
"mean_wave_direction_deg",
"waves_observed_at",
"pressure_hpa",
"air_temp_c",
"water_temp_c",
"dew_point_c",
"visibility_nmi",
"tide_ft"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"air_temp_c": {
"description": "Air temperature in °C. Null if not reported.",
"type": [
"number",
"null"
]
},
"average_period_sec": {
"description": "Average wave period in seconds. Null if not reported.",
"type": [
"number",
"null"
]
},
"dew_point_c": {
"description": "Dew point temperature in °C. Null if not reported.",
"type": [
"number",
"null"
]
},
"dominant_period_sec": {
"description": "Dominant wave period in seconds. Null if not reported.",
"type": [
"number",
"null"
]
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `buoy_not_found`: NDBC returned 404 for the station ID. `no_sensor_data`: Buoy file exists but all sensor fields are MM (missing) — buoy offline or sensor failure. Other values are possible when a failure originates below the handler.",
"examples": [
"buoy_not_found",
"no_sensor_data"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"gust_speed_ms": {
"description": "Wind gust speed in m/s. Null if not reported.",
"type": [
"number",
"null"
]
},
"latitude": {
"description": "Station latitude in decimal degrees. Null when the station is absent from the NDBC active-stations list — the realtime feed carries observations but no coordinates.",
"type": [
"number",
"null"
]
},
"longitude": {
"description": "Station longitude in decimal degrees. Null when the station is absent from the NDBC active-stations list.",
"type": [
"number",
"null"
]
},
"mean_wave_direction_deg": {
"description": "Mean wave direction in degrees true. Null if not reported.",
"type": [
"number",
"null"
]
},
"notice": {
"description": "Present when a sensor block other than waves was read from a row older than observed_at, naming each such block, the output fields it fills, and the time those values were measured. Absent when every block outside the wave columns came from the newest row.",
"type": "string"
},
"observed_at": {
"description": "ISO 8601 UTC timestamp of the newest data row. Always a valid instant — a row whose upstream time columns are malformed is rejected rather than timestamped with the current time. A sensor block NDBC wrote on an earlier row was measured before this time: waves report theirs in waves_observed_at, and any other block is named with its own time in the notice.",
"type": "string"
},
"pressure_hpa": {
"description": "Atmospheric pressure in hPa. Null if not reported.",
"type": [
"number",
"null"
]
},
"source": {
"description": "Data source — always \"ndbc\" for this tool.",
"type": "string"
},
"station_id": {
"description": "Station ID echoed from the request — for chaining.",
"type": "string"
},
"station_name": {
"description": "Station name from the NDBC active stations list.",
"type": "string"
},
"tide_ft": {
"description": "Tide height in feet. NOTE: always in feet regardless of other unit settings. Rarely populated at offshore buoys. Null if not reported.",
"type": [
"number",
"null"
]
},
"visibility_nmi": {
"description": "Visibility in nautical miles. NOTE: always in nautical miles regardless of other unit settings. Null if not reported.",
"type": [
"number",
"null"
]
},
"water_temp_c": {
"description": "Sea-surface temperature in °C. Null if not reported.",
"type": [
"number",
"null"
]
},
"wave_height_m": {
"description": "Significant wave height in meters. Null if not reported.",
"type": [
"number",
"null"
]
},
"waves_observed_at": {
"description": "ISO 8601 UTC timestamp of the row the four wave fields were read from. NDBC runs its wave pass on a slower cycle than the met row, so this can be older than observed_at; it applies to all four wave fields, which are never sampled apart. Null when no wave sample falls inside the 90-minute look-back window, including when the buoy has no wave sensor.",
"type": [
"string",
"null"
]
},
"wind_direction_deg": {
"description": "Wind direction in degrees true (0–360). Null if not reported by the buoy.",
"type": [
"number",
"null"
]
},
"wind_speed_ms": {
"description": "Wind speed in m/s. Null if not reported.",
"type": [
"number",
"null"
]
}
},
"type": "object"
}
},
{
"description": "Observed ocean-current depth profile from an NDBC ADCP buoy — the most recent measurement of current speed and direction at each depth bin, returning depth in meters, direction in degrees true (the direction the current flows toward), and speed in cm/s. It is distinct from noaa_marine_get_currents, which returns CO-OPS tidal-current predictions of max flood, ebb and slack rather than these observed acoustic-Doppler measurements. A depth bin is reported whenever NDBC gives it a depth, and its direction or speed is null when the sensor did not report that component. Use noaa_marine_find_stations with source=\"ndbc\" and types=[\"current_profile\"] to find station IDs, since most NDBC stations serve no ADCP profile and an unfiltered search returns IDs this tool cannot read.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"station_id": {
"description": "NDBC station ID (5-character alphanumeric, e.g. \"44033\"). Obtain from noaa_marine_find_stations with source=\"ndbc\" and types=[\"current_profile\"].",
"pattern": "^[A-Za-z0-9_-]{1,20}$",
"type": "string"
}
},
"required": [
"station_id"
],
"type": "object"
},
"name": "noaa_marine_get_current_profile",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"station_id",
"station_name",
"latitude",
"longitude",
"observed_at",
"source",
"bin_count",
"bins"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"bin_count": {
"description": "Number of depth bins in the profile.",
"type": "number"
},
"bins": {
"description": "Depth-binned current measurements, shallowest first (NDBC source order).",
"items": {
"additionalProperties": false,
"description": "A single depth-bin current measurement.",
"properties": {
"depth_m": {
"description": "Bin depth below the surface in meters.",
"type": "number"
},
"direction_deg": {
"description": "Direction the current flows toward, in degrees true (0–360). Null if not reported for this bin.",
"type": [
"number",
"null"
]
},
"speed_cm_s": {
"description": "Current speed in cm/s. Null if not reported for this bin.",
"type": [
"number",
"null"
]
}
},
"required": [
"depth_m",
"direction_deg",
"speed_cm_s"
],
"type": "object"
},
"type": "array"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `profile_not_found`: NDBC returned 404 for the station — no ADCP current-profile file exists for it. `no_current_data`: The ADCP file exists but has no usable data rows — profiler offline or every bin missing. Other values are possible when a failure originates below the handler.",
"examples": [
"profile_not_found",
"no_current_data"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"latitude": {
"description": "Station latitude in decimal degrees. Null when the station is absent from the NDBC active-stations list — the ADCP feed carries current data but no coordinates.",
"type": [
"number",
"null"
]
},
"longitude": {
"description": "Station longitude in decimal degrees. Null when the station is absent from the NDBC active-stations list.",
"type": [
"number",
"null"
]
},
"observed_at": {
"description": "ISO 8601 UTC timestamp of the observation. Always a valid instant — a row whose upstream time columns are malformed is rejected rather than timestamped with the current time.",
"type": "string"
},
"source": {
"description": "Data source — always \"ndbc\" for this tool.",
"type": "string"
},
"station_id": {
"description": "Station ID echoed from the request — for chaining.",
"type": "string"
},
"station_name": {
"description": "Station name from the NDBC active stations list.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Tidal current predictions for a CO-OPS current station: max flood and ebb speeds, slack times, and the station's mean flood and ebb bearings. These are forecast predictions from CO-OPS, distinct from noaa_marine_get_current_profile, which returns NDBC observed ocean-current measurements binned by depth. The default MAX_SLACK interval is the practical planning view, showing when currents peak and when slack water occurs, and a 6-minute interval returns the continuous curve for detailed analysis, each row carrying its own flood/ebb/slack sense. A station can publish predictions for several depth bins at different depths: bin selects one, omitting it takes the CO-OPS default of the shallowest bin, and the bin and its depth are echoed on every response — read bins[] on a noaa_marine_find_stations current row for the bins a station actually has. A station whose currents CO-OPS will not predict as discrete events answers with an empty list and its own wording in the notice rather than an error. Both intervals are bounded by response size: a range whose rows fit is returned whole, a longer one returns the leading rows with rows_matched, rows_returned, and next_offset reporting how much matched and which offset reaches the rest, and offset and limit walk whichever series the interval selects. Current station IDs are alphanumeric (e.g. ACT4176), distinct from the numeric tide and water-level IDs, and the date range is limited to 1 year per request — use noaa_marine_find_stations with types=[\"current\"] to obtain a valid current station ID.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"begin_date": {
"description": "Start date, YYYYMMDD or YYYY-MM-DD, e.g. \"20240601\" or \"2024-06-01\".",
"pattern": "^(\\d{8}|\\d{4}-\\d{2}-\\d{2})$",
"type": "string"
},
"bin": {
"description": "Depth bin to predict for, taken from the bins[] array on a noaa_marine_find_stations current row (e.g. 15, 10 or 1 at PUG1515). Omit to take the CO-OPS default, which is the shallowest bin. A bin the station does not publish comes back as bin_unavailable naming the bins it does.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"end_date": {
"description": "End date (inclusive), YYYYMMDD or YYYY-MM-DD, e.g. \"20240607\" or \"2024-06-07\".",
"pattern": "^(\\d{8}|\\d{4}-\\d{2}-\\d{2})$",
"type": "string"
},
"interval": {
"default": "MAX_SLACK",
"description": "Prediction interval: MAX_SLACK (default) returns max flood, max ebb, and slack water events — ideal for passage planning. 6min returns a continuous current curve.",
"enum": [
"MAX_SLACK",
"6min"
],
"type": "string"
},
"limit": {
"description": "Maximum prediction rows to return on this page — max/slack events or 6-minute rows, whichever the interval selects — for a caller that wants fewer than the response budget allows. Omit for the largest page that fits; a value larger than the budget allows does not widen the page.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Row offset into the matched prediction series — the max/slack events on the MAX_SLACK interval, the 6-minute curve on 6min — for reading a range whose rows do not fit one response. 0 (default) starts at the first row; pass the next_offset from a previous call to continue. An offset past the last row returns an empty page rather than an error.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"station_id": {
"description": "CO-OPS current station ID (alphanumeric, e.g. \"ACT4176\"). Obtain from noaa_marine_find_stations with types=[\"current\"].",
"pattern": "^[A-Za-z0-9_-]{1,20}$",
"type": "string"
},
"time_zone": {
"default": "lst_ldt",
"description": "Time zone for returned timestamps. lst_ldt = local standard/daylight time (default); gmt = UTC; lst = local standard time year-round.",
"enum": [
"lst_ldt",
"gmt",
"lst"
],
"type": "string"
},
"units": {
"default": "english",
"description": "Unit system: english = knots for speed and feet for the echoed depth; metric = cm/s for speed (not m/s) and meters for the echoed depth.",
"enum": [
"english",
"metric"
],
"type": "string"
}
},
"required": [
"station_id",
"begin_date",
"end_date"
],
"type": "object"
},
"name": "noaa_marine_get_currents",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"station_id",
"station_name",
"units",
"bin",
"depth"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"bin": {
"description": "Depth bin CO-OPS answered with — the requested bin, or its default shallowest bin when none was requested. Null when the response carried no prediction rows.",
"type": [
"number",
"null"
]
},
"depth": {
"description": "Depth of the returned bin, in the requested units: feet under english, meters under metric. Distinct from the bins[].depth on a noaa_marine_find_stations row, which the catalog always publishes in feet. Null when CO-OPS publishes no depth for the bin, or when the response carried no prediction rows.",
"type": [
"number",
"null"
]
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `station_not_found`: CO-OPS rejected the station ID as unknown or invalid — current stations require alphanumeric IDs. `invalid_date_range`: begin_date/end_date is not a real calendar date or begin_date is after end_date. `date_range_exceeded`: Requested date range exceeds the 1-year CO-OPS limit. `no_predictions`: Station exists but CO-OPS returned no current-prediction data for the requested date range. `predictions_unavailable`: The station is in the current-predictions catalog, but CO-OPS publishes no current predictions for it at any date. `bin_unavailable`: CO-OPS rejected the requested bin because the station publishes no predictions at that bin. `upstream_throttled`: CO-OPS answered HTTP 403, which it returns for about two minutes while it throttles a burst of requests from one address. Other values are possible when a failure originates below the handler.",
"examples": [
"station_not_found",
"invalid_date_range",
"date_range_exceeded",
"no_predictions",
"predictions_unavailable",
"bin_unavailable",
"upstream_throttled"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"events": {
"description": "Max flood, max ebb, and slack events — the whole matched series when it fits one response, otherwise the leading page starting at offset. Present for MAX_SLACK interval, and empty when CO-OPS answered with a statement instead of events — read notice for its wording.",
"items": {
"additionalProperties": false,
"description": "A single max flood, max ebb, or slack current event.",
"properties": {
"direction": {
"description": "The station's mean flood direction on a flood event and its mean ebb direction on an ebb event, as a true bearing in degrees (0–360). A station constant, not an instantaneous heading. Absent for slack events and wherever CO-OPS reports no mean direction.",
"type": "number"
},
"speed": {
"description": "Peak speed as a non-negative magnitude, in the requested units. Absent when CO-OPS reports no speed for the event, which is the usual case at slack water — though a slack event can carry a small residual speed under metric units.",
"type": "number"
},
"time": {
"description": "Event datetime in the requested time zone.",
"type": "string"
},
"type": {
"description": "Current event type: flood (onshore/inbound flow), ebb (offshore/outbound flow), or slack (near-zero current).",
"enum": [
"flood",
"ebb",
"slack"
],
"type": "string"
}
},
"required": [
"time",
"type"
],
"type": "object"
},
"type": "array"
},
"next_offset": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
],
"description": "Offset to pass as offset on the next call, or null when this page reaches the last matched row. Absent when the whole matched series was returned."
},
"notice": {
"description": "CO-OPS's own statement about the station when it returned that instead of prediction events — the answer to report, not a failure — or what this page of the prediction series covers and how to reach the next one.",
"type": "string"
},
"page_offset": {
"description": "Row offset this page starts at, echoed from the request. Absent when the whole matched series was returned.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"predictions": {
"description": "6-minute continuous current predictions — the whole curve when it fits one response, otherwise the leading page starting at offset. Present for 6min interval, and empty when CO-OPS answered with a statement instead of a curve — read notice for its wording.",
"items": {
"additionalProperties": false,
"description": "A single 6-minute current prediction.",
"properties": {
"direction": {
"description": "The station's mean flood direction on a flood row and its mean ebb direction on an ebb row, as a true bearing in degrees (0–360). A station constant, not an instantaneous heading. Null on a slack row and wherever CO-OPS reports no mean direction.",
"type": [
"number",
"null"
]
},
"speed": {
"description": "Current speed as a non-negative magnitude, in the requested units.",
"type": "number"
},
"time": {
"description": "Prediction datetime in the requested time zone.",
"type": "string"
},
"type": {
"description": "Flow sense at this row, from the sign of the speed CO-OPS predicts: flood (inbound), ebb (outbound), or slack (zero). speed is a non-negative magnitude, so this is what carries which way the water is moving.",
"enum": [
"flood",
"ebb",
"slack"
],
"type": "string"
}
},
"required": [
"time",
"type",
"speed",
"direction"
],
"type": "object"
},
"type": "array"
},
"rows_matched": {
"description": "Prediction rows the requested date range matched, before the page was cut. Absent when the whole matched series was returned.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"rows_returned": {
"description": "Prediction rows this page carries — the length of events on the MAX_SLACK interval, of predictions on 6min. Absent when the whole matched series was returned.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"station_id": {
"description": "Station ID echoed from the request — for chaining.",
"type": "string"
},
"station_name": {
"description": "Station name as returned by CO-OPS.",
"type": "string"
},
"truncated": {
"description": "True when this page stops short of the last matched row, so further rows remain at next_offset. False on the final page and on a page past the end. Absent when the whole matched series was returned.",
"type": "boolean"
},
"units": {
"description": "Unit system these values are in: \"english\" (speed in knots, depth in feet) or \"metric\" (speed in cm/s, depth in meters).",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Verified monthly means for a CO-OPS water-level station, one row per station-month: the month's highest and lowest water, its tidal datums (MHHW, MHW, MSL, MTL, MLW, MLLW, DTL), tidal ranges (GT, MN, DHQ, DLQ), and lunitidal intervals (HWI, LWI) — the record a sea-level or tidal-range trend over years to decades is read from. Heights are relative to the requested datum in the requested units. A value CO-OPS publishes no figure for is omitted rather than reported as zero; a Great Lakes station carries only highest, msl, and lowest. A range may span up to 73,000 days, checked before the call, and CO-OPS verifies this product monthly, for the prior month, so a window ending on or after the first day of the prior month can fail with verified_data_lag. A range whose months fit the response budget is returned whole; a longer one returns the leading months, with rows_matched, rows_returned, and next_offset reporting how many matched and which offset reaches the rest. Use noaa_marine_find_stations with types=[\"water_level\"] first to resolve a station name or location to a station ID.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"begin_date": {
"description": "Start date, YYYYMMDD or YYYY-MM-DD, e.g. \"19750101\" or \"1975-01-01\". The month it falls in is the first month returned.",
"pattern": "^(\\d{8}|\\d{4}-\\d{2}-\\d{2})$",
"type": "string"
},
"datum": {
"default": "MLLW",
"description": "Datum the monthly heights are referenced to. MLLW (default) is the US nautical chart datum; MHHW, MHW, MTL, MSL, and MLW are the other tidal planes. NAVD is NAVD88 and reads only where the station has an NAVD88 tie. STND is the station's own datum and reads any station. IGLD and LWD apply at Great Lakes stations only, which carry no tidal datum, and CRD at Columbia River stations only. A datum this station does not carry comes back as datum_unavailable.",
"enum": [
"MLLW",
"MHHW",
"MHW",
"MTL",
"MSL",
"MLW",
"NAVD",
"STND",
"IGLD",
"LWD",
"CRD"
],
"type": "string"
},
"end_date": {
"description": "End date (inclusive), YYYYMMDD or YYYY-MM-DD, e.g. \"20251231\" or \"2025-12-31\". The month it falls in is the last month returned.",
"pattern": "^(\\d{8}|\\d{4}-\\d{2}-\\d{2})$",
"type": "string"
},
"limit": {
"description": "Maximum months to return on this page, for a caller that wants fewer than the response budget allows. Omit for the largest page that fits; a value larger than the budget allows does not widen the page.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Month offset into the matched series, for reading a range whose months do not fit one response. 0 (default) starts at the first month; pass the next_offset from a previous call to continue. An offset past the last month returns an empty page rather than an error.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"station_id": {
"description": "CO-OPS water-level station ID (numeric, e.g. \"9447130\" for Seattle). Obtain from noaa_marine_find_stations with types=[\"water_level\"].",
"pattern": "^[A-Za-z0-9_-]{1,20}$",
"type": "string"
},
"units": {
"default": "english",
"description": "Unit system for the heights: english = feet; metric = meters. The lunitidal intervals are hours either way.",
"enum": [
"english",
"metric"
],
"type": "string"
}
},
"required": [
"station_id",
"begin_date",
"end_date"
],
"type": "object"
},
"name": "noaa_marine_get_monthly_means",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"station_id",
"station_name",
"datum",
"units",
"begin_date",
"end_date",
"months"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"begin_date": {
"description": "Start of the requested range as sent to CO-OPS, YYYYMMDD.",
"type": "string"
},
"datum": {
"description": "Datum the heights are referenced to — echoed for correct interpretation.",
"type": "string"
},
"end_date": {
"description": "End of the requested range as sent to CO-OPS, YYYYMMDD.",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `invalid_date_range`: begin_date/end_date is not a real calendar date or begin_date is after end_date. `date_range_exceeded`: The requested range spans more than 73,000 days, the CO-OPS limit for monthly means. `station_not_found`: CO-OPS rejected the station ID as not a valid station. `datum_unavailable`: The station does not carry the requested datum — a Great Lakes station has no tidal datum, and IGLD and LWD apply at Great Lakes stations only. `verified_data_lag`: CO-OPS returned no months for a window ending on or after the first day of the prior month, which it may not have verified yet. `no_data`: CO-OPS returned no months for a window ending before the prior month — the station has no monthly means for it. `upstream_throttled`: CO-OPS answered the monthly-mean request with HTTP 403, which it returns for about two minutes while it throttles a burst of requests from one address. Other values are possible when a failure originates below the handler.",
"examples": [
"invalid_date_range",
"date_range_exceeded",
"station_not_found",
"datum_unavailable",
"verified_data_lag",
"no_data",
"upstream_throttled"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"months": {
"description": "One row per station-month in the requested range, oldest first — the whole matched series when it fits one response, otherwise the leading page starting at offset. rows_matched and next_offset report what a page left behind.",
"items": {
"additionalProperties": false,
"description": "One station-month of tidal datums and extremes.",
"properties": {
"dhq": {
"description": "Mean diurnal high water inequality, MHHW − MHW (DHQ), in the requested units. A difference between two tidal planes, so it is the same under every datum. Omitted when CO-OPS publishes no value for the month.",
"type": "number"
},
"dlq": {
"description": "Mean diurnal low water inequality, MLW − MLLW (DLQ), in the requested units. A difference between two tidal planes, so it is the same under every datum. Omitted when CO-OPS publishes no value for the month.",
"type": "number"
},
"dtl": {
"description": "The month's mean diurnal tide level (DTL), in the requested units relative to the requested datum. Omitted when CO-OPS publishes no value for the month.",
"type": "number"
},
"gt": {
"description": "Great diurnal range, MHHW − MLLW (GT), in the requested units. A difference between two tidal planes, so it is the same under every datum. Omitted when CO-OPS publishes no value for the month.",
"type": "number"
},
"highest": {
"description": "The month's highest observed water level, in the requested units relative to the requested datum. Omitted when CO-OPS publishes no value for the month.",
"type": "number"
},
"hwi": {
"description": "Greenwich high water interval (HWI), in hours. Omitted when CO-OPS publishes no value for the month.",
"type": "number"
},
"inferred": {
"description": "CO-OPS inferred-data code for the month, exactly as CO-OPS sends it. Observed values include \"0\", \"1\", and \"11\" — a code, not a boolean.",
"type": "string"
},
"lowest": {
"description": "The month's lowest observed water level, in the requested units relative to the requested datum. Omitted when CO-OPS publishes no value for the month.",
"type": "number"
},
"lwi": {
"description": "Greenwich low water interval (LWI), in hours. Omitted when CO-OPS publishes no value for the month.",
"type": "number"
},
"mhhw": {
"description": "The month's mean higher high water (MHHW), in the requested units relative to the requested datum. Omitted when CO-OPS publishes no value for the month.",
"type": "number"
},
"mhw": {
"description": "The month's mean high water (MHW), in the requested units relative to the requested datum. Omitted when CO-OPS publishes no value for the month.",
"type": "number"
},
"mllw": {
"description": "The month's mean lower low water (MLLW), in the requested units relative to the requested datum. Omitted when CO-OPS publishes no value for the month.",
"type": "number"
},
"mlw": {
"description": "The month's mean low water (MLW), in the requested units relative to the requested datum. Omitted when CO-OPS publishes no value for the month.",
"type": "number"
},
"mn": {
"description": "Mean range of tide, MHW − MLW (MN), in the requested units. A difference between two tidal planes, so it is the same under every datum. Omitted when CO-OPS publishes no value for the month.",
"type": "number"
},
"month": {
"description": "Month number, 1–12.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"msl": {
"description": "The month's mean sea level (MSL), in the requested units relative to the requested datum. Omitted when CO-OPS publishes no value for the month.",
"type": "number"
},
"mtl": {
"description": "The month's mean tide level (MTL), in the requested units relative to the requested datum. Omitted when CO-OPS publishes no value for the month.",
"type": "number"
},
"year": {
"description": "Calendar year of the month.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"year",
"month",
"inferred"
],
"type": "object"
},
"type": "array"
},
"next_offset": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
],
"description": "Offset to pass as offset on the next call, or null when this page reaches the last matched month. Absent when the whole matched series was returned."
},
"notice": {
"description": "What this page of the monthly series covers and how to reach the next page.",
"type": "string"
},
"page_offset": {
"description": "Month offset this page starts at, echoed from the request. Absent when the whole matched series was returned.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"rows_matched": {
"description": "Months the requested range matched, before the page was cut. Absent when the whole matched series was returned.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"rows_returned": {
"description": "Months this page carries — the length of months. Absent when the whole matched series was returned.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"station_id": {
"description": "Station ID echoed from the request — for chaining.",
"type": "string"
},
"station_name": {
"description": "Station name as returned by CO-OPS.",
"type": "string"
},
"truncated": {
"description": "True when this page stops short of the last matched month, so further months remain at next_offset. False on the final page and on a page past the end. Absent when the whole matched series was returned.",
"type": "boolean"
},
"units": {
"description": "Height units: \"english\" (feet) or \"metric\" (meters).",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Live sub-surface oceanographic observations from an NDBC station's water-quality sensors: at each reported depth, water temperature, conductivity, salinity, dissolved oxygen as both saturation percent and concentration in ppm, chlorophyll, turbidity, pH, and redox potential. This is the water-column counterpart to noaa_marine_get_conditions, which returns surface meteorological and wave data — use this tool for what the water is doing below the surface, that one for weather and sea state at the buoy. It returns the most recent observation as one reading per reported depth, and most stations report a single depth while some report several at the same time; sensor coverage is sparse, most stations populating only water temperature and salinity, and any value the station did not report comes back null rather than a fabricated zero, as do latitude and longitude for a station absent from the NDBC active-stations list. Sub-surface sensors are on only a subset of NDBC stations, so find one with noaa_marine_find_stations using source=\"ndbc\" and types=[\"water_quality\"], which filters on NDBC's own water-quality catalog flag — the flag and actual .ocean availability drift, so this tool reads any station that serves the file and returns observations_not_found for one that does not.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"station_id": {
"description": "NDBC station ID (5-character alphanumeric, e.g. \"44033\" or \"TIBC1\"). Obtain from noaa_marine_find_stations with source=\"ndbc\" and types=[\"water_quality\"].",
"pattern": "^[A-Za-z0-9_-]{1,20}$",
"type": "string"
}
},
"required": [
"station_id"
],
"type": "object"
},
"name": "noaa_marine_get_ocean_observations",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"station_id",
"station_name",
"latitude",
"longitude",
"observed_at",
"source",
"reading_count",
"readings"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `observations_not_found`: NDBC returned 404 for the station — no .ocean oceanographic file exists for it. `no_ocean_data`: The .ocean file exists but has no usable data rows — station offline or every depth row missing. Other values are possible when a failure originates below the handler.",
"examples": [
"observations_not_found",
"no_ocean_data"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"latitude": {
"description": "Station latitude in decimal degrees. Null when the station is absent from the NDBC active-stations list — the .ocean feed carries observations but no coordinates.",
"type": [
"number",
"null"
]
},
"longitude": {
"description": "Station longitude in decimal degrees. Null when the station is absent from the NDBC active-stations list.",
"type": [
"number",
"null"
]
},
"observed_at": {
"description": "ISO 8601 UTC timestamp of the observation. Always a valid instant — a row whose upstream time columns are malformed is rejected rather than timestamped with the current time.",
"type": "string"
},
"reading_count": {
"description": "Number of per-depth readings in the latest observation (usually 1).",
"type": "number"
},
"readings": {
"description": "Per-depth readings sharing the most recent observation timestamp, in NDBC source order.",
"items": {
"additionalProperties": false,
"description": "Water-column sensor readings at a single depth.",
"properties": {
"chlorophyll_ug_l": {
"description": "Chlorophyll concentration in µg/l (CLCON). Null when the station did not report it.",
"type": [
"number",
"null"
]
},
"conductivity_ms_cm": {
"description": "Conductivity in mS/cm (COND). Null when the station did not report it.",
"type": [
"number",
"null"
]
},
"depth_m": {
"description": "Measurement depth below the surface in meters (DEPTH).",
"type": "number"
},
"oxygen_percent": {
"description": "Dissolved-oxygen saturation in percent (O2%). Null when the station did not report it.",
"type": [
"number",
"null"
]
},
"oxygen_ppm": {
"description": "Dissolved-oxygen concentration in ppm (O2PPM). Null when the station did not report it.",
"type": [
"number",
"null"
]
},
"ph": {
"description": "pH, dimensionless (PH). Null when the station did not report it.",
"type": [
"number",
"null"
]
},
"redox_mv": {
"description": "Oxidation-reduction (redox) potential in mV (EH). Null when the station did not report it.",
"type": [
"number",
"null"
]
},
"salinity_psu": {
"description": "Salinity in practical salinity units (SAL). Null when the station did not report it.",
"type": [
"number",
"null"
]
},
"turbidity_ftu": {
"description": "Turbidity in Formazin Turbidity Units (TURB). Null when the station did not report it.",
"type": [
"number",
"null"
]
},
"water_temp_c": {
"description": "Water temperature in °C (OTMP). Null when the station did not report it.",
"type": [
"number",
"null"
]
}
},
"required": [
"depth_m",
"water_temp_c",
"conductivity_ms_cm",
"salinity_psu",
"oxygen_percent",
"oxygen_ppm",
"chlorophyll_ug_l",
"turbidity_ftu",
"ph",
"redox_mv"
],
"type": "object"
},
"type": "array"
},
"source": {
"description": "Data source — always \"ndbc\" for this tool.",
"type": "string"
},
"station_id": {
"description": "Station ID echoed from the request — for chaining.",
"type": "string"
},
"station_name": {
"description": "Station name from the NDBC active stations list.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "High and low tide predictions for a CO-OPS tide station over a date range. The default hilo interval returns the time, height, and tide type (H for high, L for low) of each event, while the 6-minute interval returns the detailed tide curve. Most tide stations are subordinate — CO-OPS derives their high and low events as offsets from a reference station and publishes no 6-minute curve for them — so interval=\"6min\" reaches only a reference station, and a subordinate station comes back as subordinate_no_6min naming the reference station to ask instead; the prediction_class on a noaa_marine_find_stations tide row says which kind a station is before the call. Datum defaults to MLLW, mean lower low water, the standard for US nautical charts, and the date range is limited to 1 year per request. A range whose predictions fit the response budget is returned whole; a longer one is returned as a page of leading rows, and rows_matched, rows_returned, and next_offset then report how much matched and which offset reaches the rest, so a year of events is read by walking offset rather than by splitting the range. Use noaa_marine_find_stations first to resolve a station name or location to a numeric station ID.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"begin_date": {
"description": "Start date, YYYYMMDD or YYYY-MM-DD, e.g. \"20240601\" or \"2024-06-01\".",
"pattern": "^(\\d{8}|\\d{4}-\\d{2}-\\d{2})$",
"type": "string"
},
"datum": {
"default": "MLLW",
"description": "Datum the predicted heights are referenced to. MLLW (default) is the US nautical chart datum, and MHHW (mean higher high water) is the flooding reference; MHW, MTL, MSL, MLW, and DTL (diurnal tide level) are the other tidal planes. NAVD is NAVD88 and reads only where the station has an NAVD88 tie. STND is the station's own datum and is the plane that works where no tidal datum exists. CRD applies at Columbia River stations only. A datum this station does not carry comes back as datum_unavailable naming the ones it does.",
"enum": [
"MLLW",
"MHHW",
"MHW",
"MTL",
"MSL",
"MLW",
"DTL",
"NAVD",
"STND",
"CRD"
],
"type": "string"
},
"end_date": {
"description": "End date (inclusive), YYYYMMDD or YYYY-MM-DD, e.g. \"20240607\" or \"2024-06-07\".",
"pattern": "^(\\d{8}|\\d{4}-\\d{2}-\\d{2})$",
"type": "string"
},
"interval": {
"default": "hilo",
"description": "Prediction interval: hilo (default) returns only high and low tide events; 6min returns a continuous prediction curve at 6-minute intervals, and is served only by a reference station — a subordinate station has no 6-minute curve.",
"enum": [
"hilo",
"6min"
],
"type": "string"
},
"limit": {
"description": "Maximum prediction rows to return on this page, for a caller that wants fewer than the response budget allows. Omit for the largest page that fits; a value larger than the budget allows does not widen the page.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Row offset into the matched prediction series, for reading a range whose rows do not fit one response. 0 (default) starts at the first row; pass the next_offset from a previous call to continue. An offset past the last row returns an empty page rather than an error.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"station_id": {
"description": "CO-OPS tide station ID (numeric, e.g. \"9447130\" for Seattle). Obtain from noaa_marine_find_stations with types=[\"tide\"].",
"pattern": "^[A-Za-z0-9_-]{1,20}$",
"type": "string"
},
"time_zone": {
"default": "lst_ldt",
"description": "Time zone for returned timestamps. lst_ldt = local standard/daylight time (default); gmt = UTC; lst = local standard time year-round.",
"enum": [
"lst_ldt",
"gmt",
"lst"
],
"type": "string"
},
"units": {
"default": "english",
"description": "Unit system for heights: english = feet; metric = meters.",
"enum": [
"english",
"metric"
],
"type": "string"
}
},
"required": [
"station_id",
"begin_date",
"end_date"
],
"type": "object"
},
"name": "noaa_marine_get_tide_predictions",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"station_id",
"station_name",
"datum",
"units",
"predictions"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"datum": {
"description": "Tidal datum used (e.g. MLLW) — echoed for correct interpretation of heights.",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `station_not_found`: CO-OPS returned an error for the station ID — likely wrong type or invalid ID. `invalid_date_range`: begin_date/end_date is not a real calendar date or begin_date is after end_date. `date_range_exceeded`: Requested date range exceeds the 1-year CO-OPS limit. `no_predictions`: Station exists but CO-OPS returned no prediction data for the date range. `subordinate_no_6min`: interval=\"6min\" was requested for a subordinate station, whose predictions are high and low events derived from a reference station. `datum_unavailable`: The station does not carry the requested datum — NAVD reads only where the station has an NAVD88 tie, and CRD only on the Columbia River. `upstream_throttled`: CO-OPS answered HTTP 403, which it returns for about two minutes while it throttles a burst of requests from one address. Other values are possible when a failure originates below the handler.",
"examples": [
"station_not_found",
"invalid_date_range",
"date_range_exceeded",
"no_predictions",
"subordinate_no_6min",
"datum_unavailable",
"upstream_throttled"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"next_offset": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
],
"description": "Offset to pass as offset on the next call, or null when this page reaches the last matched row. Absent when the whole matched series was returned."
},
"notice": {
"description": "What this page of the prediction series covers and how to reach the next one. Present only when the response is a page rather than the whole matched series.",
"type": "string"
},
"page_offset": {
"description": "Row offset this page starts at, echoed from the request. Absent when the whole matched series was returned.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"predictions": {
"description": "Tide predictions for the requested date range — the whole series when it fits one response, otherwise the leading page starting at offset. rows_matched and next_offset report what a page left behind.",
"items": {
"additionalProperties": false,
"description": "A single tide prediction event.",
"properties": {
"height": {
"description": "Predicted water height in the requested units (feet or meters) relative to the datum.",
"type": "number"
},
"time": {
"description": "Prediction datetime in the requested time zone (YYYY-MM-DD HH:MM format).",
"type": "string"
},
"type": {
"description": "Tide type: H = high tide, L = low tide (only present for hilo interval).",
"type": "string"
}
},
"required": [
"time",
"height"
],
"type": "object"
},
"type": "array"
},
"rows_matched": {
"description": "Prediction rows the requested date range matched, before the page was cut. Absent when the whole matched series was returned.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"rows_returned": {
"description": "Prediction rows this page carries — the length of predictions. Absent when the whole matched series was returned.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"station_id": {
"description": "Station ID echoed from the request — for chaining.",
"type": "string"
},
"station_name": {
"description": "Station name as returned by CO-OPS — confirms the correct station was queried.",
"type": "string"
},
"truncated": {
"description": "True when this page stops short of the last matched row, so further rows remain at next_offset. False on the final page and on a page past the end. Absent when the whole matched series was returned.",
"type": "boolean"
},
"units": {
"description": "Height units: \"english\" (feet) or \"metric\" (meters).",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Observed water level, real-time or historical, for a CO-OPS water-level station, paired with tide predictions for the same period so the residual (observed − predicted) shows storm surge when positive and anomalous drawdown when negative. The interval selects the cadence: 6min (default) is the full curve, hourly and high_low cover months to a year of the same series at far fewer rows, and daily_mean serves Great Lakes stations only. Each interval carries its own CO-OPS range ceiling — 31 days for 6min, 365 for hourly and high_low, 3655 for daily_mean — rejected locally before the call, and only 6min and hourly report a residual. Observations and predictions are fetched independently, so when the prediction series is empty, predictions_status says whether CO-OPS has none for this station and range or the prediction fetch failed — the observed series returns either way, and residual_summary is present only when both series are and the cadence supports the join. A sensor outage leaves slots with no reading; those slots are dropped and counted in gaps_dropped, so the observed series is continuous across the range only when that count is absent. A range whose rows fit the response budget is returned whole; a longer one returns the leading rows, with rows_matched, rows_returned, and next_offset reporting how much matched and which offset reaches the rest. Use noaa_marine_find_stations first to resolve a station name or location to a valid station ID.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"begin_date": {
"description": "Start date, YYYYMMDD or YYYY-MM-DD, e.g. \"20240601\" or \"2024-06-01\".",
"pattern": "^(\\d{8}|\\d{4}-\\d{2}-\\d{2})$",
"type": "string"
},
"datum": {
"default": "MLLW",
"description": "Datum the observed heights are referenced to. MLLW (default) is the US nautical chart datum, and MHHW (mean higher high water) is the flooding reference; MHW, MTL, MSL, and MLW are the other tidal planes. NAVD is NAVD88 and reads only where the station has an NAVD88 tie. STND is the station's own datum and is the plane that works where no tidal datum exists. IGLD and LWD apply at Great Lakes stations only, CRD at Columbia River stations only, and LWI and HWI are lunitidal intervals rather than heights. A datum this station does not carry comes back as datum_unavailable naming the ones it does.",
"enum": [
"MLLW",
"MHHW",
"MHW",
"MTL",
"MSL",
"MLW",
"NAVD",
"STND",
"IGLD",
"LWD",
"CRD",
"LWI",
"HWI"
],
"type": "string"
},
"end_date": {
"description": "End date (inclusive), YYYYMMDD or YYYY-MM-DD, e.g. \"20240601\" or \"2024-06-01\".",
"pattern": "^(\\d{8}|\\d{4}-\\d{2}-\\d{2})$",
"type": "string"
},
"interval": {
"default": "6min",
"description": "Observed cadence. 6min (default) is the full curve, 31 days per request, the only one carrying a quality flag. hourly is hourly heights, 365 days per request, and reports a residual against the hourly prediction series. high_low is the observed high and low waters with their H/HH/L/LL classification, 365 days per request, and reports no residual because observed extremes do not fall on predicted extreme times. daily_mean is the daily mean water level, 3655 days per request, published at Great Lakes stations only and with no paired prediction series; a coastal station comes back as great_lakes_only.",
"enum": [
"6min",
"hourly",
"high_low",
"daily_mean"
],
"type": "string"
},
"limit": {
"description": "Maximum observation rows to return on this page, for a caller that wants fewer than the response budget allows. Omit for the largest page that fits; a value larger than the budget allows does not widen the page.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Row offset into the matched observation series, for reading a range whose rows do not fit one response. 0 (default) starts at the first row; pass the next_offset from a previous call to continue. An offset past the last row returns an empty page rather than an error.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"station_id": {
"description": "CO-OPS water-level station ID (numeric, e.g. \"9447130\" for Seattle). Obtain from noaa_marine_find_stations with types=[\"water_level\"].",
"pattern": "^[A-Za-z0-9_-]{1,20}$",
"type": "string"
},
"time_zone": {
"default": "lst_ldt",
"description": "Time zone for returned timestamps. lst_ldt = local standard/daylight time (default); gmt = UTC; lst = local standard time year-round. Overridden to lst on interval=\"daily_mean\", which CO-OPS serves in local standard time only and otherwise stamps every row a day off.",
"enum": [
"lst_ldt",
"gmt",
"lst"
],
"type": "string"
},
"units": {
"default": "english",
"description": "Unit system: english = feet; metric = meters.",
"enum": [
"english",
"metric"
],
"type": "string"
}
},
"required": [
"station_id",
"begin_date",
"end_date"
],
"type": "object"
},
"name": "noaa_marine_get_water_level",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"station_id",
"station_name",
"datum",
"units",
"interval",
"observations",
"predictions"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"datum": {
"description": "Tidal datum used — echoed for correct interpretation of water heights.",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `station_not_found`: CO-OPS returned an error for the station ID. `invalid_date_range`: begin_date/end_date is not a real calendar date or begin_date is after end_date. `date_range_exceeded`: Requested date range exceeds the selected interval's CO-OPS limit — 31 days for 6min, 365 for hourly and high_low, 3655 for daily_mean. `no_data`: Station exists but no observed water-level data for the date range — including an hourly, high_low, or daily_mean window ending before the prior month, which is not a verification lag. `great_lakes_only`: interval=\"daily_mean\" was requested for a coastal station — CO-OPS publishes water-level daily means at Great Lakes stations only. `verified_data_lag`: The hourly, high_low, or daily_mean product returned no rows for a window ending on or after the first day of the prior month, which CO-OPS may not have verified yet. `datum_unavailable`: The station does not carry the requested datum — a Great Lakes station has no tidal datum, and NAVD reads only where the station has an NAVD88 tie. `upstream_throttled`: CO-OPS answered the observed-series request with HTTP 403, which it returns for about two minutes while it throttles a burst of requests from one address. Other values are possible when a failure originates below the handler.",
"examples": [
"station_not_found",
"invalid_date_range",
"date_range_exceeded",
"no_data",
"great_lakes_only",
"verified_data_lag",
"datum_unavailable",
"upstream_throttled"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"gaps_dropped": {
"description": "Number of sample slots CO-OPS sent with no reading, dropped from observations. Present only when there was at least one. The observed series is therefore not continuous across the requested range: it has this many missing slots, and rows_matched counts only the slots that carry a value.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"interval": {
"description": "Observed cadence echoed from the request — the CO-OPS product these rows came from, and what decides whether quality, type, and residual_summary are populated.",
"enum": [
"6min",
"hourly",
"high_low",
"daily_mean"
],
"type": "string"
},
"next_offset": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
],
"description": "Offset to pass as offset on the next call, or null when this page reaches the last matched observation. Absent when the whole matched series was returned."
},
"notice": {
"description": "Why the paired prediction series is missing or carries no residual, how many sample slots were dropped, and what this page of the observed series covers — whichever of those apply, composed into one string.",
"type": "string"
},
"observations": {
"description": "Observed water level readings at the requested cadence — the whole matched series when it fits one response, otherwise the leading page starting at offset. rows_matched and next_offset report what a page left behind.",
"items": {
"additionalProperties": false,
"description": "A single observed water level reading at the requested cadence.",
"properties": {
"quality": {
"description": "Quality flag: p = preliminary, v = verified. Present on the 6min interval only — CO-OPS sends no flag with the hourly, high_low, or daily_mean products, which are verified data, so the field is absent rather than defaulted to preliminary.",
"type": "string"
},
"sigma": {
"description": "Standard deviation of the water level sensor reading. Present on the 6min and hourly intervals; CO-OPS sends none for high_low or daily_mean.",
"type": "number"
},
"time": {
"description": "Observation datetime in the requested time zone.",
"type": "string"
},
"type": {
"description": "Observed extreme classification on the high_low interval: H = high water, HH = higher high water, L = low water, LL = lower low water. Absent on every other interval.",
"enum": [
"H",
"HH",
"L",
"LL"
],
"type": "string"
},
"value": {
"description": "Observed water height in the requested units relative to the datum.",
"type": "number"
}
},
"required": [
"time",
"value"
],
"type": "object"
},
"type": "array"
},
"page_offset": {
"description": "Observation row offset this page starts at, echoed from the request. Absent when the whole matched series was returned.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"predictions": {
"description": "Paired tide predictions covering the same period as the returned observations, at the interval matching the observed cadence. Always empty on the daily_mean interval, which has no paired series. Otherwise empty when CO-OPS returned no predictions for this station and range, or when the prediction fetch failed — predictions_status says which.",
"items": {
"additionalProperties": false,
"description": "A single tide prediction.",
"properties": {
"time": {
"description": "Prediction datetime in the requested time zone.",
"type": "string"
},
"value": {
"description": "Predicted water height in the requested units relative to the datum.",
"type": "number"
}
},
"required": [
"time",
"value"
],
"type": "object"
},
"type": "array"
},
"predictions_status": {
"description": "Present only when predictions is empty on an interval that has a paired series. \"empty\" means CO-OPS returned no prediction rows for this station and date range; \"unavailable\" means the prediction fetch failed, so no comparison series could be retrieved and the absence says nothing about the station. Absent when predictions were returned, and on the daily_mean interval, which has no paired series to report on.",
"enum": [
"empty",
"unavailable"
],
"type": "string"
},
"residual_summary": {
"additionalProperties": false,
"description": "Summary of observed-minus-predicted residuals in the requested units, computed across the whole matched series rather than the returned page — so a paged response still reports the largest surge in the range. Present only on the 6min and hourly intervals, and only when both series are available; the notice says why it is absent on high_low and daily_mean.",
"properties": {
"max_drawdown": {
"description": "Maximum negative residual magnitude in the requested units (feet for english, meters for metric) — anomalous drawdown indicator. 0 when the observed level never fell below prediction in the range.",
"type": "number"
},
"max_surge": {
"description": "Maximum positive residual (observed − predicted) in the requested units (feet for english, meters for metric) — storm surge indicator. 0 when the observed level never rose above prediction in the range.",
"type": "number"
}
},
"required": [
"max_surge",
"max_drawdown"
],
"type": "object"
},
"rows_matched": {
"description": "Observation rows the requested date range matched, before the page was cut. Absent when the whole matched series was returned.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"rows_returned": {
"description": "Observation rows this page carries — the length of observations. Absent when the whole matched series was returned.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"station_id": {
"description": "Station ID echoed from the request — for chaining.",
"type": "string"
},
"station_name": {
"description": "Station name as returned by CO-OPS.",
"type": "string"
},
"truncated": {
"description": "True when this page stops short of the last matched observation, so further rows remain at next_offset. False on the final page and on a page past the end. Absent when the whole matched series was returned.",
"type": "boolean"
},
"units": {
"description": "Height units: \"english\" (feet) or \"metric\" (meters).",
"type": "string"
}
},
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:c00b4d00c1d19925682d830a25768a04d1ed43084f9364c04032288e1d9002de | sha256sum