API & MCP

Everything a person can do on Laundry Drying Forecast, a program or AI agent can do with the same inputs and get the identical result.

HTTP API

POST https://hearthdryingforecast.usefulweb.app/api/v1/calculate – run Laundry Drying Forecast
GET https://hearthdryingforecast.usefulweb.app/api/v1/tool – inputs, output schema, examples
OpenAPI 3.1: /openapi.json · /openapi.yaml
Errors: application/problem+json; 422 includes per-field errors.

Laundry Drying Forecast

Rates the next days for drying laundry outdoors at your place. It reads the MET Norway forecast hour by hour, finds the longest dry stretch in your drying hours and estimates how fast washing dries from temperature, humidity and wind (Penman evaporation), with a verdict per day.

Inputs of Laundry Drying Forecast
Field	Type	Default	Description
`place` (required)	text	"52.52, 13.40"	Place (latitude, longitude). Decimal degrees such as “52.52, 13.40”, or degrees-minutes-seconds. Rounded to 0.01° (about 1 km) before the request.
`timeZone`	text	"Europe/Berlin"	Time zone of the place. IANA name such as Europe/Berlin, Europe/London or America/New_York. Hours and dates are shown in this zone.
`load`	select (light, heavy)	"light"	Load
`fromHour`	integer	8	Hang out from (hour)
`toHour`	integer	19	Bring in by (hour)
`days`	integer	7	Days ahead. MET Norway forecasts about nine days ahead: hourly for the first two to three days, then in 6-hour steps.

Example request

Berlin, light load, 8:00–19:00

curl -X POST https://hearthdryingforecast.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{"place":"52.52, 13.40","timeZone":"Europe/Berlin","load":"light","fromHour":8,"toHour":19,"days":7}'

Every result contains

inputs (normalised, defaults applied), summary, result (validated against the published schema), units, assumptions, sources, warnings, computedAt and links.

MCP (Model Context Protocol)

Streamable HTTP endpoint: https://hearthdryingforecast.usefulweb.app/mcp – protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake).
Tools: hearth_drying_forecast
Local stdio connector: node src/mcp-stdio.ts --tool=hearth-drying-forecast

{
  "mcpServers": {
    "hearth-drying-forecast": { "type": "http", "url": "https://hearthdryingforecast.usefulweb.app/mcp" }
  }
}