@cyanheads/noaa-marine-mcp-server 0.6.0 → 0.6.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/AGENTS.md +21 -16
  2. package/CLAUDE.md +21 -16
  3. package/Dockerfile +92 -36
  4. package/README.md +87 -98
  5. package/changelog/0.6.x/0.6.1.md +31 -0
  6. package/changelog/0.6.x/0.6.2.md +27 -0
  7. package/dist/mcp-server/resources/definitions/noaa-marine-station.resource.js +2 -2
  8. package/dist/mcp-server/resources/definitions/noaa-marine-station.resource.js.map +1 -1
  9. package/dist/mcp-server/tools/definitions/noaa-marine-find-stations.tool.d.ts.map +1 -1
  10. package/dist/mcp-server/tools/definitions/noaa-marine-find-stations.tool.js +15 -9
  11. package/dist/mcp-server/tools/definitions/noaa-marine-find-stations.tool.js.map +1 -1
  12. package/dist/mcp-server/tools/definitions/noaa-marine-get-conditions.tool.d.ts.map +1 -1
  13. package/dist/mcp-server/tools/definitions/noaa-marine-get-conditions.tool.js +4 -3
  14. package/dist/mcp-server/tools/definitions/noaa-marine-get-conditions.tool.js.map +1 -1
  15. package/dist/mcp-server/tools/definitions/noaa-marine-get-current-profile.tool.d.ts.map +1 -1
  16. package/dist/mcp-server/tools/definitions/noaa-marine-get-current-profile.tool.js +4 -3
  17. package/dist/mcp-server/tools/definitions/noaa-marine-get-current-profile.tool.js.map +1 -1
  18. package/dist/mcp-server/tools/definitions/noaa-marine-get-currents.tool.d.ts +1 -1
  19. package/dist/mcp-server/tools/definitions/noaa-marine-get-currents.tool.d.ts.map +1 -1
  20. package/dist/mcp-server/tools/definitions/noaa-marine-get-currents.tool.js +24 -25
  21. package/dist/mcp-server/tools/definitions/noaa-marine-get-currents.tool.js.map +1 -1
  22. package/dist/mcp-server/tools/definitions/noaa-marine-get-monthly-means.tool.d.ts +1 -1
  23. package/dist/mcp-server/tools/definitions/noaa-marine-get-monthly-means.tool.d.ts.map +1 -1
  24. package/dist/mcp-server/tools/definitions/noaa-marine-get-monthly-means.tool.js +12 -13
  25. package/dist/mcp-server/tools/definitions/noaa-marine-get-monthly-means.tool.js.map +1 -1
  26. package/dist/mcp-server/tools/definitions/noaa-marine-get-ocean-observations.tool.d.ts.map +1 -1
  27. package/dist/mcp-server/tools/definitions/noaa-marine-get-ocean-observations.tool.js +4 -3
  28. package/dist/mcp-server/tools/definitions/noaa-marine-get-ocean-observations.tool.js.map +1 -1
  29. package/dist/mcp-server/tools/definitions/noaa-marine-get-tide-predictions.tool.d.ts +1 -1
  30. package/dist/mcp-server/tools/definitions/noaa-marine-get-tide-predictions.tool.d.ts.map +1 -1
  31. package/dist/mcp-server/tools/definitions/noaa-marine-get-tide-predictions.tool.js +11 -12
  32. package/dist/mcp-server/tools/definitions/noaa-marine-get-tide-predictions.tool.js.map +1 -1
  33. package/dist/mcp-server/tools/definitions/noaa-marine-get-water-level.tool.d.ts +1 -1
  34. package/dist/mcp-server/tools/definitions/noaa-marine-get-water-level.tool.d.ts.map +1 -1
  35. package/dist/mcp-server/tools/definitions/noaa-marine-get-water-level.tool.js +14 -15
  36. package/dist/mcp-server/tools/definitions/noaa-marine-get-water-level.tool.js.map +1 -1
  37. package/dist/services/coops/coops-service.d.ts.map +1 -1
  38. package/dist/services/coops/coops-service.js +12 -17
  39. package/dist/services/coops/coops-service.js.map +1 -1
  40. package/package.json +12 -11
  41. package/server.json +10 -24
package/README.md CHANGED
@@ -7,7 +7,7 @@
7
7
 
8
8
  <div align="center">
9
9
 
