Docs navigation
Reference
Weather MCP
Agents
Forecaster guidance
Smarter Weather covers the 50 US states and DC only. Coverage details
Forecaster guidance products as GeoJSON overlays — SPC mesoscale discussions and WPC precipitation discussions. Structured fields and bulletin text live on each feature's properties.
A map or briefing tool uses this when it needs the polygons and language a human forecaster already wrote, not a model grid. The weather endpoint can also return a distilled include=guidance block at a point.
For the full bulletin text, GET /v1/text-products lists the newest NWS text products of one type (for example AFD or HWO) for a point, a forecast office, or the nation. See the reference below or the full API reference.
curl "https://api.smarterweather.com/v1/guidance/mesoscale" \
-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/guidance/mesoscale",
{ 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/guidance/mesoscale",
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/guidance/mesoscale", 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.
Forecaster guidance reference
Rendered live from the canonical OpenAPI document. This is the canonical reference for the forecaster guidance 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.