forecast
Pack: pirate-weather · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/forecast for the schema, then POST the same URL with its arguments for the data.
Full forecast at point.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
lat | number | yes | |
lon | number | yes | |
time | string | no | ISO 8601 or epoch seconds for historic. |
exclude | string | no | |
extend | string | no | hourly |
lang | string | no | |
units | string | no | us | si | ca | uk | uk2 |
Example call
Arguments
{
"lat": 40.7128,
"lon": -74.006
}curl
curl -X POST https://gateway.pipeworx.io/pirate-weather/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"forecast","arguments":{"lat":40.7128,"lon":-74.006}}}'TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('forecast', {
"lat": 40.7128,
"lon": -74.006
});More examples
{
"lat": 51.5074,
"lon": -0.1278,
"time": "2024-01-15T12:00:00Z",
"units": "si",
"extend": "hourly"
}Response shape
| Field | Type | Description |
|---|---|---|
latitude | number | Latitude of the forecast location |
longitude | number | Longitude of the forecast location |
timezone | string | Timezone of the location |
currently | object | Current weather conditions |
minutely | object | Minute-by-minute forecast |
hourly | object | Hourly forecast |
daily | object | Daily forecast |
alerts | array | Weather alerts |
flags | object | Request flags and data sources |
Full JSON Schema
{
"type": "object",
"properties": {
"latitude": {
"type": "number",
"description": "Latitude of the forecast location"
},
"longitude": {
"type": "number",
"description": "Longitude of the forecast location"
},
"timezone": {
"type": "string",
"description": "Timezone of the location"
},
"currently": {
"type": "object",
"description": "Current weather conditions",
"properties": {
"time": {
"type": "integer",
"description": "Unix timestamp"
},
"summary": {
"type": "string",
"description": "Human-readable weather summary"
},
"icon": {
"type": "string",
"description": "Weather icon identifier"
},
"temperature": {
"type": "number",
"description": "Current temperature"
},
"apparentTemperature": {
"type": "number",
"description": "Apparent/feels-like temperature"
},
"humidity": {
"type": "number",
"description": "Humidity as decimal 0-1"
},
"pressure": {
"type": "number",
"description": "Barometric pressure"
},
"windSpeed": {
"type": "number",
"description": "Wind speed"
},
"windGust": {
"type": "number",
"description": "Wind gust speed"
},
"windBearing": {
"type": "number",
"description": "Wind direction in degrees"
},
"cloudCover": {
"type": "number",
"description": "Cloud cover as decimal 0-1"
},
"uvIndex": {
"type": "number",
"description": "UV index"
},
"visibility": {
"type": "number",
"description": "Visibility distance"
},
"dewPoint": {
"type": "number",
"description": "Dew point temperature"
},
"precipIntensity": {
"type": "number",
"description": "Precipitation intensity"
},
"precipProbability": {
"type": "number",
"description": "Precipitation probability 0-1"
},
"precipType": {
"type": "string",
"description": "Type of precipitation"
}
}
},
"minutely": {
"type": "object",
"description": "Minute-by-minute forecast",
"properties": {
"summary": {
"type": "string",
"description": "Summary for minutely period"
},
"icon": {
"type": "string",
"description": "Weather icon for period"
},
"data": {
"type": "array",
"description": "Array of minute forecasts",
"items": {
"type": "object",
"properties": {
"time": {
"type": "integer",
"description": "Unix timestamp"
},
"precipIntensity": {
"type": "number",
"description": "Precipitation intensity"
},
"precipProbability": {
"type": "number",
"description": "Precipitation probability"
},
"precipType": {
"type": "string",
"description": "Type of precipitation"
}
}
}
}
}
},
"hourly": {
"type": "object",
"description": "Hourly forecast",
"properties": {
"summary": {
"type": "string",
"description": "Summary for hourly period"
},
"icon": {
"type": "string",
"description": "Weather icon for period"
},
"data": {
"type": "array",
"description": "Array of hourly forecasts",
"items": {
"type": "object",
"properties": {
"time": {
"type": "integer",
"description": "Unix timestamp"
},
"summary": {
"type": "string",
"description": "Weather summary"
},
"icon": {
"type": "string",
"description": "Weather icon"
},
"temperature": {
"type": "number",
"description": "Temperature"
},
"apparentTemperature": {
"type": "number",
"description": "Apparent temperature"
},
"humidity": {
"type": "number",
"description": "Humidity 0-1"
},
"pressure": {
"type": "number",
"description": "Pressure"
},
"windSpeed": {
"type": "number",
"description": "Wind speed"
},
"windGust": {
"type": "number",
"description": "Wind gust"
},
"windBearing": {
"type": "number",
"description": "Wind bearing degrees"
},
"cloudCover": {
"type": "number",
"description": "Cloud cover 0-1"
},
"uvIndex": {
"type": "number",
"description": "UV index"
},
"visibility": {
"type": "number",
"description": "Visibility"
},
"dewPoint": {
"type": "number",
"description": "Dew point"
},
"precipIntensity": {
"type": "number",
"description": "Precipitation intensity"
},
"precipProbability": {
"type": "number",
"description": "Precipitation probability"
},
"precipType": {
"type": "string",
"description": "Type of precipitation"
}
}
}
}
}
},
"daily": {
"type": "object",
"description": "Daily forecast",
"properties": {
"summary": {
"type": "string",
"description": "Summary for daily period"
},
"icon": {
"type": "string",
"description": "Weather icon"
},
"data": {
"type": "array",
"description": "Array of daily forecasts",
"items": {
"type": "object",
"properties": {
"time": {
"type": "integer",
"description": "Unix timestamp"
},
"summary": {
"type": "string",
"description": "Weather summary"
},
"icon": {
"type": "string",
"description": "Weather icon"
},
"temperatureMin": {
"type": "number",
"description": "Minimum temperature"
},
"temperatureMax": {
"type": "number",
"description": "Maximum temperature"
},
"apparentTemperatureMin": {
"type": "number",
"description": "Minimum apparent temperature"
},
"apparentTemperatureMax": {
"type": "number",
"description": "Maximum apparent temperature"
},
"humidity": {
"type": "number",
"description": "Humidity 0-1"
},
"pressure": {
"type": "number",
"description": "Pressure"
},
"windSpeed": {
"type": "number",
"description": "Wind speed"
},
"windGust": {
"type": "number",
"description": "Wind gust"
},
"windBearing": {
"type": "number",
"description": "Wind bearing"
},
"cloudCover": {
"type": "number",
"description": "Cloud cover 0-1"
},
"uvIndex": {
"type": "number",
"description": "Max UV index"
},
"visibility": {
"type": "number",
"description": "Visibility"
},
"dewPoint": {
"type": "number",
"description": "Dew point"
},
"precipIntensity": {
"type": "number",
"description": "Precipitation intensity"
},
"precipIntensityMax": {
"type": "number",
"description": "Max precipitation intensity"
},
"precipIntensityMaxTime": {
"type": "integer",
"description": "Time of max precipitation"
},
"precipProbability": {
"type": "number",
"description": "Precipitation probability"
},
"precipType": {
"type": "string",
"description": "Type of precipitation"
},
"precipAccumulation": {
"type": "number",
"description": "Total precipitation"
},
"sunriseTime": {
"type": "integer",
"description": "Sunrise time"
},
"sunsetTime": {
"type": "integer",
"description": "Sunset time"
}
}
}
}
}
},
"alerts": {
"type": "array",
"description": "Weather alerts",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Alert title"
},
"description": {
"type": "string",
"description": "Alert description"
},
"time": {
"type": "integer",
"description": "Alert issue time"
},
"expires": {
"type": "integer",
"description": "Alert expiration time"
},
"uri": {
"type": "string",
"description": "Alert URI"
},
"regions": {
"type": "array",
"description": "Affected regions",
"items": {
"type": "string"
}
},
"severity": {
"type": "string",
"description": "Alert severity"
}
}
}
},
"flags": {
"type": "object",
"description": "Request flags and data sources"
}
}
}Connect
Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:
{
"mcpServers": {
"pipeworx": {
"url": "https://pipeworx.io/mcp"
}
}
}Connect to just the pirate-weather pack
{
"mcpServers": {
"pirate-weather": {
"url": "https://gateway.pipeworx.io/pirate-weather/mcp"
}
}
}See Getting Started for client-specific install steps.