World Monitor
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
NOAA tides and currents: water levels, tide predictions, currents, met data, flooding, sun and moon
列表按使用分(满分 100)排序,由以下部分组成
| 热度 | 10/80 | GitHub 星标或每周下载量:较大的计 60,较小的计 20 |
|---|---|---|
| 新鲜度 | 7/12 | 30 天内有发布或代码更新得满分 |
| 仍在响应 | 8/8 | 上次检查时云端端点有响应 |
| 使用分 | 25/100 |
质量: 基础检查通过 5/5 项(仅展示,不用于排序) · 上升势头: 暂无数据 (只用于“上升中”标签)
选择你使用的 AI 应用,然后复制设置。
用一句话让 AI 帮你安装
请帮我安装 NOAA Tides and Currents。按照 https://mcp.popnx.com/i/ryancardin15-noaa-tides-and-currents-mcp.md 操作,先把命令给我看,等我同意后再运行。粘贴到能在你电脑上工作的 AI(如 Claude Code、Cursor)。它会读取我们的步骤,先给你看命令,等你同意。无需密钥,无需注册。 · 查看 AI 会读取的全文
通过 5/5 项检查 · 你的提问会经过开发者的服务器(perigeetides.com) · ✓ 命令已检查 2026年11月13日
第一步:你用哪个 AI?
选择你用的应用,步骤会显示在下方。
可连接 Claude · 约 2 分钟
不需要密钥,不用安装程序 · 在 claude.ai 或桌面应用设置一次,即可在聊天中使用 · 免费账户可添加 1 个 · Team/Enterprise 方案由所有者(Owner)添加
CustomizeConnectors
把这里的内容复制到 Claude 中同名的输入框,然后点击 Continue
NOAA Tides and Currentshttps://perigeetides.com/mcp在 Claude 检测到的登录设置页点击 Continue · Authentication 按作者说明选择(Sign in now、Sign in when needed 或 No sign in),然后点击 Add
+ConnectorsNOAA Tides and Currents
用 NOAA Tides and Currents 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude 说正在使用 NOAA Tides and Currents,或回答中出现 NOAA Tides and Currents 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
能否连接 ChatGPT 取决于方案
完整 MCP:网页版 ChatGPT Business、Enterprise 或 Edu · Pro:以读取/获取权限连接,修改数据的工具可能用不了 · Plus:官方文档尚未确认,如果在插件页看到添加自定义 MCP 的选项可以试试 · 仅限网页
Plugins+Add custom MCP server
输入名称,在 Connection 下粘贴地址,勾选风险提示,然后点击 Create as a plugin
NOAA Tides and Currentshttps://perigeetides.com/mcp开启新聊天,输入前先从插件列表中选择 NOAA Tides and Currents
用 NOAA Tides and Currents 告诉我你能帮我做什么,然后做一件给我看✓ 如果 ChatGPT 说正在使用 NOAA Tides and Currents,或回答中出现 NOAA Tides and Currents 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 OpenAI 帮助页面核实 · 你的界面可能因版本略有不同
可连接 Claude Code · 约 2 分钟
不需要密钥,不用安装程序
Mac:按 Command+空格,输入 Terminal · Windows:打开 PowerShell
claude mcp add --transport http --scope user noaa-tides-and-currents https://perigeetides.com/mcp应能看到 NOAA Tides and Currents 在列表中并显示已连接
用 NOAA Tides and Currents 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude Code 说正在使用 NOAA Tides and Currents,或回答中出现 NOAA Tides and Currents 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
可连接 Cursor · 约 2 分钟
不需要密钥,不用安装程序
用 NOAA Tides and Currents 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Cursor 说正在使用 NOAA Tides and Currents,或回答中出现 NOAA Tides and Currents 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同
可连接 VS Code · 约 2 分钟
不需要密钥,不用安装程序
用 NOAA Tides and Currents 告诉我你能帮我做什么,然后做一件给我看✓ 如果 VS Code 说正在使用 NOAA Tides and Currents,或回答中出现 NOAA Tides and Currents 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同
其他支持 MCP 的应用(如 Windsurf、Zed、Gemini CLI)添加方式各不相同,请在应用列表中查看
通过网页连接的应用使用的地址
https://perigeetides.com/mcpJSON 设置在下方“开发者专用”中
Claude Code
claude mcp add --transport http --scope user noaa-tides-and-currents https://perigeetides.com/mcpCursor (~/.cursor/mcp.json)
{
"mcpServers": {
"noaa-tides-and-currents": {
"url": "https://perigeetides.com/mcp"
}
}
}VS Code (mcp.json)
{
"servers": {
"noaa-tides-and-currents": {
"type": "http",
"url": "https://perigeetides.com/mcp"
}
}
}Claude Code
claude mcp add --scope user noaa-tides-and-currents -- npx -y @ryancardin/noaa-tides-currents-mcp-serverClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"noaa-tides-and-currents": {
"command": "npx",
"args": [
"-y",
"@ryancardin/noaa-tides-currents-mcp-server"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"noaa-tides-and-currents": {
"command": "npx",
"args": [
"-y",
"@ryancardin/noaa-tides-currents-mcp-server"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"noaa-tides-and-currents": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ryancardin/noaa-tides-currents-mcp-server"
]
}
}
}这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。
通过互联网连接,适用于
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
在你的电脑上运行,适用于
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
工具名称和描述与服务器在 2026年11月19日 报告的完全一致。这些内容由作者撰写,不是我们写的;我们以纯文本形式显示。
perigee_get_tidesGet high and low tide times and heights for a coastal place, for one day or up to a week, with the current water level and whether the tide is rising or falling. Use for "when is high tide in …", "low tide this weekend at …", "tide chart for …", "is the tide coming in?", and king
perigee_get_conditionsGet what the water is doing right now at a coastal place: the tide's current height and direction, observed wind, water and air temperature, the next 12 hours of wind, active National Weather Service marine and coastal alerts, and daylight. Use for "what are conditions at …", "is
perigee_get_sun_moonGet sunrise, sunset, first and last light, golden hour, moonrise, moonset and moon phase for any place on Earth, for one day or up to two weeks, plus the next new, quarter and full moons. Use for "what time is sunset in …", "when is golden hour", "moon phase tonight", "next full
perigee_find_best_timeRank the best time windows over the next 1–7 days for a coastal activity — tidepooling, beachcombing, clamming, fishing, paddling (kayak, SUP), boating, photography, or a beach walk — from predicted tides, daylight, and forecast wind, with the reasons for each window. Use for "be
perigee_find_stationsList NOAA tide stations by place or station name, by state, or nearest to a latitude and longitude. Use when a place is ambiguous, when someone asks which tide stations are near somewhere, or to compare candidate stations before choosing one. The other Perigee tools resolve place
noaa_get_water_levelsGet observed water levels from a NOAA tide station as a time series. Choose the interval: "6" = standard 6-minute observations (preliminary or verified, max 31 days per request), "1" = 1-minute preliminary data (max 4 days), "hourly" = verified hourly heights (max 1 year). Height
noaa_get_water_level_summariesGet verified summary water-level products from a NOAA station: - high_low: each day's observed highs/lows with ty = HH (higher high), H, L, LL (lower low). Max 1 year per request. - daily_mean: daily mean levels — GREAT LAKES STATIONS ONLY; NOAA requires local standard time, whic
noaa_get_tide_predictionsGet NOAA harmonic tide predictions (future or past) for a station. interval="hilo" (recommended for "when is high/low tide") returns the daily tide events with type H/L — up to 10 years per request. Other intervals (h, 1, 5, 6, 10, 15, 30, 60 minutes) return a height time series
noaa_get_currentsGet observed current speed and direction from a NOAA current meter station. Current stations use alphanumeric IDs (e.g. "cb0102" Chesapeake, "bh0101" Boston Harbor) — NOT the 7-digit water-level station IDs. Find them with noaa_search_stations (type "currents") or noaa_find_neare
noaa_get_current_predictionsGet predicted tidal currents for a NOAA current prediction station. interval="max_slack" (recommended for navigation) returns the tidal-current events — maximum flood, maximum ebb, and slack water times — up to 1 year per request. Other intervals (h, 1, 6, 10, 30, 60 minutes) ret
noaa_get_meteorological_dataGet observed meteorological/oceanographic sensor data from a NOAA station. Products: air_temperature, water_temperature, wind (speed/gust/direction), air_pressure, air_gap (bridge clearance to water surface), conductivity, visibility, humidity, salinity. Units by system: temps °F
noaa_search_stationsSearch the NOAA CO-OPS station directory by capability type, name, and/or state. Filter with: - type: what the station does (waterlevels, tidepredictions, currents, currentpredictions, met, ...) — pick the type matching the data you plan to request. - name: case-insensitive subst
noaa_find_nearest_stationsFind the NOAA stations closest to a latitude/longitude point, sorted by distance. Use this to answer "what's the tide station near ?" — geocode the place to coordinates first, then call this. Filter by type to match the data you need (e.g. type "tidepredictions" before calling no
noaa_get_station_infoGet a NOAA station's full metadata record: location, state, time zone, tide type, Great Lakes flag, capability flags, and links to available sub-resources. Optionally expand sub-resources inline via the "expand" list: - details (established/removed dates), sensors (installed inst
noaa_get_station_datumsGet the accepted tidal datum values for a station: the elevations of MHHW, MHW, MTL, MSL, DTL, MLW, MLLW, STND, NAVD88 (where computed), plus GT (great diurnal range), MN (mean range), LAT/HAT (lowest/highest astronomical tide), and the station's historical extreme min/max water
noaa_get_harmonic_constituentsGet the harmonic constituents NOAA uses to compute tide or current predictions at a station — the amplitude, phase, and angular speed of each tidal constituent (M2, S2, N2, K1, O1, ...). For water-level stations: amplitude (feet/meters), phase_GMT and phase_local (degrees), speed
noaa_get_prediction_offsetsGet the offsets a subordinate (type "S") prediction station applies to its reference station's predictions. kind "tide": returns refStationId, time offsets for high/low tide (minutes), height offsets for high/low tide, and whether the height adjustment is a ratio (multiplied) or
noaa_get_sea_level_trendsGet the long-term relative sea level trend at a NOAA station: trend and error (reported by NOAA in mm/yr or inches/decade — the payload's trendUnits field says which), the observation period (startDate/endDate), and seasonal amplitude. Relative sea level combines ocean rise AND l
noaa_get_sea_level_rise_projectionsGet NOAA's Interagency Sea Level Rise Scenario projections for a station (from the 2022 technical report): projected relative sea level (meters or feet, see units field) per decade through 2150 under the chosen scenario. Scenarios: low, intermediate-low, intermediate, intermediat
noaa_get_extreme_water_levelsGet NOAA's extreme water level exceedance statistics for a station: the annual exceedance probability levels (e.g. the 1%-annual-chance "100-year" level) and historical extreme events, computed from the station's verified record. Use for flood risk questions ("what water level ha
noaa_get_top_ten_water_levelsGet a station's highest recorded water levels: analysis "toptenwaterlevels" returns the ten highest events on record (with date, height, causal event name like "Great New England Hurricane", and category); "peakwaterlevels" returns peak event records (optionally filtered by year)
noaa_get_high_tide_floodingGet NOAA high tide flooding (HTF, "nuisance"/"sunny day" flooding) statistics for a station. Reports: - daily: flood occurrence per day (REQUIRES start_date and end_date, YYYYMMDD) - monthly / seasonal / annual: counts of minor/moderate/major flood days per period (filter with ye
astro_get_moon_phaseGet the moon phase for a date (or each day of a date range if end_date is given): phase name (New Moon, Waxing Crescent, ...), illuminated fraction, age in days within the 29.53-day cycle, distance (km), apparent diameter (degrees), and waxing/waning. Tide context: spring tides (
astro_get_next_moon_phaseFind the date(s) of the next occurrence(s) of a principal moon phase (New Moon, First Quarter, Full Moon, Last Quarter) from a starting date. Use for: "when is the next full moon?", planning around spring tides (which follow new/full moons by 1–2 days).
astro_get_sun_timesGet sunrise, sunset, solar noon, dawn/dusk (civil), nautical dawn/dusk, astronomical dawn/dusk, golden hour, and day length for a location and date (or each day of a range if end_date is given). Times are ISO UTC unless an IANA timezone is provided. At high latitudes some events
astro_get_sun_positionGet the sun's position for a date, time, and location: azimuth (degrees clockwise from north as rendered here), altitude above the horizon (degrees), plus approximate declination and right ascension. Use for: shadow/lighting analysis, solar exposure. Computed locally with suncalc
astro_get_next_sun_eventFind the next occurrence(s) of a sun event (sunrise, sunset, dawn, dusk, solarNoon, night, nightEnd, goldenHourStart, goldenHourEnd, nauticalDawn, nauticalDusk, astronomicalDawn, astronomicalDusk) at a location from a starting date. Use for: "when is sunset today?", planning gold
nws_get_wind_forecastGet the NWS hourly wind FORECAST (speed, gust, direction — plus wave height where the grid carries it) for a latitude/longitude. Data comes from the NWS forecast grid (api.weather.gov gridpoints — numeric NDFD values, not display strings). Horizon is up to ~7 days (156 hours), st
nws_get_marine_forecastGet the official NWS Coastal Waters Forecast (CWF) narrative for the marine zone covering a latitude/longitude — day-part wind/seas text ("SE winds 10 to 15 kt... Bay waters choppy"), including Small Craft Advisories. The point must lie in (or very near) US coastal waters; CWF zo
noaa_get_reference_guideGet curated reference documentation for NOAA CO-OPS concepts and parameters. Topics: - products: Every NOAA CO-OPS data product and which tool serves it - datums: Vertical datums (MLLW, MSL, IGLD...) and station applicability - units: What english vs metric means per measurement
perigee_whoamiShow how this MCP connection is authenticated: the Perigee account it is linked to (if any), how it signed in (OAuth connector or API key), its rate-limit tier, and the requests-per-minute limit. Use when the user asks which account they're connected as, why they're rate limited,
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月20日
注册名称已通过 GitHub 账户 RyanCardin15 验证,该账户拥有此仓库
代码最后更新于2个月前
使用 MIT
在 524 毫秒内响应(HTTP 200)
无需登录
已读取 31 个工具描述,未发现针对 AI 的隐藏指令
云端地址最近 5 次检查中有 5 次响应 · 最近一次 524 ms · 检查于 2026年11月19日
OSV.dev 中没有 @ryancardin/noaa-tides-currents-mcp-server@2.1.0 的记录
只检查这个版本的包本身,不包括所有依赖 · 检查于 2026年11月15日
如果你是作者,可把这段代码贴到 README。徽章会链接回本页。
[](https://mcp.popnx.com/en/servers/ryancardin15-noaa-tides-and-currents-mcp)提问、分享技巧或报告无法使用。按“有帮助”数量排序。
还没有评价
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
它在 5 项适用的基础检查中通过了 5 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。
两种方式都可以:安装在你的电脑上,或者连接云端版本。
GitHub 仓库最后更新于2个月前,最新版本(2.1.0)于2个月前进入注册中心。
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,因此也能用于接受远程 MCP 的应用,例如网页版 ChatGPT(Business 及以上为完整 MCP;Pro 为只读)。
同一分类中有:World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu
同一分类、其他作者、命令已通过检查。官方的排在前面,再按星标排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Manage monitors, status pages, incidents and maintenances in your openstatus workspace.
Validate oh-my-posh configurations and segment snippets against the official schema.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.
| 本项 NOAA Tides and Currents | World Monitor | openstatus | Oh My Posh Validator | Strata | Jitsu | |
|---|---|---|---|---|---|---|
| 运行位置 | 云端或安装在电脑上都可以 | 在云端运行,无需安装 | 在云端运行,无需安装 | 在云端运行,无需安装 | 在云端运行,无需安装 | 在云端运行,无需安装 |
| 需要密钥 | 否 | 否 | 否 | 否 | 否 | 否 |
| 可在 Claude 中按 + 添加 | 否 | 否 | 否 | 否 | 否 | 否 |
| 基础检查 | 5/5 | 4/4 | 4/4 | 4/4 | 1/4 | 4/4 |
| 许可证 | MIT | AGPL-3.0 | AGPL-3.0 | MIT | Apache-2.0 | MIT |
| 价格 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 |
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
A Model Context Protocol server for NOAA CO-OPS Tides and Currents data
Built by Cardin Labs · Hosted at Perigee
Water levels · tide predictions · currents · marine weather · station metadata · tidal datums · harmonic constituents · sea level trends & projections · high tide flooding · sun & moon calculations
# Run immediately with npx
npx @ryancardin/noaa-tides-currents-mcp-server
npx noaa-mcp
{
"mcpServers": { "noaa": { "command": "npx", "args": ["-y", "@ryancardin/noaa-tides-currents-mcp-server"] } } }
Claude Code one-liner:
claude mcp add noaa -- npx -y @ryancardin/noaa-tides-currents-mcp-server
npx noaa-mcp --http --port 3000 # stateless streamable HTTP at http://localhost:3000/mcp
No API key is required — NOAA's CO-OPS APIs are open.
| Tool | What it does |
|---|---|
noaa_get_water_levels | Observed water levels: 1-minute, 6-minute, or hourly series, preliminary/verified quality flags decoded |
noaa_get_water_level_summaries | high_low (HH/H/L/LL daily extremes), daily_mean (Great Lakes), daily_max_min, monthly_mean datum tables |
noaa_get_tide_predictions | Harmonic tide predictions — hilo high/low events (up to 10 years) or interval series |
noaa_get_currents | Observed current speed/direction by depth bin (ADCP), optional beam diagnostics |
noaa_get_current_predictions | Predicted currents — max_slack flood/ebb/slack events or interval series |
noaa_get_meteorological_data | Wind, air/water temperature, pressure, air gap (bridge clearance), conductivity, visibility, humidity, salinity |
| Tool | What it does |
|---|---|
noaa_search_stations | Search the station directory by capability type, name substring, state — paginated |
noaa_find_nearest_stations | Nearest stations to any lat/lon (great-circle, cached directory), filterable by type |
noaa_get_station_info | Full station record with expandable sensors, flood levels, benchmarks, bins, deployments... |
noaa_get_station_datums | Tidal datum elevations (MLLW, MSL, MHHW, NAVD88...), HAT/LAT, historic extremes, current or superseded epoch |
noaa_get_harmonic_constituents | The M2/S2/K1/... constituents behind a station's predictions (water level or current ellipse form) |
noaa_get_prediction_offsets | Subordinate-station time/height offsets from their reference stations (tide or current) |
| Tool | What it does |
|---|---|
noaa_get_sea_level_trends | Long-term relative sea level trend with error bars and observation period |
noaa_get_sea_level_rise_projections | 2022 Interagency SLR scenario projections per decade through 2150 |
noaa_get_extreme_water_levels | Annual exceedance probability levels (e.g. the "100-year" water level) |
noaa_get_top_ten_water_levels | Highest water levels ever recorded, with causal events (hurricanes, nor'easters) |
noaa_get_high_tide_flooding | HTF flood-day counts (daily/monthly/seasonal/annual), outlooks, decadal projections, likelihoods |
| Tool | What it does |
|---|---|
astro_get_moon_phase | Phase, illumination, age, distance for a date or range (spring/neap tide context) |
astro_get_next_moon_phase | Next new/full/quarter moon date(s) |
astro_get_sun_times | Sunrise/sunset, twilights, golden hour, day length for any location/date |
astro_get_sun_position | Azimuth/altitude (+ approximate declination/RA) |
astro_get_next_sun_event | Next occurrence(s) of any sun event |
| Tool | What it does |
|---|---|
nws_get_wind_forecast | Hourly numeric wind forecast (speed/gust/direction, wave height where gridded) for any US lat/lon, up to ~7 days |
nws_get_marine_forecast | Official Coastal Waters Forecast narrative for the marine zone covering a lat/lon, incl. Small Craft Advisories |
| Tool | What it does |
|---|---|
noaa_get_reference_guide | Curated NOAA reference: products, datums, units, time zones, intervals, station types, data limits, quality flags, date formats, marine forecasts |
Every tool supports response_format: "markdown" (readable tables with units spelled out — the default) or "json" (complete structured payload), and attaches structured content for MCP clients that consume it.
noaa://guide/getting-started — workflow recipes and common pitfallsnoaa://reference/{topic} — the ten reference topics above as pinnable resourcestide_report — tide report for a place/station and dateboating_conditions — pre-departure briefing: tides, currents, wind, daylightstation_flood_risk — flood risk profile: HTF history, extremes, trends, projectionsstation_overview — everything a station offersThese are the things that make NOAA's API tricky — this server encodes them:
noaa_get_station_datums gives the conversion table.metric means m/s for wind but cm/s for currents; air pressure is millibars and salinity PSU in *both* systems. Every response labels its units.9414290); current stations are alphanumeric (cb0102).hilo predictions, derived by offsets from a reference (R) station."When is high tide in Boston tomorrow?"
noaa_find_nearest_stations (type tidepredictions) → 8443970 BOSTONnoaa_get_tide_predictions (interval hilo) → high/low times & heights above MLLW"How strong will the current be in the Cape Cod Canal this afternoon?"
noaa_find_nearest_stations (type currentpredictions)noaa_get_current_predictions (interval max_slack) → max flood/ebb (knots) and slack times"How often does Providence flood now vs 20 years ago, and what's projected for 2050?"
noaa_get_high_tide_flooding (report annual, range 25)noaa_get_high_tide_flooding (report projections, decade 2050)noaa_get_sea_level_trends + noaa_get_sea_level_rise_projectionsnpm install
npm run build # tsc → dist/ npm test # vitest unit tests (validation, formatting, astronomy) npm run test:live # end-to-end smoke test against the live NOAA API npm run inspector # MCP Inspector against dist/index.js npm run dev # tsx src/index.ts
src/
├── index.ts # entry point: stdio (default) or --http streamable HTTP ├── constants.ts # API base URLs, timeouts, cache TTLs, response limits ├── client/ # shared HTTP layer (retry/backoff, error mapping) + TTL cache ├── validation/ # date normalization + per-product span limit enforcement ├── format/ # unit labeling, flag legends, markdown/json response shaping ├── schemas/ # shared Zod field schemas with nuance-carrying descriptions ├── services/ # Data API, Metadata API, DPAPI, moon & sun services ├── tools/ # 25 tool registrations grouped by domain ├── resources/ # noaa:// reference resources ├── prompts/ # workflow prompt templates └── reference/ # curated NOAA reference content
Data sources:
api.tidesandcurrents.noaa.gov/api/prod/datagetterapi.tidesandcurrents.noaa.gov/mdapi/prod/webapiapi.tidesandcurrents.noaa.gov/dpapi/prod/webapiMIT © Cardin LLC (Cardin Labs)
NOAA data is provided by the NOAA Center for Operational Oceanographic Products and Services (CO-OPS). This project is not affiliated with or endorsed by NOAA.
Every raw tool advertises an output schema. Successful provider payloads retain their fields and add _response: { contractVersion: "2026-09-29.1", status: "complete" }. Reference guides have a separate typed topic/guide result. Both text and structured payloads are bounded: an oversized result returns an explicit response_too_large error with narrowing guidance instead of truncated text alongside an unbounded structured response. Error metadata states whether retry may help. Chained provider reads share a 45-second cancellation deadline and each request has an 18-second total retry budget. No fishing, navigation or catch probability is inferred from raw data.