Marine

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:

{
  "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:

{
  "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.