{"openapi":"3.0.3","info":{"title":"Gnist Context — NOAA Tides & Currents","description":"Tidal predictions, observed water levels, and coastal station meteorological data for U.S. coastlines.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/noaa-tides/`\n- **Toolkit page:** `/toolkits/noaa-tides`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/noaa-tides/get_tide_predictions":{"post":{"tags":["Environment"],"summary":"get_tide_predictions","description":"Get tide predictions for a NOAA CO-OPS station.\n\nReturns predicted high/low tide times and heights, or water level predictions\nat regular intervals. Use 'hilo' interval for high/low tide times, or a numeric\ninterval for evenly-spaced predictions.\n\nArgs:\n    station: NOAA station identifier.\n    begin_date: Start date (yyyyMMdd).\n    end_date: End date (yyyyMMdd).\n    datum: Tidal datum reference level.\n    interval: Prediction granularity.\n    units: Measurement units.\n\nReturns:\n    Predictions with time, value (water level), and type (high/low if hilo).","operationId":"noaa_tides_get_tide_predictions","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"station":{"description":"NOAA station ID (e.g. '9414290' for San Francisco, '8518750' for The Battery NYC).","type":"string"},"begin_date":{"description":"Start date in yyyyMMdd format (e.g. '20260320').","type":"string"},"end_date":{"description":"End date in yyyyMMdd format (e.g. '20260321'). Max 1 year for high/low.","type":"string"},"datum":{"default":"MLLW","description":"Tidal datum reference. Common: MLLW (default), MSL, NAVD, MHHW.","type":"string"},"interval":{"default":"hilo","description":"Prediction interval: 'hilo' for high/low only, 'h' for hourly, or minutes (1,5,6,10,15,30,60).","type":"string"},"units":{"default":"metric","description":"Units: 'metric' (meters, Celsius) or 'english' (feet, Fahrenheit).","type":"string"}},"required":["station","begin_date","end_date"],"type":"object"}}}}}},"/rest/noaa-tides/get_water_levels":{"post":{"tags":["Environment"],"summary":"get_water_levels","description":"Get observed (actual) water level data from a NOAA tide station.\n\nReturns real-time or historical water level observations at 6-minute intervals.\nCompare with predictions to see storm surge, wind effects, or other anomalies.\n\nArgs:\n    station: NOAA station identifier.\n    begin_date: Start date (yyyyMMdd).\n    end_date: End date (yyyyMMdd).\n    datum: Tidal datum reference level.\n    units: Measurement units.\n\nReturns:\n    Observations with time, value (water level), sigma (std dev), and quality flag.","operationId":"noaa_tides_get_water_levels","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"station":{"description":"NOAA station ID (e.g. '9414290' for San Francisco).","type":"string"},"begin_date":{"description":"Start date in yyyyMMdd format.","type":"string"},"end_date":{"description":"End date in yyyyMMdd format. Max 1 month for 6-minute data.","type":"string"},"datum":{"default":"MLLW","description":"Tidal datum reference. Common: MLLW (default), MSL, NAVD.","type":"string"},"units":{"default":"metric","description":"Units: 'metric' or 'english'.","type":"string"}},"required":["station","begin_date","end_date"],"type":"object"}}}}}},"/rest/noaa-tides/get_station_data":{"post":{"tags":["Environment"],"summary":"get_station_data","description":"Get meteorological observations from a NOAA coastal station.\n\nRetrieves current or recent readings for water temperature, air temperature,\nwind speed/direction, barometric pressure, and other environmental parameters.\n\nArgs:\n    station: NOAA station identifier.\n    product: Type of meteorological data.\n    date: Time filter.\n    units: Measurement units.\n\nReturns:\n    Readings with time and measured values (varies by product).","operationId":"noaa_tides_get_station_data","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"station":{"description":"NOAA station ID (e.g. '9414290').","type":"string"},"product":{"description":"Data product: 'water_temperature', 'air_temperature', 'wind', 'air_pressure', 'humidity'.","type":"string"},"date":{"default":"latest","description":"Date filter: 'latest' for most recent, 'today', 'recent' (last 72h).","type":"string"},"units":{"default":"metric","description":"Units: 'metric' or 'english'.","type":"string"}},"required":["station","product"],"type":"object"}}}}}},"/rest/noaa-tides/search_stations":{"post":{"tags":["Environment"],"summary":"search_stations","description":"Search for NOAA tide prediction stations.\n\nFind stations by US state. Returns station IDs, names, and coordinates\nthat can be used with other tide tools.\n\nArgs:\n    state: US state abbreviation to filter by.\n    max_results: Maximum results.\n\nReturns:\n    List of stations with id, name, state, latitude, longitude.","operationId":"noaa_tides_search_stations","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by US state abbreviation (e.g. 'CA', 'NY', 'FL')."},"max_results":{"default":50,"description":"Maximum number of stations to return (1-500).","type":"integer"}},"type":"object"}}}}}},"/rest/noaa-tides/report_feedback":{"post":{"tags":["Environment"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"noaa_tides_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Environment","description":"Data sources: Environment"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}