Marine

liveWeatherEnvironment

Ocean wave forecasts and current conditions via the Open-Meteo Marine API

2tools
0msauth
free tier50 calls/day

Tools

get_wave_forecastrequired: latitude, longitude

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 monitori

Parameters
NameTypeDescription
latitudereqnumberLatitude of the location.
longitudereqnumberLongitude of the location.
daysoptnumberNumber of forecast days (1-7, default 7).
▶Try it
get_current_wavesrequired: latitude, longitude

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.

Parameters
NameTypeDescription
latitudereqnumberLatitude of the location.
longitudereqnumberLongitude of the location.
▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/marine/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/marine/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_wave_forecast","arguments":{"latitude": 37.7749, "longitude": -122.4194}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("get_wave_forecast", {"latitude":"example","longitude":"example"});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("ocean wave forecasts and current conditions via the open-meteo marine api");