NOAA-TidesAndCurrents-MCP: Quick Access to Ocean-Atmosphere Data with Multi-Mode Integration

NOAA TidesAndCurrents MCP

The NOAA Tides & Currents MCP Server provides tools for fast access to NOAA ocean and atmospheric data, including tide, current, meteorological, astronomical, and climate research data. It supports multiple transport modes and integration methods.

Research and data Developer tools #Tide data #Meteorological tools #Ocean research #Astronomical calculations .TypeScript

rating : 2.5 points

downloads : 0

update time : 2025-07-25

What is the NOAA Tides & Currents MCP Server?

This is a service that provides NOAA ocean and atmospheric data through the Model Context Protocol (MCP). It allows users to easily query real - time tide, current, weather, and astronomical data from over 13,000 monitoring stations worldwide, as well as long - term climate research data.

How to use the NOAA Tides & Currents MCP Server?

You can run it directly through a simple command - line tool (npx) or integrate it into MCP clients such as Claude Desktop. The service offers two operating modes: standard MCP protocol and HTTP streaming mode.

Applicable scenarios

Suitable for scenarios that require accurate ocean and meteorological data, such as marine navigation, fishing activities, coastal engineering, climate research, and outdoor activity planning.

Main features

Water area dataProvides real - time and historical water level, tide prediction, current measurement, and other water area data.

Climate researchIncludes climate research data such as sea - level trends, extreme water - level statistics, and flood predictions.

Astronomical dataProvides astronomical data such as moon phases, sunrise and sunset times, suitable for marine navigation and outdoor activity planning.

Multi - transport modeSupports two transport modes, STDIO and HTTP, to adapt to different usage scenarios.

Advantages and limitations

Advantages

Covers data from over 13,000 monitoring stations worldwide.

Fast response speed, built on the FastMCP framework.

Provides more than 25 professional tools to meet different needs.

Supports output in multiple data formats (JSON/XML/CSV).

Limitations

Requires a Node.js 18+ runtime environment.

The NOAA API itself has access frequency limitations.

Some historical data may be incomplete.

How to use

Quick start

Use NPX to run the service directly without installation.

HTTP mode

If you need to access via HTTP, you can start the HTTP server mode.

Claude desktop integration

Install it into Claude Desktop through Smithery.

Usage examples

Marine planningQuery the tide times of a specific port to plan the best time to enter and leave the port.

Fishing activitiesGet current predictions to find the best fishing time.

Climate researchAnalyze long - term sea - level change trends.

Frequently Asked Questions

How to find the ID of the nearest monitoring station?

What if the service response is slow?

How far back can historical data be obtained?

Related resources

NPM package page

Official NPM package information

NOAA official data portal

Official website for NOAA tide and current data

MCP protocol documentation

Official documentation for the Model Context Protocol

🚀 NOAA Tides & Currents MCP Server

This project offers lightning - fast access to NOAA's oceanic and atmospheric data through the MCP. It serves as a one - stop solution for tides, currents, weather, astronomy, and climate data.

🚀 Quick Start

⚡ NPX Installation (Recommended)

# Install and run immediately - no setup required!
npx @ryancardin/noaa-tides-currents-mcp-server

# Or use the shorter alias
npx noaa-mcp

🔌 Transport Modes

STDIO Mode (Default - MCP Protocol)

# Standard MCP server for Claude Desktop integration
npx @ryancardin/noaa-tides-currents-mcp-server

# Or use the shorter alias
npx noaa-mcp

HTTP Streamable Mode (Web Integration)

# Start HTTP server on default port 3000
npx @ryancardin/noaa-tides-currents-mcp-server --http

# Specify custom port
npx @ryancardin/noaa-tides-currents-mcp-server --http --port 8080

# Using shorter alias
npx noaa-mcp --http --port 8080

# Access via Server-Sent Events
curl http://localhost:3000/sse

🎯 Claude Desktop Integration

Install directly to Claude Desktop via Smithery:

npx -y @smithery/cli install @RyanCardin15/tidesandcurrents --client claude

🔧 Manual Development Setup

# Clone and build
git clone https://github.com/RyanCardin15/NOAA-Tides-And-Currents-MCP.git
cd NOAA-Tides-And-Currents-MCP
npm install && npm run build

# Start the server
npm start

# Test with FastMCP
npx fastmcp dev dist/index.js

✨ Features

