`get_wave_forecast`

Pack: marine · Endpoint: https://gateway.pipeworx.io/marine/mcp

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.

Parameters

Name	Type	Required	Description
`latitude`	number	yes	Latitude of the location.
`longitude`	number	yes	Longitude of the location.
`days`	number	no	Number of forecast days (1-7, default 7).

Example call

Arguments

{
  "latitude": 21.3099,
  "longitude": -157.8581,
  "days": 5
}

curl

curl -X POST https://gateway.pipeworx.io/marine/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_wave_forecast","arguments":{"latitude":21.3099,"longitude":-157.8581,"days":5}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_wave_forecast', {
  "latitude": 21.3099,
  "longitude": -157.8581,
  "days": 5
});

More examples

{
  "latitude": 34.0195,
  "longitude": -118.4912
}

Response shape

Always returns: latitude, longitude, days

Field	Type	Description
`latitude`	number	Latitude of the location
`longitude`	number	Longitude of the location
`days`	array	Array of daily wave forecast objects

Full JSON Schema

{
  "type": "object",
  "properties": {
    "latitude": {
      "type": "number",
      "description": "Latitude of the location"
    },
    "longitude": {
      "type": "number",
      "description": "Longitude of the location"
    },
    "days": {
      "type": "array",
      "description": "Array of daily wave forecast objects",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "description": "Forecast date"
          },
          "wave_height_max_m": {
            "type": "number",
            "description": "Maximum wave height in meters"
          },
          "wave_period_max_s": {
            "type": "number",
            "description": "Maximum wave period in seconds"
          },
          "wave_direction_dominant_deg": {
            "type": "number",
            "description": "Dominant wave direction in degrees"
          }
        },
        "required": [
          "date",
          "wave_height_max_m",
          "wave_period_max_s",
          "wave_direction_dominant_deg"
        ]
      }
    }
  },
  "required": [
    "latitude",
    "longitude",
    "days"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

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

See Getting Started for client-specific install steps.

get_wave_forecast