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
POST https://greenplotforecastplanner.usefulweb.app/api/v1/calculate– run Garden Forecast PlannerGET https://greenplotforecastplanner.usefulweb.app/api/v1/tool– inputs, output schema, examples- OpenAPI 3.1: /openapi.json · /openapi.yaml
- Errors:
application/problem+json;422includes per-fielderrors.
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.
| Field | Type | Default | Description |
|---|---|---|---|
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). |
timeZone | text | "Europe/Berlin" | Time zone of the place |
days | integer | 9 | Days 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) |
plantings | table | [{"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)
- Streamable HTTP endpoint:
https://greenplotforecastplanner.usefulweb.app/mcp– protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake). - Tools:
greenplot_forecast_planner - Local stdio connector:
node src/mcp-stdio.ts --tool=greenplot-forecast-planner
{
"mcpServers": {
"greenplot-forecast-planner": { "type": "http", "url": "https://greenplotforecastplanner.usefulweb.app/mcp" }
}
}