Docs navigation
Reference
Weather MCP
Agents
Climate and agriculture
Smarter Weather covers the 50 US states and DC only. Coverage details
Climatology and agriculture-derived indices. Climate normals describe what is typical at a location for each calendar day — a 30-year base period, not a forecast. Growing degree days are computed on read from stored daily temperature extremes for a crop's thresholds.
A scheduling or farming integration uses this to ask “is tomorrow warmer than usual?” or to track season-to-date heat units against a growth-stage milestone. Pair normals with the weather daily block when you want departure from typical.
curl "https://api.smarterweather.com/v1/climate/normals?lat=42.3601&lon=-71.0589" \
-H "Authorization: Bearer ${SMARTERWEATHER_API_KEY:?set SMARTERWEATHER_API_KEY first, see developers.smarterweather.com/quickstart}"// save as sample.mjs; run: node --env-file=.env sample.mjs (Node 20.6+, ESM top-level await)
const res = await fetch(
"https://api.smarterweather.com/v1/climate/normals?lat=42.3601&lon=-71.0589",
{ headers: { Authorization: `Bearer ${process.env.SMARTERWEATHER_API_KEY}` } },
);
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();
console.log(JSON.stringify(data, null, 2));# pip install requests python-dotenv
import os, sys, requests
from dotenv import load_dotenv
load_dotenv(".env") # ./.env in the current directory; variables already set are kept
r = requests.get(
"https://api.smarterweather.com/v1/climate/normals",
params={"lat":"42.3601","lon":"-71.0589"},
headers={"Authorization": f"Bearer {os.environ['SMARTERWEATHER_API_KEY']}"},
)
if not r.ok:
sys.exit(f"{r.status_code} {r.text}")
data = r.json()
print(data)package main
import (
"fmt"
"io"
"log"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest("GET", "https://api.smarterweather.com/v1/climate/normals?lat=42.3601&lon=-71.0589", nil)
if err != nil {
log.Fatal(err)
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("SMARTERWEATHER_API_KEY"))
res, err := http.DefaultClient.Do(req)
if err != nil {
log.Fatal(err)
}
defer res.Body.Close()
body, err := io.ReadAll(res.Body)
if err != nil {
log.Fatal(err)
}
if res.StatusCode < 200 || res.StatusCode > 299 {
log.Fatalf("%s %s", res.Status, body)
}
fmt.Println(string(body))
}Samples read your key from SMARTERWEATHER_API_KEY. Set it up in the Quickstart.
Climate and agriculture reference
Rendered live from the canonical OpenAPI document. This is the canonical reference for the climate and agriculture resource.
Paste a test key (sw_test_*) from your dashboard into Test Request. Test keys are never billed; their calls still count toward the key's rate limits and daily cap. Calls with your own live key count toward your plan.