# marine [Health: Active]

**Category:** 🌳 Environment & Nature  
**Repository:** https://github.com/pipeworx-io/mcp-marine  
**GitHub Stars:** 0  
**npm Downloads (last month):** 437  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/marine

## Description
Marine MCP — wraps marine-api.open-meteo.com (free, no auth)

## Tools
Capabilities this server exposes over MCP:

- **get_wave_forecast** — Get multi-day wave forecasts for coastal locations (e.g., "Hawaii", "California Coast"). Returns max wave height, period, and dominant direction per day. Use when planning water activities or monitoring upcoming swell.
- **get_current_waves** — Check real-time wave conditions at a coastal location. Returns current wave height, period, and direction. Use for immediate surfing, boating, or maritime planning decisions.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "marine": {
    "command": "npx",
    "args": ["-y","@pipeworx/mcp-marine"],
    "env": {
      "PIPEWORX_API_KEY": "",
      "PIPEWORX_META_TOOLS": ""
    }
  }
}
```

**Requires environment variables:** `PIPEWORX_API_KEY`, `PIPEWORX_META_TOOLS` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What marine does

marine exposes coastal wave data from `marine-api.open-meteo.com` through the Model Context Protocol. Its two domain-specific tools cover immediate conditions and upcoming forecasts:

- `get_current_waves` returns the present wave height, period, and direction for a coastal location.
- `get_wave_forecast` returns daily forecast values over multiple days, including maximum wave height, period, and dominant direction.

The tools are intended for questions such as whether current conditions suit surfing or boating, or how swell may develop over the next several days. Locations can be described in geographic terms such as Hawaii or the California Coast, while the direct HTTP example supplies latitude and longitude.

## How it works

The hosted MCP endpoint is available at `https://gateway.pipeworx.io/marine/mcp`. An MCP client connects to that URL and discovers the marine tools. The endpoint also exposes shared Pipeworx gateway tools, including `ask_pipeworx`, `discover_tools`, `search_within`, and memory-related tools. These shared tools can route questions beyond marine data; they are included even when connecting to the pack-specific endpoint.

A separate full-gateway URL, `https://gateway.pipeworx.io/mcp`, lists the broader catalog directly. Both endpoints use the same gateway and data sources, while the marine URL lists the marine pack tools directly.

For clients without MCP support, the gateway provides HTTP tool access under `/v1/tools/`. For example, `get_wave_forecast` can be called with a JSON body containing latitude, longitude, and a number of days.

## Setup and configuration

Add the hosted endpoint to an MCP client with a server entry named `marine`:

```json
{
  "mcpServers": {
    "marine": {
      "url": "https://gateway.pipeworx.io/marine/mcp"
    }
  }
}
```

The local npm option runs `@pipeworx/mcp-marine` through `npx` and forwards requests to the same gateway:

```json
{
  "mcpServers": {
    "marine": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-marine"]
    }
  }
}
```

The local bridge requires network access. Anonymous use is available with a daily limit of 50 calls. A free Pipeworx account raises the limit to 200 calls; provide the account key as `PIPEWORX_API_KEY` in the client environment. Set `PIPEWORX_META_TOOLS=1` if the local bridge should also list the shared gateway tools.

## Tools and capabilities

- Retrieve current coastal wave height, period, and direction.
- Request multi-day wave forecasts for coastal locations.
- Call tools through MCP over hosted HTTP.
- Run a local stdio bridge with `npx`.
- Invoke `get_wave_forecast` directly through the gateway HTTP API.
- Ask broader natural-language questions through the shared `ask_pipeworx` tool.

## Limitations and notes

The local npm bridge has no offline mode and must reach the Pipeworx gateway. Anonymous calls are limited to 50 per day, while an account-key connection allows 200 per day. The hosted pack endpoint includes shared Pipeworx meta-tools in addition to the marine tools, so clients may display more tools than the two marine-specific functions. The integration is independent and unofficial rather than published or endorsed by the upstream marine API provider. Pipeworx handles the gateway connection, and its API key is sent as a Bearer token when configured.

_Full upstream README: https://allmcps.com/mcp/marine/readme_