10
- [![Version](https://img.shields.io/badge/Version-0.6.0-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/noaa-marine-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^2.0.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/noaa-marine-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/noaa-marine-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^7.0.2-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.4.0-blueviolet.svg?style=flat-square)](https://bun.sh/)
10
+ [![Version](https://img.shields.io/badge/Version-0.6.2-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/noaa-marine-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^2.3.1-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/noaa-marine-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/noaa-marine-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^7.0.2-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.4.4-blueviolet.svg?style=flat-square)](https://bun.sh/)
11
11
 
12
12
  </div>
13
13
 
@@ -29,131 +29,96 @@
29
29
 
30
30
  ## Overview
31
31
 
32
- US tide, current, and buoy data from NOAA CO-OPS and NDBC. Find tide, water-level, and current stations plus NDBC buoys, then fetch tide predictions, observed water levels, tidal currents, and live buoy conditions from any MCP client. Runs as a stdio process, a local Streamable HTTP server, or the public hosted endpoint above.
32
+ US tides, currents, water levels, and buoy observations from NOAA CO-OPS and NDBC. Find coastal stations and buoys, then fetch tide and tidal-current predictions, observed and monthly-mean water levels, and live buoy conditions, current profiles, and water-column readings.
33
33
 
34
34
  ### Tools
35
35
 
36
36
  | Tool | Description |
37
37
  |:-----|:------------|
38
- | `noaa_marine_find_stations` | Find CO-OPS tide/water-level/current stations and NDBC buoys by location, name, state, or data capability. |
39
- | `noaa_marine_get_tide_predictions` | High/low tide predictions or a 6-minute curve for a CO-OPS tide station. |
40
- | `noaa_marine_get_water_level` | Observed water level at a 6-minute, hourly, high/low, or daily-mean cadence, paired with predictions and a storm-surge residual summary. |
41
- | `noaa_marine_get_monthly_means` | Verified monthly tidal datums and extremes for a CO-OPS water-level station — the record for sea-level and tidal-range trends. |
42
- | `noaa_marine_get_currents` | CO-OPS tidal current predictions — max flood/ebb/slack events or a 6-minute curve. |
43
- | `noaa_marine_get_conditions` | Live NDBC buoy conditions: waves, wind, sea-surface and air temperature, pressure. |
44
- | `noaa_marine_get_current_profile` | Observed ocean-current depth profile from an NDBC ADCP buoy. |
45
- | `noaa_marine_get_ocean_observations` | Sub-surface water-column observations (temperature, salinity, oxygen, and more) from an NDBC station. |
38
+ | `noaa_marine_find_stations` | Find CO-OPS tide, water-level, and current stations and NDBC buoys by location, name, ID, state, or capability |
39
+ | `noaa_marine_get_tide_predictions` | High/low tide predictions or a 6-minute curve for a CO-OPS tide station |
40
+ | `noaa_marine_get_water_level` | Observed water level at four cadences, paired with predictions and a storm-surge residual |
41
+ | `noaa_marine_get_monthly_means` | Verified monthly tidal datums and extremes for a CO-OPS water-level station |
42
+ | `noaa_marine_get_currents` | CO-OPS tidal-current predictions: max flood, max ebb, and slack events, or a 6-minute curve |
43
+ | `noaa_marine_get_conditions` | Live NDBC buoy conditions: waves, wind, sea-surface and air temperature, pressure |
44
+ | `noaa_marine_get_current_profile` | Observed ocean-current depth profile from an NDBC ADCP buoy |
45
+ | `noaa_marine_get_ocean_observations` | Sub-surface water-column readings (temperature, salinity, oxygen, and more) from an NDBC station |
46
46
 
47
47
  ### Resources
48
48
 
49
49
  | Resource | Description |
50
50
  |:---|:---|
51
- | `noaa-marine://station/{station_id}` | Metadata for a CO-OPS or NDBC station by ID: name, coordinates, source, data capabilities, and — for NDBC — physical platform class. |
51
+ | `noaa-marine://station/{station_id}` | Metadata for a CO-OPS or NDBC station: name, coordinates, source, capabilities, prediction class, platform |
52
52
 
53
- All resource data is also reachable via tools — use `noaa_marine_find_stations` to discover station IDs before accessing the resource.
53
+ Everything in the resource except NDBC `owner` is also on `noaa_marine_find_stations` rows, for clients that only call tools.
54
54
 
55
55
  ## Capability reference
56
56
 
57
57
  ### `noaa_marine_find_stations` <sub>tool</sub>
58
58
 
59
- - Filter by proximity (`latitude`/`longitude` + `radius_km`, default 100 km, max 1000 km), name/ID substring (matched against both sources; an exact ID match sorts first), US state/territory (CO-OPS only), source (`coops`/`ndbc`/`all`), or `types`: data capabilities (`tide`, `current`, `water_level`, `met`, `current_profile`, `water_quality`) or NDBC platform class (`buoy`)
60
- - A CO-OPS station whose catalog rows carry no state code — every current station, and some tide and water-level stations — reports and filters on the state of the nearest state-bearing tide or water-level station within 25 km, marked `state_derived: true`; that state can be wrong on waters shared across a state or national border. A station with no such neighbor shows its own non-code catalog value (e.g. `FM`) if it publishes one, which no state filter matches
61
- - Returns up to `limit` (default 20, max 200) unified stations with source, coordinates, distance, data capabilities, and — for NDBC — physical platform class (buoy, fixed, oilrig, dart, tao, usv, other)
62
- - CO-OPS prediction stations also carry `prediction_class`, a third axis beside capability and platform: a tide station is `reference` (serving `hilo` and the 6-minute curve) or `subordinate` (`hilo` only, with `reference_id` naming where its offsets come from), while a current station reports its class per depth bin in `bins[]` alongside each bin's number and catalog depth in feet — the bin numbers `noaa_marine_get_currents` takes as `bin`
63
- - `total_found` and `truncated` report the full match count before the limit is applied
64
- - Zero matches is a success with `total_found: 0`, carrying a notice derived from the filters that were applied and an echo of the applied search
65
- - A catalog that fails to load is reported as an unread source alongside the results; when every needed catalog fails, that is a typed `sources_unavailable` error rather than an empty search, whose recovery names the couple-of-minutes wait when the CO-OPS catalog was throttled
66
- - Station lists are cached in-memory with a 6-hour TTL — first call after startup may be slightly slower
67
- - Typed `incomplete_coordinates` error when only one of latitude/longitude is supplied
59
+ - Filters combine: `latitude` + `longitude` with `radius_km` (default 100, max 1000), `query` (name or ID substring on both sources; an exact ID leads unless sorting by distance), `state` (CO-OPS only), `source` (`coops` / `ndbc` / `all`), and `types` (`tide`, `current`, `water_level`, `met`, `current_profile`, `water_quality`, or the platform class `buoy`); `limit` defaults to 20, max 200
60
+ - Each station carries `source`, `capabilities`, `type`, and for NDBC a `platform`; CO-OPS rows add `state` (`state_derived: true` when borrowed from the nearest state-bearing station within 25 km), a tide `prediction_class` (`reference`, or `subordinate` with `reference_id`), and current `bins[]` giving each bin's number, depth in feet, and class
61
+ - `total_found` and `truncated` report the count before `limit`; zero matches is a success with `applied_search`, a partial catalog read is flagged in `sources`, and total catalog failure is `sources_unavailable`; only one of `latitude`/`longitude` is `incomplete_coordinates`
68
62
 
69
63
  ---
70
64
 
71
65
  ### `noaa_marine_get_tide_predictions` <sub>tool</sub>
72
66
 
73
- - `hilo` (default, high/low events) or `6min` continuous curve; up to 1 year per request, with `begin_date`/`end_date` as `YYYYMMDD` or `YYYY-MM-DD`
74
- - A range whose rows fit the response budget returns whole; a longer one returns the leading rows as a page, with `rows_matched`, `rows_returned`, `page_offset`, and `next_offset` on both consumption surfaces. Walk it with `offset`; `limit` lowers a page and never raises it past the byte bound, and an `offset` past the last row is an empty page rather than an error
75
- - `6min` is served by reference stations only — a subordinate station's high and low events are offsets from a reference station and it has no 6-minute curve, so the request is refused before the upstream call as a typed `subordinate_no_6min` naming `hilo` and that reference station
76
- - Ten datums, matching what the CO-OPS predictions product accepts: MLLW (default, US nautical chart), MHHW, MHW, MTL, MSL, MLW, DTL, NAVD (NAVD88, where the station has a tie), STND (the station's own datum), CRD (Columbia River only)
77
- - A datum the station does not carry is a typed `datum_unavailable` naming the planes it does, not a report that the station ID was wrong; a Great Lakes station, which publishes no prediction series at any datum, is `no_predictions` pointing at `noaa_marine_get_water_level`
78
- - Time zone (`lst_ldt` default, `gmt`, `lst`) and units (`english` default feet, `metric` meters)
79
- - Typed `date_range_exceeded`, `invalid_date_range`, `station_not_found`, `no_predictions`, `datum_unavailable`, `subordinate_no_6min`, and `upstream_throttled` errors — the last a retryable `RateLimited` for the HTTP 403 CO-OPS answers a burst of requests with, whose recovery says to wait a couple of minutes
67
+ - `interval` `hilo` (default) or `6min`, up to 365 days; ten datums (MLLW, MHHW, MHW, MTL, MSL, MLW, DTL, NAVD, STND, CRD), `time_zone` (`lst_ldt`, `gmt`, `lst`), and `units` (`english` feet, `metric` meters)
68
+ - `6min` works at reference stations only: a subordinate station fails as `subordinate_no_6min` naming its reference station, and a Great Lakes station is `no_predictions`, pointing to `noaa_marine_get_water_level`
69
+ - Other failures: `invalid_date_range`, `date_range_exceeded`, `station_not_found`, `datum_unavailable` (naming the planes the station carries), and `upstream_throttled`, a retryable CO-OPS HTTP 403 that clears in a couple of minutes
80
70
 
81
71
  ---
82
72
 
83
73
  ### `noaa_marine_get_water_level` <sub>tool</sub>
84
74
 
85
- - `interval` selects the cadence: `6min` (default) the full curve, `hourly` hourly heights, `high_low` the observed high and low waters with their `H`/`HH`/`L`/`LL` classification, `daily_mean` the daily mean at Great Lakes stations only. The `interval` is echoed in the output
86
- - `begin_date`/`end_date` as `YYYYMMDD` or `YYYY-MM-DD`. Per-interval CO-OPS range ceilings, rejected locally before the call: 31 days for `6min`, 365 for `hourly` and `high_low`, 3,655 for `daily_mean`. A coarser cadence is not automatically a smaller response — a year of `hourly` rows outweighs a month of 6-minute ones — so the ceiling bounds the request and the response budget bounds the page
87
- - Quality flags (`p` preliminary, `v` verified) on `6min` only: CO-OPS sends no flag with the coarser products, and `quality` is omitted rather than defaulted to preliminary, which would label verified data unverified. Sensor `sigma` on `6min` and `hourly`
88
- - Thirteen datums, matching what the CO-OPS water-level product accepts: MLLW (default, US nautical chart), MHHW, MHW, MTL, MSL, MLW, NAVD (NAVD88, where the station has a tie), STND (the station's own datum), IGLD and LWD (Great Lakes only), CRD (Columbia River only), LWI and HWI (lunitidal intervals)
89
- - A datum the station does not carry is a typed `datum_unavailable` whose recovery names the planes that do read it — `STND`, `IGLD`, `LWD` at a Great Lakes station, `MLLW`/`STND` where an NAVD88 tie is missing — rather than sending the caller back to re-verify an ID `noaa_marine_find_stations` just returned
90
- - A sensor outage leaves slots with no reading; they are dropped and counted in `gaps_dropped`, so `rows_matched` always counts only the slots that carried a value and continuous coverage across the range is only implied when that count is absent
91
- - Paired tide predictions at the interval matching the observed cadence, fetched in parallel — the observed series returns either way, and `predictions_status` says whether an empty prediction series means CO-OPS has none or the fetch failed. Not fetched at all on `daily_mean`, which has no paired series
92
- - `residual_summary` (max surge, max drawdown) only when both series are present, computed from the finite observed/predicted pairs across the whole matched series rather than the returned page. Each side clamps at zero, so a window that stayed above prediction reports `max_drawdown: 0` and one that stayed below reports `max_surge: 0`. Reported on `6min` and `hourly` only — observed high and low waters do not occur at the predicted extreme times, so a `high_low` join would rest on a small fraction of the events, and `daily_mean` has no paired series at all; the notice says which applies
93
- - A range whose rows fit the response budget returns whole; a longer one returns the leading rows as a page, with `rows_matched`, `rows_returned`, `page_offset`, and `next_offset` on both consumption surfaces. Observations carry the `offset` and the paired predictions follow by time window, so a page's two series always describe one span even after gap rows shorten the observed one
94
- - `daily_mean` is requested in local standard time whatever `time_zone` was passed — CO-OPS serves that product in LST only and silently shifts any other zone by a day
95
- - Typed `date_range_exceeded`, `invalid_date_range`, `station_not_found`, `no_data`, `datum_unavailable`, `great_lakes_only` (`daily_mean` at a coastal station), `verified_data_lag`, and `upstream_throttled` errors — `verified_data_lag` for an `hourly`, `high_low`, or `daily_mean` window ending on or after the first day of the prior month, which CO-OPS may not have verified yet since it verifies the coarser products monthly for the prior month (an earlier window it answers the same way is `no_data`, since waiting cannot help it), and `upstream_throttled` for the HTTP 403 CO-OPS answers a burst of requests with (a 403 on the paired prediction fetch alone leaves `predictions_status: "unavailable"` instead, with a notice naming the wait)
75
+ - `interval` `6min` (default, 31 days), `hourly` or `high_low` (365 days), or `daily_mean` (3,655 days, Great Lakes only, always in LST; a coastal station is `great_lakes_only`); thirteen datums (MLLW, MHHW, MHW, MTL, MSL, MLW, NAVD, STND, IGLD, LWD, CRD, LWI, HWI)
76
+ - Observations carry `quality` (`p` / `v`, `6min` only), `sigma` (`6min` and `hourly`), and `type` (`H` / `HH` / `L` / `LL`, `high_low` only); slots with no reading are dropped and counted in `gaps_dropped`
77
+ - Paired predictions at the matching cadence (none on `daily_mean`), with `predictions_status` (`empty` / `unavailable`) explaining an empty series; `residual_summary` (`max_surge`, `max_drawdown`) covers the whole matched range, on `6min` and `hourly` only. Failures: `invalid_date_range`, `date_range_exceeded`, `station_not_found`, `datum_unavailable`, `no_data`, `verified_data_lag` (a coarser-cadence window ending on or after the first day of the prior month, which CO-OPS may not have verified yet), and `upstream_throttled`
96
78
 
97
79
  ---
98
80
 
99
81
  ### `noaa_marine_get_monthly_means` <sub>tool</sub>
100
82
 
101
- - One row per station-month of the CO-OPS `monthly_mean` product: the month's `highest` and `lowest` water, its tidal datums (`mhhw`, `mhw`, `msl`, `mtl`, `mlw`, `mllw`, `dtl`), ranges (`gt`, `mn`, `dhq`, `dlq`), lunitidal intervals in hours (`hwi`, `lwi`), and CO-OPS's `inferred` code passed through verbatim — a code (`0`, `1`, `11` observed), not a boolean
102
- - Heights are relative to the requested datum — eleven reference planes: MLLW (default), MHHW, MHW, MTL, MSL, MLW, NAVD, STND, IGLD and LWD (Great Lakes only), CRD (Columbia River only) — in `english` feet or `metric` meters. The ranges (`gt`, `mn`, `dhq`, `dlq`) are differences between two planes, so they read the same under every datum. A value CO-OPS publishes as an empty string is omitted, never zeroed — a Great Lakes station at `IGLD` carries only `highest`, `msl`, and `lowest`
103
- - `begin_date`/`end_date` as `YYYYMMDD` or `YYYY-MM-DD`, spanning up to 73,000 days (the ceiling CO-OPS names), rejected locally before the call. The months the two dates fall in are the first and last returned; CO-OPS answers one month past `end_date`, and that month is dropped
104
- - A range whose months fit the response budget returns whole; a longer one — decades of months — returns the leading months as a page with `rows_matched`, `rows_returned`, `page_offset`, and `next_offset`. Walk it with `offset`; an `offset` past the last month is an empty page rather than an error
105
- - Typed `invalid_date_range`, `date_range_exceeded`, `station_not_found`, `datum_unavailable`, `verified_data_lag`, `no_data`, and `upstream_throttled` errors. CO-OPS answers an unpublished window with one sentence whatever the cause, so a window ending on or after the first day of the prior month is `verified_data_lag` and any earlier one is `no_data`
106
- - Returns the monthly record, not a trend — fitting one is left to the caller
83
+ - Up to 73,000 days per request; eleven datums (MLLW, MHHW, MHW, MTL, MSL, MLW, NAVD, STND, IGLD, LWD, CRD) in `english` feet or `metric` meters; the first and last months returned are those `begin_date` and `end_date` fall in
84
+ - One row per month: `highest`, `lowest`, the tidal datums (`mhhw`, `mhw`, `msl`, `mtl`, `mlw`, `mllw`, `dtl`), ranges (`gt`, `mn`, `dhq`, `dlq`), lunitidal intervals in hours (`hwi`, `lwi`), and the `inferred` code verbatim; values CO-OPS leaves blank are omitted, so a Great Lakes station carries only `highest`, `msl`, and `lowest`
85
+ - Failures: `invalid_date_range`, `date_range_exceeded`, `station_not_found`, `datum_unavailable`, `upstream_throttled`, and for an empty window `verified_data_lag` when it ends on or after the first day of the prior month, `no_data` otherwise
107
86
 
108
87
  ---
109
88
 
110
89
  ### `noaa_marine_get_currents` <sub>tool</sub>
111
90
 
112
- - `MAX_SLACK` (default): max flood, max ebb, and slack events only — the actionable view for passage planning
113
- - `6min`: continuous current curve, each row carrying its own `flood`/`ebb`/`slack` sense plus the station mean flood or ebb bearing that sense implies (a station constant, not an instantaneous heading)
114
- - Both intervals are bounded by response size: a range whose rows fit the response budget returns whole; a longer one returns the leading rows as a page, with `rows_matched`, `rows_returned`, `page_offset`, and `next_offset` on both surfaces. `offset` and `limit` walk whichever series the interval selects — the max/slack events or the 6-minute curve
115
- - Units `english` (knots for speed, feet for the echoed depth, default) or `metric` (cm/s for speed, meters for depth) — CO-OPS publishes metric current speed in cm/s, the unit `noaa_marine_get_current_profile` also reports
116
- - `bin` selects one of a station's depth bins; omit it for the CO-OPS default, the shallowest. The bin CO-OPS answered with and its depth are echoed on every response, and a bin the station does not publish is a typed `bin_unavailable` naming the bins it does
117
- - A station whose currents CO-OPS will not predict as discrete events returns an empty list plus CO-OPS's own wording in the notice, not an error
118
- - Current station IDs are alphanumeric (e.g. `ACT4176`), distinct from numeric tide/water-level IDs
119
- - Up to 1 year per request, with `begin_date`/`end_date` as `YYYYMMDD` or `YYYY-MM-DD`; typed `date_range_exceeded`, `invalid_date_range`, `station_not_found`, `no_predictions`, `predictions_unavailable`, `bin_unavailable`, and `upstream_throttled` (the HTTP 403 CO-OPS answers a burst of requests with) errors
91
+ - `interval` `MAX_SLACK` (default: max flood, max ebb, and slack events) or `6min`, up to 365 days; `bin` picks a depth bin from `bins[]` (default the shallowest); `units` `english` (knots, feet) or `metric` (cm/s, meters)
92
+ - Every response echoes `bin` and `depth`; rows carry a `flood` / `ebb` / `slack` `type`, a non-negative `speed`, and as `direction` the station's mean bearing for that flow
93
+ - A bin the station lacks is `bin_unavailable` listing the ones it has; a station CO-OPS won't predict as events returns an empty list with its statement in `notice`, and one with no published predictions is `predictions_unavailable`; also `invalid_date_range`, `date_range_exceeded`, `station_not_found`, `no_predictions`, and `upstream_throttled`
120
94
 
121
95
  ---
122
96
 
123
97
  ### `noaa_marine_get_conditions` <sub>tool</sub>
124
98
 
125
- - Wave height/period/direction, wind speed/gust/direction, sea-surface and air temperature, dew point, barometric pressure
126
- - All values SI except `tide_ft` (feet) and `visibility_nmi` (nautical miles), both rarely populated at offshore buoys
127
- - Every sensor field is nullable — `null` when the buoy did not report, never a fabricated value. `latitude`/`longitude` are `null` for a station absent from the NDBC catalog, and `observed_at` is always a valid instant
128
- - NDBC writes each block of columns on its own cycle, so a block resolves from the most recent row within 90 minutes that carried it: waves report their own `waves_observed_at`, and any other block read from an earlier row is named with its measurement time in the response notice. Row cadence runs 5–60 minutes depending on the station
129
- - Typed `buoy_not_found` and `no_sensor_data` errors
99
+ - One NDBC `station_id`; returns wind, waves, sea-surface and air temperature, dew point, and pressure in SI units, except `tide_ft` and `visibility_nmi`
100
+ - Every sensor field is nullable; each column block comes from the newest row within 90 minutes that carried it, waves reporting their own `waves_observed_at` and any other older block named in `notice`. Failures: `buoy_not_found`, `no_sensor_data`
130
101
 
131
102
  ---
132
103
 
133
104
  ### `noaa_marine_get_current_profile` <sub>tool</sub>
134
105
 
135
- - Depth (m), direction (degrees true, flow-toward), and speed (cm/s) per bin, shallowest first
136
- - Observed NDBC ADCP measurement — distinct from `noaa_marine_get_currents`, a CO-OPS tidal-current *prediction*
137
- - Most NDBC stations serve no ADCP profile; use `find_stations` with `types: ["current_profile"]` to discover ones that do
138
- - Direction or speed is `null` per bin when the sensor did not report that component; typed `profile_not_found` and `no_current_data` errors
106
+ - One NDBC `station_id`, found with `types: ["current_profile"]`; `bins[]` runs shallowest first with `depth_m`, `direction_deg` (true, flow-toward), and `speed_cm_s`, the last two null when unreported
107
+ - Observed ADCP measurements, not the CO-OPS predictions `noaa_marine_get_currents` returns; failures are `profile_not_found` (no ADCP file) and `no_current_data`
139
108
 
140
109
  ---
141
110
 
142
111
  ### `noaa_marine_get_ocean_observations` <sub>tool</sub>
143
112
 
144
- - Water temperature, conductivity, salinity, dissolved oxygen (% and ppm), chlorophyll, turbidity, pH, and redox potential per depth
145
- - Water-column counterpart to `noaa_marine_get_conditions` (surface weather and sea state)
146
- - Sensor coverage is sparse — most stations report only temperature and salinity; unreported values are `null`, never a fabricated zero
147
- - Find candidates with `find_stations` using `source="ndbc"` and `types: ["water_quality"]`, NDBC's own water-quality catalog flag — a strong hint, not a guarantee, so expect `observations_not_found` on a flagged station serving no `.ocean` file
113
+ - One NDBC `station_id`, found with `types: ["water_quality"]`, a catalog flag rather than a guarantee; `readings[]` holds one row per depth with temperature, conductivity, salinity, dissolved oxygen (% and ppm), chlorophyll, turbidity, pH, and redox potential
114
+ - Most stations report only temperature and salinity, and unreported values are `null`; failures are `observations_not_found` (no `.ocean` file) and `no_ocean_data`
148
115
 
149
116
  ---
150
117
 
151
118
  ### `noaa-marine://station/{station_id}` <sub>resource</sub>
152
119
 
153
- - Station record as `application/json` — name, coordinates, source, capabilities, state (with `state_derived`, resolved as on `noaa_marine_find_stations`), the CO-OPS `prediction_class` (with `reference_id` or per-bin `bins[]`, exactly as on `noaa_marine_find_stations`), and (NDBC) platform class
154
- - `station_id` comes from `noaa_marine_find_stations`
155
- - Typed `station_not_found` when both catalogs were read and neither carries the ID, and `source_unavailable` when a catalog could not be read — a station only the unread catalog carries is never reported as nonexistent. When the unread CO-OPS catalog was throttled (HTTP 403), the recovery names the couple-of-minutes wait
156
- - Cached with a 6-hour TTL (`cacheHint`)
120
+ - `station_id` from `noaa_marine_find_stations`; returns that tool's station record as `application/json`, plus `owner` for NDBC stations, with a 6-hour `cacheHint`
121
+ - `station_not_found` only when both catalogs were read; `source_unavailable` when one could not be
157
122
 
158
123
  ## Features
159
124
 
@@ -161,38 +126,57 @@ Built on [`@cyanheads/mcp-ts-core`](https://github.com/cyanheads/mcp-ts-core): s
161
126
 
162
127
  CO-OPS / NDBC-specific:
163
128
 
164
- - In-memory station cache (6-hour TTL) for CO-OPS and NDBC station lists — discovery is fast after first startup
165
- - CO-OPS and NDBC integrated in a unified station model — `find_stations` fans out across both sources in parallel
166
- - NDBC fixed-width text parser normalizes `MM` (missing sensor data) to `null`, never passes it through as a string
167
- - Paired water-level and prediction fetches for storm-surge residual computation
168
- - CO-OPS `application=` courtesy parameter sent on every request (configurable via `NOAA_APPLICATION_ID`)
129
+ - CO-OPS data and metadata APIs plus the NDBC active-stations catalog and `realtime2` feeds (`.txt`, `.adcp`, `.ocean`), with station catalogs cached in memory for 6 hours; CO-OPS requests carry `application=` from `NOAA_APPLICATION_ID`
130
+ - Station IDs never cross sources: CO-OPS tide and water-level IDs are numeric (`9447130`), CO-OPS current IDs alphanumeric (`ACT4176`), NDBC IDs 5-character codes (`46041`)
131
+ - CO-OPS tools take `begin_date` / `end_date` as `YYYYMMDD` or `YYYY-MM-DD` and check the calendar and each tool's range ceiling before calling (`invalid_date_range`, `date_range_exceeded`); heights default to MLLW, and a datum the station lacks is `datum_unavailable` naming ones it carries
132
+ - CO-OPS verifies `hourly`, `high_low`, `daily_mean`, and monthly means once a month, for the prior month: an empty window ending on or after the first of the prior month is `verified_data_lag`, an earlier one `no_data`
133
+ - CO-OPS answers a burst of requests with HTTP 403 for about two minutes; the CO-OPS data tools report it as a retryable `upstream_throttled` whose recovery names the wait
169
134
 
170
135
  Agent-friendly output:
171
136
 
172
- - Datum echoed on every tide/water-level response so agents state units and reference correctly without assumptions
173
- - `total_found` on `find_stations` shows the count before the `limit` slice, so agents know whether to re-query
174
- - All NDBC sensor fields explicitly nullable — agents don't fabricate missing readings
175
- - Typed station `source` (`coops` | `ndbc`) plus a data-capability `type` and (NDBC only) a `platform` class — agents branch on data, not string parsing
137
+ - Byte-bounded paging on the four CO-OPS series tools: a range that fits returns whole, and a longer one returns a leading page with `rows_matched`, `rows_returned`, `page_offset`, and `next_offset`, walked with `offset` (`limit` shrinks a page)
138
+ - Missing means `null` or omitted, never fabricated: NDBC `MM` markers become `null`, blank CO-OPS values are dropped, and `quality` is left out rather than defaulted
139
+ - Discriminated fields: station `source` (`coops` | `ndbc`), capability `type`, NDBC `platform`, and `prediction_class`, with datum and units echoed on every CO-OPS height response, so callers branch on data, not string parsing
176
140
 
177
141
  ## Getting started
178
142
 
179
- No API key required. Both NOAA CO-OPS and NDBC are open, keyless data sources.
180
-
181
143
  ### Public Hosted Instance
182
144
 
183
- Connect directly via Streamable HTTP — no install, no API key:
145
+ A public instance is available at `https://noaa-marine.caseyjhand.com/mcp`, with no installation or API key. It serves Streamable HTTP; each client takes its own config shape.
146
+
147
+ For Claude Code:
148
+
149
+ ```sh
150
+ claude mcp add --transport http noaa-marine-mcp-server https://noaa-marine.caseyjhand.com/mcp
151
+ ```
152
+
153
+ For Cline (`cline_mcp_settings.json`):
184
154
 
185
155
  ```json
186
156
  {
187
157
  "mcpServers": {
188
- "noaa-marine": {
189
- "type": "streamable-http",
158
+ "noaa-marine-mcp-server": {
159
+ "type": "streamableHttp",
190
160
  "url": "https://noaa-marine.caseyjhand.com/mcp"
191
161
  }
192
162
  }
193
163
  }
194
164
  ```
195
165
 
166
+ For Cursor (`mcp.json`):
167
+
168
+ ```json
169
+ {
170
+ "mcpServers": {
171
+ "noaa-marine-mcp-server": {
172
+ "url": "https://noaa-marine.caseyjhand.com/mcp"
173
+ }
174
+ }
175
+ }
176
+ ```
177
+
178
+ Claude Desktop adds remote servers under Settings → Connectors.
179
+
196
180
  ### Self-Hosted / Local
197
181
 
198
182
  Add the following to your MCP client configuration file:
@@ -200,7 +184,7 @@ Add the following to your MCP client configuration file:
200
184
  ```json
201
185
  {
202
186
  "mcpServers": {
203
- "noaa-marine": {
187
+ "noaa-marine-mcp-server": {
204
188
  "type": "stdio",
205
189
  "command": "bunx",
206
190
  "args": ["@cyanheads/noaa-marine-mcp-server@latest"],
@@ -218,7 +202,7 @@ Or with npx (no Bun required):
218
202
  ```json
219
203
  {
220
204
  "mcpServers": {
221
- "noaa-marine": {
205
+ "noaa-marine-mcp-server": {
222
206
  "type": "stdio",
223
207
  "command": "npx",
224
208
  "args": ["-y", "@cyanheads/noaa-marine-mcp-server@latest"],
@@ -236,7 +220,7 @@ Or with Docker:
236
220
  ```json
237
221
  {
238
222
  "mcpServers": {
239
- "noaa-marine": {
223
+ "noaa-marine-mcp-server": {
240
224
  "type": "stdio",
241
225
  "command": "docker",
242
226
  "args": [
@@ -259,7 +243,7 @@ MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 bun run start:http
259
243
  ### Prerequisites
260
244
 
261
245
  - [Bun v1.4.0](https://bun.sh/) or higher (or Node.js v24+).
262
- - No external API keys needed — NOAA CO-OPS and NDBC are fully open.
246
+ - No API key: NOAA CO-OPS and NDBC are open data sources.
263
247
 
264
248
  ### Installation
265
249
 
@@ -294,12 +278,16 @@ cp .env.example .env
294
278
  |:---------|:------------|:--------|
295
279
  | `NOAA_APPLICATION_ID` | Courtesy identifier sent as `application=` on CO-OPS requests. | `noaa-marine-mcp-server` |
296
280
  | `MCP_TRANSPORT_TYPE` | Transport: `stdio` or `http`. | `stdio` |
297
- | `MCP_HTTP_PORT` | Port for HTTP server. | `3010` |
298
- | `MCP_AUTH_MODE` | Auth mode: `none`, `jwt`, or `oauth`. | `none` |
299
- | `MCP_SESSION_MODE` | HTTP session mode: `auto`, `stateful`, or `stateless`. The server declares `stateless` in `src/index.ts`; set this to override. | `stateless` |
300
- | `MCP_LOG_LEVEL` | Log level (RFC 5424). | `info` |
281
+ | `MCP_HTTP_PORT` | HTTP server port. | `3010` |
282
+ | `MCP_HTTP_HOST` | HTTP bind address. | `127.0.0.1` |
283
+ | `MCP_SESSION_MODE` | HTTP session mode: `stateless`, `stateful`, or `auto`. | `stateless` |
284
+ | `MCP_AUTH_MODE` | Authentication: `none`, `jwt`, or `oauth`. | `none` |
285
+ | `MCP_LOG_LEVEL` | Log level (`debug`, `info`, `warning`, `error`, etc.). | `info` |
301
286
  | `LOGS_DIR` | Directory for log files (Node.js only). | `<project-root>/logs` |
302
- | `OTEL_ENABLED` | Enable [OpenTelemetry instrumentation](https://github.com/cyanheads/mcp-ts-core/tree/main/docs/telemetry). | `false` |
287
+ | `LOG_TOOL_FAILURE_PAYLOADS` | Log each failed tool call's arguments and result (redacted by key name only), capped by `LOG_TOOL_FAILURE_PAYLOAD_MAX_BYTES`. | `false` |
288
+ | `OTEL_ENABLED` | Enable [OpenTelemetry](https://github.com/cyanheads/mcp-ts-core/tree/main/docs/telemetry). | `false` |
289
+ | `OTEL_EXPORTER_OTLP_ENDPOINT` | OTLP base URL; traces and metrics export to `/v1/traces` and `/v1/metrics` under it. | — |
290
+ | `OTEL_EXPORTER_OTLP_LOGS_ENDPOINT` | Opt-in OTLP log export endpoint; the base URL never enables it. | — |
303
291
 
304
292
  See [`.env.example`](./.env.example) for the full list of optional overrides.
305
293
 
@@ -338,12 +326,13 @@ The Dockerfile defaults to HTTP transport, stateless session mode, and logs to `
338
326
 
339
327
  | Path | Purpose |
340
328
  |:-----|:--------|
341
- | `src/index.ts` | `createApp()` entry point — registers tools, resource, and initializes services. |
329
+ | `src/index.ts` | `createApp()` entry point: registers the tools and resource, initializes services. |
342
330
  | `src/config/` | `NOAA_APPLICATION_ID` env var parsing with Zod. |
343
- | `src/services/coops/` | CO-OPS Tides & Currents API client: station list cache, data fetch, error detection. |
344
- | `src/services/ndbc/` | NDBC buoy service: active stations XML parser, realtime text parser. |
345
- | `src/mcp-server/tools/` | Eight tool definitions (`*.tool.ts`). |
346
- | `src/mcp-server/resources/` | Station metadata resource (`noaa-marine-station.resource.ts`). |
331
+ | `src/services/coops/` | CO-OPS client: station catalog cache, data fetch, error classification, date-range validation, row paging, state resolution. |
332
+ | `src/services/ndbc/` | NDBC service: active-stations XML and `realtime2` feed parsers. |
333
+ | `src/services/geo.ts` | Haversine distance for proximity search and state resolution. |
334
+ | `src/mcp-server/tools/definitions/` | Eight tool definitions (`*.tool.ts`). |
335
+ | `src/mcp-server/resources/definitions/` | Station metadata resource (`noaa-marine-station.resource.ts`). |
347
336
  | `tests/` | Vitest tests mirroring `src/`. |
348
337
  | `docs/` | Design doc and directory tree. |
349
338
 
@@ -0,0 +1,31 @@
1
+ ---
2
+ summary: "Framework 0.13.14: error results carry a request ID, wrong-typed arguments such as numeric strings are repaired instead of rejected, and the Docker image installs dependencies on the build platform."
3
+ breaking: false
4
+ security: false
5
+ ---
6
+
7
+ # 0.6.1 — 2026-10-08
8
+
9
+ ## Changed
10
+
11
+ - **Error results carry a request ID.** Every tool error result has `data.requestId` and its `content[]` text closes with `(reason … · request <id>)`; resource errors carry `data.requestId` too (mcp-ts-core 0.13.10). Declared `recovery` hints are now filled by the framework rather than forwarded by each handler; the hint text callers receive is unchanged.
12
+ - **Arguments are repaired before validation.** An integer sent for a string field (`station_id: 46087`) is accepted since mcp-ts-core 0.13.9; a numeric string for a number (`limit: "3"`) and a lone string for an array (`types: "tide"`) since 0.13.14. A boolean sent for a string field is still rejected with `-32602` `invalid_arguments`.
13
+ - **`ctx.log` notifications mirrored to the client** honor `MCP_LOG_LEVEL` and mask sensitive fields (mcp-ts-core 0.13.11).
14
+ - **`invalid_date_range` description reworded** in `noaa_marine_get_tide_predictions`, `noaa_marine_get_water_level`, `noaa_marine_get_monthly_means`, and `noaa_marine_get_currents`; it appears in the advertised error-reason description. Prose only; no input or output constraint changed.
15
+ - **`server.json`** — the npm package entries drop the `run start:*` arguments and set `runtimeHint` to `npx`; the streamable-http entry sets `MCP_TRANSPORT_TYPE` to `http`.
16
+ - **Docker image** — dependencies install in a `deps` stage on the build platform with a per-target cross-install (mcp-ts-core 0.13.10), musl-only native packages are pruned from the image (mcp-ts-core 0.13.11), and the base images move from Bun 1.4.0 to 1.4.2. `MCP_FORCE_CONSOLE_LOGGING` is no longer set in the image.
17
+ - **Packaging** — the `.mcpb` bundle excludes `/.cache/`, `/coverage/`, and `/tests/`; the npm `files` list excludes `dist/*.mcpb`.
18
+ - **Repo config** — `.gitignore` ignores every `.env*` variant except `.env.example`, `.env.template`, and `.env.sample`, and `.dockerignore` excludes `.env*` and the MCP Registry token files from the build context; the CodeQL workflow runs per language and uploads under `/language:<language>`.
19
+ - **Telemetry documentation** — `.env.example` and the README document the settings: with `OTEL_ENABLED=true`, `OTEL_EXPORTER_OTLP_ENDPOINT` alone exports traces and metrics to `<base>/v1/traces` and `<base>/v1/metrics`, and no endpoint exports nothing (mcp-ts-core 0.13.7); OTLP log export via `OTEL_EXPORTER_OTLP_LOGS_ENDPOINT` and failed-call payload logging via `LOG_TOOL_FAILURE_PAYLOADS` are opt-in (mcp-ts-core 0.13.8). The README tool and capability reference is condensed to match the current tool surface, and `MCP_HTTP_HOST` is listed with its `127.0.0.1` default.
20
+
21
+ ## Dependencies
22
+
23
+ - `@cyanheads/mcp-ts-core` ^0.13.6 → ^0.13.14
24
+ - `pino-pretty` ^13.1.3 → ^13.2.0
25
+ - dev: `@biomejs/biome` ^2.5.14 → ^2.5.15
26
+ - dev: `@socketsecurity/bun-security-scanner` ^1.1.2 → ^1.1.3
27
+ - dev: `@types/node` ^26.6.2 → ^26.6.4
28
+ - dev: `ignore` ^7.0.9 → ^7.0.12
29
+ - dev: `tsc-alias` ^1.9.5 → ^1.9.7
30
+ - dev: `vitest` ^5.0.1 → ^5.0.3
31
+ - `packageManager` bun@1.4.0 → bun@1.4.2
@@ -0,0 +1,27 @@
1
+ ---
2
+ summary: "Marine tool responses preserve literal station names, metadata, queries, and notices in Markdown, with framework 0.13.16 and refreshed dependencies."
3
+ breaking: false
4
+ security: false
5
+ ---
6
+
7
+ # 0.6.2 — 2026-10-25
8
+
9
+ ## Changed
10
+
11
+ - **Framework error and enrichment text** now escapes Markdown syntax in `content[]`, preserving literal messages, recovery hints, and trailer values.
12
+ - **Maintenance tooling and guidance** refresh audit attribution, bundle exclusions, configuration references, and hosted-client connection examples.
13
+
14
+ ## Fixed
15
+
16
+ - **Marine tool Markdown** preserves literal upstream station names and metadata across all eight tools, including caller queries and discovery/current notices.
17
+
18
+ ## Dependencies
19
+
20
+ - `@cyanheads/mcp-ts-core` ^0.13.14 → ^0.13.16.
21
+ - `zod` ^4.6.5 → ^4.6.7 (GHSA-mrhx-c7xc-m3w5).
22
+ - `@biomejs/biome` ^2.5.15 → ^2.6.3.
23
+ - `@types/node` ^26.6.4 → ^26.6.5.
24
+ - `ignore` ^7.0.12 → ^7.0.14.
25
+ - `tsc-alias` ^1.9.7 → ^1.9.9.
26
+ - `vitest` ^5.0.3 → ^5.0.5.
27
+ - **Bun** 1.4.2 → 1.4.4 (`packageManager` and Docker images).
@@ -162,12 +162,12 @@ export const noaaMarineStationResource = resource('noaa-marine://station/{statio
162
162
  hint: 'CO-OPS is temporarily refusing requests from this server after a burst of calls. Wait a couple of minutes before reading the station again, and space successive calls rather than sending them back to back.',
163
163
  },
164
164
  }
165
- : ctx.recoveryFor('source_unavailable')),
165
+ : {}),
166
166
  station_id: params.station_id,
167
167
  unread_sources: unread,
168
168
  });
169
169
  }
170
- throw ctx.fail('station_not_found', `Station ${params.station_id} not found in CO-OPS or NDBC. Use noaa_marine_find_stations to discover valid IDs.`, { ...ctx.recoveryFor('station_not_found'), station_id: params.station_id });
170
+ throw ctx.fail('station_not_found', `Station ${params.station_id} not found in CO-OPS or NDBC. Use noaa_marine_find_stations to discover valid IDs.`, { station_id: params.station_id });
171
171
  },
172
172
  });
173
173
  //# sourceMappingURL=noaa-marine-station.resource.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"noaa-marine-station.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/noaa-marine-station.resource.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"noaa-marine-station.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/noaa-marine-station.resource.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"noaa-marine-find-stations.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/noaa-marine-find-stations.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAiLjE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAikBjC,CAAC"}
1
+ {"version":3,"file":"noaa-marine-find-stations.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/noaa-marine-find-stations.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAkLjE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqkBjC,CAAC"}
@@ -4,6 +4,7 @@
4
4
  */
5
5
  import { tool, z } from '@cyanheads/mcp-ts-core';
6
6
  import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
7
+ import { escapeMarkdownInline } from '@cyanheads/mcp-ts-core/utils';
7
8
  import { getCoopsService, isCoopsThrottled } from '../../../services/coops/coops-service.js';
8
9
  import { currentPredictionClass, tidePredictionClass } from '../../../services/coops/prediction-class.js';
9
10
  import { STATE_CODES } from '../../../services/coops/station-state.js';
@@ -262,6 +263,7 @@ export const noaaMarineFindStations = tool('noaa_marine_find_stations', {
262
263
  sources: SourceReportSchema.optional().describe('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.'),
263
264
  },
264
265
  enrichmentTrailer: {
266
+ notice: { render: (value) => `> ${escapeMarkdownInline(value)}` },
265
267
  applied_search: {
266
268
  render: (v) => {
267
269
  const parts = [
@@ -273,7 +275,7 @@ export const noaaMarineFindStations = tool('noaa_marine_find_stations', {
273
275
  if (v.types)
274
276
  parts.push(`types=[${v.types.join(', ')}]`);
275
277
  if (v.query)
276
- parts.push(`query="${v.query}"`);
278
+ parts.push(`query="${escapeMarkdownInline(v.query)}"`);
277
279
  if (v.center && v.radius_km !== undefined) {
278
280
  parts.push(`within ${v.radius_km} km of ${v.center.latitude}, ${v.center.longitude}`);
279
281
  }
@@ -307,7 +309,7 @@ export const noaaMarineFindStations = tool('noaa_marine_find_stations', {
307
309
  const { latitude: lat, longitude: lon } = input;
308
310
  if ((lat === undefined) !== (lon === undefined)) {
309
311
  const missing = lat === undefined ? 'latitude' : 'longitude';
310
- throw ctx.fail('incomplete_coordinates', `Proximity search needs both latitude and longitude — ${missing} is missing.`, { ...ctx.recoveryFor('incomplete_coordinates') });
312
+ throw ctx.fail('incomplete_coordinates', `Proximity search needs both latitude and longitude — ${missing} is missing.`);
311
313
  }
312
314
  const center = lat !== undefined && lon !== undefined ? { lat, lon } : undefined;
313
315
  // Blank/whitespace-only queries carry no search intent — treat them as omitted
@@ -382,7 +384,7 @@ export const noaaMarineFindStations = tool('noaa_marine_find_stations', {
382
384
  hint: 'CO-OPS is temporarily refusing requests from this server after a burst of calls. Wait a couple of minutes before searching again, and space successive calls rather than sending them back to back.',
383
385
  },
384
386
  }
385
- : ctx.recoveryFor('sources_unavailable')),
387
+ : {}),
386
388
  failed_sources: failed,
387
389
  });
388
390
  }
@@ -596,20 +598,24 @@ export const noaaMarineFindStations = tool('noaa_marine_find_stations', {
596
598
  ? ` · ${s.state}${s.state_derived ? ' (derived from the nearest state-bearing station)' : ''}`
597
599
  : '';
598
600
  const typeStr = s.type ? ` · **Type:** ${s.type}` : '';
599
- const platformStr = s.platform ? ` · **Platform:** ${s.platform}` : '';
600
- const classStr = s.prediction_class ? ` · **Prediction class:** ${s.prediction_class}` : '';
601
- lines.push(`### ${s.name} (${s.station_id})`, `**Source:** ${s.source.toUpperCase()}${typeStr}${platformStr}${classStr}${dist}${state}`, `**Coordinates:** ${s.latitude}, ${s.longitude}`, `**Capabilities:** ${s.capabilities.length > 0 ? s.capabilities.join(', ') : 'none reported'}`);
601
+ const platformStr = s.platform ? ` · **Platform:** ${escapeMarkdownInline(s.platform)}` : '';
602
+ const classStr = s.prediction_class
603
+ ? ` · **Prediction class:** ${escapeMarkdownInline(s.prediction_class)}`
604
+ : '';
605
+ lines.push(`### ${escapeMarkdownInline(s.name)} (${escapeMarkdownInline(s.station_id)})`, `**Source:** ${s.source.toUpperCase()}${typeStr}${platformStr}${classStr}${dist}${state}`, `**Coordinates:** ${s.latitude}, ${s.longitude}`, `**Capabilities:** ${s.capabilities.length > 0 ? s.capabilities.join(', ') : 'none reported'}`);
602
606
  if (s.bins && s.bins.length > 0) {
603
607
  const bins = s.bins.map((b) => {
604
608
  const depth = b.depth !== null ? `${b.depth} ft` : 'depth not published';
605
- const depthType = b.depth_type ? `, ${b.depth_type}` : '';
606
- const binClass = b.prediction_class ? `, ${b.prediction_class}` : '';
609
+ const depthType = b.depth_type ? `, ${escapeMarkdownInline(b.depth_type)}` : '';
610
+ const binClass = b.prediction_class
611
+ ? `, ${escapeMarkdownInline(b.prediction_class)}`
612
+ : '';
607
613
  return `${b.bin} (${depth}${depthType}${binClass})`;
608
614
  });
609
615
  lines.push(`**Current bins:** ${bins.join(' · ')}`);
610
616
  }
611
617
  if (s.reference_id) {
612
- lines.push(`**Reference station:** ${s.reference_id}`);
618
+ lines.push(`**Reference station:** ${escapeMarkdownInline(s.reference_id)}`);
613
619
  }
614
620
  lines.push('');
615
621
  }