🌊 25+ Specialized Tools - From basic tide data to advanced climate projections
⚡ Lightning Fast - Built on FastMCP for optimal performance
🎯 Zero Config - Works out of the box with Claude Desktop
🌍 Comprehensive Data - Water levels, currents, weather, moon phases, sun data
📊 Climate Research Ready - Sea level trends, flooding projections, extreme events
🚀 NPX Ready - Install and run with a single command

🛠️ Available Tools

🌊 Water Data Tools (6 tools)

Water Levels & Tides

get_water_levels - Real-time and historical water level data
get_tide_predictions - High/low tide predictions and continuous data
get_currents - Real-time and historical current measurements
get_current_predictions - Current speed and direction forecasts
get_meteorological_data - Wind, air temp, water temp, pressure, etc.

Station Information

get_stations - Search and list monitoring stations
get_station_details - Detailed station metadata and capabilities

🔬 Climate & Research Tools (9 tools)

Sea Level Analysis

get_sea_level_trends - Long-term sea level rise trends and rates
get_extreme_water_levels - Statistical analysis of extreme events

High Tide Flooding Analysis

get_high_tide_flooding_daily - Daily flood event counts
get_high_tide_flooding_monthly - Monthly flooding patterns
get_high_tide_flooding_seasonal - Seasonal flood analysis
get_high_tide_flooding_annual - Yearly flooding trends
get_high_tide_flooding_projections - Future flood risk scenarios
get_high_tide_flooding_likelihoods - Daily flood probability

Historical Extremes

get_top_ten_water_levels - Highest/lowest water levels on record

🌙 Astronomy Tools (7 tools)

Moon Phase Calculations

get_moon_phase - Current moon phase and illumination
get_moon_phases_range - Moon phases over date ranges
get_next_moon_phase - Find next new/full/quarter moons

Solar Calculations

get_sun_times - Sunrise, sunset, dawn, dusk times
get_sun_times_range - Solar times over date ranges
get_sun_position - Real-time sun azimuth and elevation
get_next_sun_event - Next sunrise, sunset, or solar noon

⚙️ Configuration Tools (1 tool)

API Parameters

get_parameter_definitions - Valid values for all API parameters

💻 Usage Examples

🌊 Get Current Tide Conditions

# Get latest water levels for Boston Harbor
get_water_levels station="8443970" date="latest"

# Get today's tide predictions for Miami
get_tide_predictions station="8723214" begin_date="today" end_date="today" interval="hilo"

🌀 Hurricane Preparedness

# Get extreme water level statistics for storm planning
get_extreme_water_levels station="8518750" units="english"

# Check flooding likelihood for tomorrow
get_high_tide_flooding_likelihoods station="8518750" date="2024-12-16" threshold="minor"

🔬 Climate Research

# Analyze 30-year sea level trends
get_sea_level_trends station="8518750" affiliation="US"

# Get high tide flooding projections for 2050s under intermediate sea level rise
get_high_tide_flooding_projections station="8518750" scenario="intermediate" decade="2050s"

🌙 Astronomy & Navigation

# Get tonight's moon phase for navigation
get_moon_phase date="2024-12-15" latitude="42.3601" longitude="-71.0589"

# Calculate sunrise/sunset for sailing
get_sun_times date="2024-12-15" latitude="25.7617" longitude="-80.1918" timezone="America/New_York"

🎣 Fishing & Recreation

# Best fishing times with current predictions
get_current_predictions station="ACT0446" date="today" interval="MAX_SLACK"

# Wind and weather conditions
get_meteorological_data station="8443970" product="wind" date="today"

🏗️ Advanced Usage

🔧 Development & Testing

# Run in development mode (stdio)
npm run dev

# Development with HTTP transport
npm run dev:http

# Production builds with different transports
npm start                    # STDIO mode (default)
npm run start:http          # HTTP on port 3000
npm run start:http:3001     # HTTP on port 3001
npm run start:http:8080     # HTTP on port 8080

# Inspect server capabilities
npx fastmcp inspect dist/index.js

🌐 HTTP Stream Integration

When running in HTTP mode, the server provides Server-Sent Events (SSE) at /sse:

# Start HTTP server
npx @ryancardin/noaa-tides-currents-mcp-server --http --port 3000

# Test the endpoint
curl -N http://localhost:3000/sse

# Or integrate with web applications
fetch('http://localhost:3000/sse')
  .then(response => response.body.getReader())
  .then(reader => {
    // Handle streaming MCP responses
  });

