From 7e10496e0ad1d15e32b913ed898c583bc5523b07 Mon Sep 17 00:00:00 2001 From: Ryan Malloy Date: Tue, 24 Feb 2026 11:16:25 -0700 Subject: [PATCH] Rewrite landing page: ELI5 intro, no AI buzzwords MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Lead with "One question away" — explains NOAA's station network, the API gap, and what mcnoaa-tides does, in plain language - Progressive disclosure: simple explanation → use cases → technical details → install - Remove all "AI" references across docs (tagline, getting-started) - Install section leads with generic MCP JSON config, not product-specific --- .../content/docs/getting-started/index.mdx | 2 +- docs/src/content/docs/index.mdx | 120 +++++++++++------- 2 files changed, 75 insertions(+), 47 deletions(-) diff --git a/docs/src/content/docs/getting-started/index.mdx b/docs/src/content/docs/getting-started/index.mdx index bcacb6b..279a99e 100644 --- a/docs/src/content/docs/getting-started/index.mdx +++ b/docs/src/content/docs/getting-started/index.mdx @@ -8,7 +8,7 @@ sidebar: import { Card, CardGrid } from '@astrojs/starlight/components'; **mcnoaa-tides** is an [MCP](https://modelcontextprotocol.io/) server that -connects AI assistants to the +connects your assistant to the [NOAA CO-OPS Tides and Currents API](https://tidesandcurrents.noaa.gov/api/). It exposes tide predictions, observed water levels, and meteorological observations from approximately 301 U.S. coastal stations — all through a diff --git a/docs/src/content/docs/index.mdx b/docs/src/content/docs/index.mdx index 7af975a..617c706 100644 --- a/docs/src/content/docs/index.mdx +++ b/docs/src/content/docs/index.mdx @@ -2,7 +2,7 @@ title: mcnoaa-tides template: splash hero: - tagline: Real-time NOAA tide and marine data for AI assistants + tagline: Tides, weather, and conditions from 300 U.S. coastal stations image: html: |
-## What's inside +## One question away - - - Station discovery, tide predictions, water levels, weather data, marine - condition snapshots, tidal phase classification, deployment intelligence, - chart visualization, and diagnostics. - - - Guided workflows for fishing trip planning, marine safety checks, - crab pot deployment assessment, and catch-to-tide correlation analysis. - - - Station catalog, station detail, and nearby station lookup — structured - context that any MCP client can read directly. - - - Tide charts and multi-panel conditions dashboards rendered as PNG images - or interactive HTML with Plotly. - - +NOAA — the National Oceanic and Atmospheric Administration — runs a network of +tide stations along every U.S. coast. About 300 of them, from Eastport, Maine +to Pago Pago, American Samoa. They measure water levels every six minutes. +Many also track wind speed, air pressure, and water temperature. All of it gets +published as free, public data. + +The catch? The raw API isn't exactly conversational. Station IDs, product +codes, datum references, time formats — it's built for machines, not people. + +**mcnoaa-tides sits in the middle.** It's a server that knows how to talk to +NOAA's API, and it lets your assistant handle the details. You ask +*"when's the best time to fish near Seattle?"* and behind the scenes, the +nearest station gets found, 48 hours of tide predictions get pulled, weather +conditions get checked, and you get a window you can actually plan around. + +No API keys. No data wrangling. Just ask.
-## What can you do with it? - -Ask your assistant a question. It calls the right tools and comes back with an answer grounded in real NOAA data. +## What does that look like? *"When's the best time to fish near Newport this weekend?"* Finds nearby stations, pulls tide turning points, checks wind and - barometric pressure, and identifies the optimal incoming-tide window. + barometric pressure, and identifies the best incoming-tide window. *"Is it safe to take the boat out from Seattle today?"* - Runs a marine safety check — wind speed, gust, visibility, water - temperature, and pressure trend — returns a GO / CAUTION / NO-GO. + Checks wind, gusts, visibility, water temperature, and pressure trend. + Comes back with GO, CAUTION, or NO-GO — and tells you why. *"When's the next good low tide for snorkeling at La Jolla?"* - Finds extreme low tides that expose reefs, checks water temperature - and wind to confirm conditions are worth the trip. + Finds extreme low tides that expose reefs, checks water temperature and + wind to confirm the trip is worth the drive. *"Find the lowest tide this week near Monterey for tide pooling"* - Scans 7 days of predictions for the deepest lows — negative values - mean water drops below the average low-water mark, exposing more pools. + Scans a full week of predictions for the deepest lows. Negative values + mean the water drops below the usual low-water mark — more pools exposed. *"Should I deploy pots near Anacortes right now?"* - Checks tidal phase, runs a deployment briefing with wind/temp/pressure - thresholds, and recommends an optimal soak window. + Checks tidal phase, runs a deployment briefing against wind and pressure + thresholds, and recommends a soak window with a recovery time. - - *"When will the tide be low enough to reach the tidepools at Cannon Beach?"* + + *"When's the next low tide at Cannon Beach? I want to look for agates."* - Finds the next low-tide window, checks for post-storm debris potential - by looking at recent pressure drops and wind events. + Confirms a recent storm passed through by checking pressure drops, + then finds the first post-storm low-tide window. @@ -143,21 +138,54 @@ Ask your assistant a question. It calls the right tools and comes back with an a
-## Install +## What's inside -The fastest way to run the server — no permanent install needed: +The server ships with 14 tools, 4 guided workflows, and 3 data resources. +If your assistant supports [MCP](https://modelcontextprotocol.io/) (most do), +it can use all of them. + + + + Find stations, pull tides, check weather, classify tidal phases, assess + deployment conditions, detect anomalies, generate charts — plus a few + more for diagnostics and capability testing. + + [Full tool reference →](/reference/tools/) + + + Pre-built workflows that walk through multi-step tasks: fishing trip + planning, marine safety checks, crab pot deployment, and catch pattern + analysis. Your assistant follows the steps, you get the results. + + [Prompt reference →](/reference/prompts/) + + + Station catalog, station detail, and nearby station lookup — structured + data your assistant can read directly without calling a tool first. + + [Resource reference →](/reference/resources/) + + + Tide charts and multi-panel conditions dashboards, rendered as PNG + (shows inline) or interactive HTML (pan, zoom, hover for values). + + [How-to: Charts →](/how-to/visualization/) + + + +
+ +
+ +## Get started + +Run the server — no permanent install needed: ```bash uvx mcnoaa-tides ``` -Register it with your MCP client. For example, in Claude Code: - -```bash -claude mcp add mcnoaa-tides -- uvx mcnoaa-tides -``` - -Or add to any MCP client's JSON config: +Then register it with your MCP client. Most accept a JSON config: ```json {