`weather_timeline`

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

Get daily weather for a location — works for BOTH historical weather (past dates) and forecast (future or no dates). Use this for HISTORICAL weather and “weather on a past date” questions, e.g. “what was the weather in Paris on 2023-07-04” (location: “Paris”, start_date: “2023-07-04”). Pass start_date alone for a single day, or start_date + end_date for a range (weather timeline). Returns per-day temp/min/max, humidity, precipitation, wind, and conditions. Example: weather_timeline({ location: “London”, start_date: “2024-01-01”, end_date: “2024-01-07” }).

Parameters

Name	Type	Required	Description
`location`	string	yes	City name (e.g. “Paris”, “New York, NY”) or “lat,lon” (e.g. “48.8566,2.3522”).
`start_date`	string	no	Optional start date in YYYY-MM-DD format. Past dates return HISTORICAL weather; future dates return forecast. Omit for the default 15-day forecast.
`end_date`	string	no	Optional end date in YYYY-MM-DD format. Only used when start_date is also given; produces a date-range timeline.
`units`	string	no	Unit group: “metric” (°C, km/h — default), “us” (°F, mph), or “uk”.
`_apiKey`	string	no	Optional — your own Visual Crossing API key for higher limits; omit to use the shared Pipeworx key.

Example call

Arguments

{
  "location": "Paris",
  "start_date": "2023-07-04"
}

curl

curl -X POST https://gateway.pipeworx.io/visualcrossing/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"weather_timeline","arguments":{"location":"Paris","start_date":"2023-07-04"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('weather_timeline', {
  "location": "Paris",
  "start_date": "2023-07-04"
});

More examples

{
  "location": "48.8566,2.3522",
  "start_date": "2024-01-01",
  "end_date": "2024-01-07",
  "units": "metric"
}

Connect

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

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

See Getting Started for client-specific install steps.

weather_timeline