Use Cases for HTTP Mode:

🌐 Web Applications - Integrate with React, Vue, Angular apps
📱 Mobile Apps - REST-like access from mobile applications
🔗 API Gateways - Proxy through load balancers or API gateways
🧪 Testing - Easy curl-based testing and debugging

📊 Data Formats & Export

All tools support multiple output formats:

JSON (default) - Perfect for programmatic use
XML - Legacy system integration
CSV - Direct spreadsheet import

🌍 Global Station Coverage

13,000+ stations worldwide
Real-time data from NOAA's CO-OPS network
Historical records dating back decades
Global tide predictions and current forecasts

🚦 API Endpoints

This server integrates with three NOAA APIs:

API	Purpose	Base URL
Data API	Real-time observations & predictions	`api.tidesandcurrents.noaa.gov/api/prod/`
Metadata API	Station information & capabilities	`api.tidesandcurrents.noaa.gov/mdapi/prod/`
Derived Products API	Climate analysis & research data	`api.tidesandcurrents.noaa.gov/dpapi/prod/`

🔧 Technical Details

Architecture

🚀 FastMCP Framework - High-performance MCP server
📝 TypeScript - Full type safety and IntelliSense
🔧 Zod Validation - Runtime parameter validation
⚡ Axios HTTP Client - Reliable API communication
🌙 SunCalc Integration - Precise astronomical calculations

Transport Options

📡 STDIO Transport - Standard MCP protocol for desktop clients
🌐 HTTP Stream Transport - Server-Sent Events for web integration
🔄 Dual Mode Support - Switch between transports via command-line flags

System Requirements

Node.js 18+
NPM 8+
MCP Client (Claude Desktop, etc.)

Package Size

📦 Bundled: 43.9 KB
📂 Installed: 286.2 KB
⚡ Load Time: <100ms

🐛 Troubleshooting

Common Issues & Solutions

Server Won't Start

# Check Node.js version
node --version  # Should be 18+

# Rebuild TypeScript
npm run build

API Errors

Invalid Station ID: Use get_stations to find valid stations
Date Format Issues: Use YYYYMMDD or MM/DD/YYYY formats
Rate Limiting: NOAA APIs have usage limits - space out requests

MCP Connection Issues

Ensure Claude Desktop MCP settings are configured correctly
Check that the server binary has execute permissions: chmod +x dist/index.js

📈 Roadmap

[ ] 🌊 Real-time Alerts - Webhook support for tide/weather alerts
[ ] 📱 Mobile SDK - React Native integration
[ ] 🗺️ GIS Integration - Shapefile and KML export
[ ] 🤖 AI Insights - Automated pattern recognition
[ ] ⚡ GraphQL API - Modern query interface
[ ] 🌐 Multi-language - I18n support

🤝 Contributing

We love contributions! Here's how to get started:

🍴 Fork the repository
🌿 Branch for your feature (git checkout -b amazing-feature)
💻 Code your improvements
✅ Test with npm test
📤 Submit a pull request

Development Commands

npm run build    # Build TypeScript
npm run dev      # Development mode  
npm run test     # Run test suite
npm run format   # Format with Prettier

📄 License

MIT License - see LICENSE file for details.

Built with ❤️ by Ryan Cardin

🔗 Links & Resources

📦 NPM Package: @ryancardin/noaa-tides-currents-mcp-server
🏪 Smithery: Auto-install for Claude Desktop
🌊 NOAA CO-OPS: Official NOAA Data Portal
🤖 MCP Protocol: Model Context Protocol Docs
⚡ FastMCP: FastMCP Framework

⭐ Star this repo if it helped you!

Made possible by NOAA's commitment to open oceanic data 🌊

Featured MCP Services

Markdownify MCP

Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.

The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.

A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.

Python

201

4.5 points

Duckduckgo MCP Server

Certified

The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.

Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.

UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.

616

5 points

Gmail MCP Server

A Gmail automatic authentication MCP server designed for Claude Desktop, supporting Gmail management through natural language interaction, including complete functions such as sending emails, label management, and batch operations.

Context7 MCP is a service that provides real-time, version-specific documentation and code examples for AI programming assistants. It is directly integrated into prompts through the Model Context Protocol to solve the problem of LLMs using outdated information.

TypeScript

5.3K

4.7 points

Zhiqi Future, Your AI Solution Think Tank

English 简体中文繁體中文にほんご