Previous value: -"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), 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."New value: +"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."

Previous value: -"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). E.g. \"WA\", \"CA\", \"PR\"."New value: +"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\"."

Previous value: -"The state filter applied. Restricts results to CO-OPS and excludes NDBC."New value: +"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."

Previous value: -"US state or territory code (CO-OPS stations only)."New value: +"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."

Added value: +{
+  "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"
+}

Added value: +{
+  "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"
+}

Added value: +{
+  "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"
+}

Added value: +{
+  "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"
+}

Previous value: -"Station name substring to match, case-insensitive. E.g. \"seattle\", \"puget sound\". NDBC rows also match on station ID. Blank or whitespace-only values are treated as omitted."New value: +"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."

Previous value: -"Filter value. Five 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), 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`). The sixth, 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."New value: +"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), 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."

Previous value: -[
-  "tide",
-  "current",
-  "water_level",
-  "met",
-  "current_profile",
-  "buoy"
-]New value: +[
+  "tide",
+  "current",
+  "water_level",
+  "met",
+  "current_profile",
+  "water_quality",
+  "buoy"
+]

Added value: +{
+  "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. 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"
+}

Previous value: -"Machine-readable failure mode. Declared by this tool: `no_results`: No stations match the query, location, or filters. `incomplete_coordinates`: Only one of latitude/longitude was supplied — proximity search needs the pair. Other values are possible when a failure originates below the handler."New value: +"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."

Previous value: -[
-  "no_results",
-  "incomplete_coordinates"
-]New value: +[
+  "incomplete_coordinates",
+  "sources_unavailable"
+]

Added value: +{
+  "description": "Guidance about the result set: why a search matched nothing, which catalog did not answer, or that the list was capped.",
+  "type": "string"
+}

Added value: +{
+  "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"
+}

Previous value: -"Stations matching the search criteria, sorted by distance (if lat/lon provided) or name."New value: +"Stations matching the search criteria, sorted by distance (if lat/lon provided) or by exact ID match then name. Empty when nothing matched."

Previous value: -"Data products available at this station: any of tide, current, water_level (CO-OPS) or met, current_profile (NDBC). Empty when the station reports no data capability — platform still identifies it."New value: +"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."

Previous value: -"Total stations matching the filters before the limit was applied."New value: +"Total stations matching the filters before the limit was applied. Zero when nothing matched."

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +false

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "stations",
+      "total_found"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "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: `no_results`: No stations match the query, location, or filters. `incomplete_coordinates`: Only one of latitude/longitude was supplied — proximity search needs the pair. Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "no_results",
+            "incomplete_coordinates"
+          ],
+          "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"
+}

Removed value: -[
-  "stations",
-  "total_found"
-]

Previous value: -"Filter by station capability. Every returned station carries at least one of the requested values in its capabilities list. Omit to return all types. NDBC stations whose only capability is currents match none of these values — reach them with source=\"ndbc\" and no types filter, or by name/ID via query."New value: +"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."

Previous value: -"Station capability, matched against the capabilities list of each station: tide (CO-OPS tide predictions), current (CO-OPS current predictions), water_level (CO-OPS observed water levels), met (NDBC meteorological — the stations noaa_marine_get_conditions reads), buoy (NDBC station reporting neither met nor currents)."New value: +"Filter value. Five 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), 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`). The sixth, 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."

Previous value: -[
-  "tide",
-  "current",
-  "water_level",
-  "buoy",
-  "met"
-]New value: +[
+  "tide",
+  "current",
+  "water_level",
+  "met",
+  "current_profile",
+  "buoy"
+]

Previous value: -"List of data products available at this station."New value: +"Data products available at this station: any of tide, current, water_level (CO-OPS) or met, current_profile (NDBC). Empty when the station reports no data capability — platform still identifies it."

Added value: +{
+  "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"
+}

Previous value: -"The capability this row leads with — always one of the values in capabilities. When a types filter is set this is the first requested capability the station has, so it never contradicts the filter; otherwise it is the first capability. This is a data-product capability, not the physical platform classification — for that, read the noaa-marine://station/{station_id} resource."New value: +"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."

Previous value: -[
-  "station_id",
-  "name",
-  "source",
-  "type",
-  "latitude",
-  "longitude",
-  "capabilities"
-]New value: +[
+  "station_id",
+  "name",
+  "source",
+  "latitude",
+  "longitude",
+  "capabilities"
+]

Previous value: -"Center latitude in decimal degrees for proximity search. Pair with longitude and optionally radius_km."New value: +"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."

Previous value: -"Center longitude in decimal degrees for proximity search. Pair with latitude and optionally radius_km."New value: +"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."

Previous value: -"Station name substring to search (case-insensitive token match). E.g. \"seattle\", \"puget sound\"."New value: +"Station name substring to match, case-insensitive. E.g. \"seattle\", \"puget sound\". NDBC rows also match on station ID. Blank or whitespace-only values are treated as omitted."

Previous value: -"Filter by station type/capability. Omit to return all types."New value: +"Filter by station capability. Every returned station carries at least one of the requested values in its capabilities list. Omit to return all types. NDBC stations whose only capability is currents match none of these values — reach them with source=\"ndbc\" and no types filter, or by name/ID via query."

Previous value: -"Station capability type: tide (CO-OPS tide predictions), current (CO-OPS current predictions), water_level (CO-OPS observed water levels), buoy (NDBC buoy), met (NDBC meteorological)."New value: +"Station capability, matched against the capabilities list of each station: tide (CO-OPS tide predictions), current (CO-OPS current predictions), water_level (CO-OPS observed water levels), met (NDBC meteorological — the stations noaa_marine_get_conditions reads), buoy (NDBC station reporting neither met nor currents)."

Previous value: -"Station type/capability string, e.g. \"tide\", \"current\", \"water_level\", \"buoy\"."New value: +"The capability this row leads with — always one of the values in capabilities. When a types filter is set this is the first requested capability the station has, so it never contradicts the filter; otherwise it is the first capability. This is a data-product capability, not the physical platform classification — for that, read the noaa-marine://station/{station_id} resource."

Previous value: -"Filter by 2-letter US state or territory code (CO-OPS stations only). E.g. \"WA\", \"CA\", \"PR\"."New value: +"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). E.g. \"WA\", \"CA\", \"PR\"."

Added value: +{
+  "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"
+}