API & MCP

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

HTTP API

Garden Forecast Planner

Reads the MET Norway forecast for your garden and plans the next nine days: frost and cold-night risk, an estimated soil temperature, evapotranspiration, whether planned sowings and plantings should go ahead or wait (and until when), a watering plan per bed from rain and water use, hints for logs and mushroom beds, and in Norway, Sweden, Finland and Denmark the radar rain for the next two hours.

Inputs of Garden Forecast Planner
FieldTypeDefaultDescription
place (required)text"52.47, 13.40"Place (latitude, longitude). Decimal degrees such as “52.47, 13.40”. Rounded to 0.01° (about 1 km).
timeZonetext"Europe/Berlin"Time zone of the place
daysinteger9Days ahead
lastFrost (required)text"04-20"Last spring frost (MM-DD). Month and day, for example 04-20. Hearth’s Frost Dates Finder gives it for Germany and the United States.
firstFrost (required)text"10-20"First autumn frost (MM-DD)
plantingstable[{"bed":"Raised bed 1","kind":"garden","plant":"tomato","areaM2":0.72,"start":""Plantings

Example request

Berlin: beans and tomatoes still to plant, lettuce in the ground

curl -X POST https://greenplotforecastplanner.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{"place":"52.47, 13.40","timeZone":"Europe/Berlin","days":9,"lastFrost":"04-20","firstFrost":"10-20","plantings":[{"bed":"Raised bed 1","kind":"garden","plant":"tomato","variety":"tomato-cherry","areaM2":0.72,"start":"2026-11-10"},{"bed":"Raised bed 2","kind":"garden","plant":"bush-bean","areaM2":1,"start":"2026-11-09"},{"bed":"Raised bed 2","kind":"garden","plant":"lettuce","variety":"lettuce-looseleaf","areaM2":0.5},{"bed":"Shade","kind":"log-stack","plant":"shiitake","areaM2":1,"start":"2025-04-01"}]}'

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)

{
  "mcpServers": {
    "greenplot-forecast-planner": { "type": "http", "url": "https://greenplotforecastplanner.usefulweb.app/mcp" }
  }
}