Docs navigation
Reference
Weather MCP
Agents
Observations and soundings
Smarter Weather covers the 50 US states and DC only. Coverage details
Surface observations and upper-air soundings sampled at a point or at the nearest station. METAR collections come back as GeoJSON; nearest and sounding lookups return the station that actually reported.
Reach for these when a scheduling or aviation integration needs what was measured, not what is forecast — a METAR sky layer for a canvas, a sounding for a briefing, or the closest station to a field site.
GET /v1/lightning returns recent lightning near a point: the GOES GLM flash count plus MRMS lightning density and probability. It is experimental, and a zero flash count is not yet a guaranteed all-clear. See the reference below or the full API reference.
curl "https://api.smarterweather.com/v1/observations/nearest?lat=42.3601&lon=-71.0589&n=3" \
-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/observations/nearest?lat=42.3601&lon=-71.0589&n=3",
{ 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/observations/nearest",
params={"lat":"42.3601","lon":"-71.0589","n":"3"},
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/observations/nearest?lat=42.3601&lon=-71.0589&n=3", 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.
Observations and soundings reference
Rendered live from the canonical OpenAPI document. This is the canonical reference for the observations and soundings 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.