API & MCP

Everything a person can do on Best Months by Climate Normals, a program or AI agent can do with the same inputs and get the identical result.

HTTP API

POST https://hearthclimatemonths.usefulweb.app/api/v1/calculate – run Best Months by Climate Normals
GET https://hearthclimatemonths.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.

Best Months by Climate Normals

Finds the nearest weather station with official 1991–2020 climate normals — Deutscher Wetterdienst for Germany, NOAA for the United States — and rates every month for drying laundry, painting, mowing, barbecues or walks from its typical temperature and how often it rains.

Inputs of Best Months by Climate Normals
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.
`activity`	select (drying, painting, mowing, bbq, walk)	"drying"	Activity

Example request

Berlin: best months for drying laundry outside

curl -X POST https://hearthclimatemonths.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{"place":"52.47, 13.40","activity":"drying"}'

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://hearthclimatemonths.usefulweb.app/mcp – protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake).
Tools: hearth_climate_months
Local stdio connector: node src/mcp-stdio.ts --tool=hearth-climate-months

{
  "mcpServers": {
    "hearth-climate-months": { "type": "http", "url": "https://hearthclimatemonths.usefulweb.app/mcp" }
  }
}