Environment
Data source: NOAA CO-OPS Tides & Currents
MCP Protocol
Endpoint
https://context.gnist.ai/mcp/noaa-tides/
claude_desktop_config.json
{
"mcpServers": {
"gnist-noaa-tides": {
"url": "https://context.gnist.ai/mcp/noaa-tides/",
"headers": {
"Gnist-API-Key": "YOUR_API_KEY"
}
}
}
}
Shell
curl -X POST "https://context.gnist.ai/mcp/noaa-tides/" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Gnist-API-Key: YOUR_API_KEY" \
-d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "get_tide_predictions", "arguments": {"station": "example", "begin_date": "example", "end_date": "example"}}}'
REST API
API Root
https://context.gnist.ai/rest/noaa-tides/
5 endpoints available:
GET /rest/noaa-tides/get_tide_predictionsGET /rest/noaa-tides/get_water_levelsGET /rest/noaa-tides/get_station_dataGET /rest/noaa-tides/search_stationsGET /rest/noaa-tides/report_feedback
Shell
curl "https://context.gnist.ai/rest/noaa-tides/get_tide_predictions?station=example&begin_date=example&end_date=example" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/rest/noaa-tides/get_tide_predictions",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={
"station": "example",
"begin_date": "example",
"end_date": "example"
},
)
print(resp.json())
Command Line
Command
gc noaa-tides
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (5)
get_tide_predictionsGet tide predictions for a NOAA CO-OPS station.
| Parameter | Type | Required | Description |
|---|---|---|---|
station | string | required | NOAA station ID (e.g. '9414290' for San Francisco, '8518750' for The Battery NYC). |
begin_date | string | required | Start date in yyyyMMdd format (e.g. '20260320'). |
end_date | string | required | End date in yyyyMMdd format (e.g. '20260321'). Max 1 year for high/low. |
datum | string | optional | Tidal datum reference. Common: MLLW (default), MSL, NAVD, MHHW. (default: "MLLW") |
interval | string | optional | Prediction interval: 'hilo' for high/low only, 'h' for hourly, or minutes (1,5,6,10,15,30,60). (default: "hilo") |
units | string | optional | Units: 'metric' (meters, Celsius) or 'english' (feet, Fahrenheit). (default: "metric") |
get_water_levelsGet observed (actual) water level data from a NOAA tide station.
| Parameter | Type | Required | Description |
|---|---|---|---|
station | string | required | NOAA station ID (e.g. '9414290' for San Francisco). |
begin_date | string | required | Start date in yyyyMMdd format. |
end_date | string | required | End date in yyyyMMdd format. Max 1 month for 6-minute data. |
datum | string | optional | Tidal datum reference. Common: MLLW (default), MSL, NAVD. (default: "MLLW") |
units | string | optional | Units: 'metric' or 'english'. (default: "metric") |
get_station_dataGet meteorological observations from a NOAA coastal station.
| Parameter | Type | Required | Description |
|---|---|---|---|
station | string | required | NOAA station ID (e.g. '9414290'). |
product | string | required | Data product: 'water_temperature', 'air_temperature', 'wind', 'air_pressure', 'humidity'. |
date | string | optional | Date filter: 'latest' for most recent, 'today', 'recent' (last 72h). (default: "latest") |
units | string | optional | Units: 'metric' or 'english'. (default: "metric") |
search_stationsSearch for NOAA tide prediction stations.
| Parameter | Type | Required | Description |
|---|---|---|---|
state | any | optional | Filter by US state abbreviation (e.g. 'CA', 'NY', 'FL'). |
max_results | integer | optional | Maximum number of stations to return (1-500). (default: 50) |
report_feedbackReport a bug, feature request, or general feedback for this data source.
| Parameter | Type | Required | Description |
|---|---|---|---|
feedback | string | required | |
feedback_type | string | optional | (default: "general") |