Smarter Weather Developer Onboarding changelog

https://smarterweather.com/llms.txt

− > (app.smarterweather.com); iOS and Android are in beta. Forecast analysis− > a REST API, a hosted weather MCP, and an onboarding MCP that can sign− > you up, mint a key, and configure itself. Agents with wallets can also− > call the weather MCP keylessly via x402 (USDC on Base); discovery tools− > stay free.− Coverage: Smarter Weather covers the 50 US states and DC only. The US− territories (Puerto Rico, the US Virgin Islands, Guam, the Northern− Mariana Islands and American Samoa) and other countries are outside it.− Every route that takes a point (lat and lon, zip or location) returns− 404 outside-coverage for a point outside the 50 states and DC.− /v1/alerts and /v1/observations return it for a bounding box that− touches no US domain (CONUS, Alaska, Hawaii); a box that touches one may− still include area outside the US. /v1/weather/batch reports it per item− as outside_coverage, and /v1/point with points and /v1/series/batch mark− such points out_of_domain, as they do a point the check could not reach− in time (retry it). If the location lookup is unavailable, the check can− briefly fail open. Routes keyed by a station, radar site, forecast− office or alert id, and nationwide lists, are not filtered by point, so− do not treat an empty result as an all-clear. Do not retry an− outside-coverage response. See− [Errors](https://developers.smarterweather.com/errors#outside-coverage).− - [Products](https://smarterweather.com/products/): data plane, developers, weather agent, app, operations− - [Research](https://smarterweather.com/research/): forecast analysis and Weather Bench− - [Forecast analysis](https://smarterweather.com/accuracy): source-model skill against NOAA analysis−    trial `challenge_endpoint`: its `request_example` is the mint body; set−    A human can instead mint−    from https://developers.smarterweather.com/dashboard/api-keys.−    account and pay per call on the weather MCP via x402 (USDC on Base);− A trial key allows 300 calls over 72 hours, 10 requests a minute (burst 5) on routes under `/v1/weather`, `/v1/geocode`, and `/v1/alerts`; `/v1/catalog` spends no trial call. A human can claim it within 7 days from the printed claim link to keep the same key on the Free plan (60 requests a minute, 1,000 a day, no card).− onboarding server once configured.− - [smarterweather-onboarding skill](https://developers.smarterweather.com/.well-known/skills/smarterweather-onboarding/SKILL.md): one-shot signup, key mint, weather-client config, then remove− - [Quickstart](https://developers.smarterweather.com/quickstart): three requests from zero to a live forecast call, then the MCP and dashboard paths− - [API reference](https://developers.smarterweather.com/api/reference): interactive reference rendered from the OpenAPI spec− - [Developer pricing](https://developers.smarterweather.com/pricing): tiers, quotas, and keyless (x402) pay-per-call− - [Error model](https://developers.smarterweather.com/errors): RFC 9457 problem details, the `next_steps` extension, and retry semantics− - [FAQ](https://developers.smarterweather.com/faq): plans, keys, rate limits, and billing+ > (app.smarterweather.com); iOS and Android are in beta. Forecast accuracy+ > a REST API, the hosted Weather MCP, and the Onboarding MCP, which can+ > sign you up, create an API key, and set up the Weather MCP. Agents with+ > wallets can also call the Weather MCP without a key via x402 (USDC on+ > Base); discovery tools stay free.+ Coverage:+ <!-- generated:example coverage -->+ Smarter Weather covers the 50 US states and DC only. The US territories (Puerto Rico, the US Virgin Islands, Guam, the Northern Mariana Islands and American Samoa) and other countries are outside it. Every route that takes a point (lat and lon, zip or location) returns 404 outside-coverage for a point outside the 50 states and DC. /v1/alerts and /v1/observations return it for a bounding box that touches no US domain (CONUS, Alaska, Hawaii); a box that touches one may still include area outside t+ <!-- /generated -->+ See [Errors](https://developers.smarterweather.com/errors#outside-coverage).+ <!-- generated:example products -->+ - [Products](https://smarterweather.com/products/): the app, the weather agent (research preview, not available yet), and the developer platform+ <!-- /generated -->+ - [Research](https://smarterweather.com/research/): forecast accuracy and the Operational Weather Bench+ - [Forecast accuracy](https://smarterweather.com/accuracy): source-model skill against NOAA analysis+    trial `challenge_endpoint`: its `request_example` is the request body; set+    A human can instead create a key+    at https://developers.smarterweather.com/dashboard/api-keys.+    account and pay per call on the Weather MCP via x402 (USDC on Base);+ A trial key allows 300 requests over 72 hours, 10 a minute (burst 5); `/v1/catalog` requests don't count toward the 300. It works on routes under `/v1/weather`, `/v1/geocode`, and `/v1/alerts`. A human can claim it within 7 days from the printed claim link to keep the same key on the Free plan (60 requests a minute, 1,000 a day, no card).+ Onboarding MCP once the Weather MCP is set up.+ - [smarterweather-onboarding skill](https://developers.smarterweather.com/.well-known/skills/smarterweather-onboarding/SKILL.md): one-shot sign-up, API key creation, Weather MCP setup, then remove+ - [Quickstart](https://developers.smarterweather.com/quickstart): get an API key (dashboard, CLI, or trial), call /v1/weather, call it from your code, give your agent weather tools, and let an agent get its own key+ - [Presets](https://developers.smarterweather.com/api/presets): each preset's questions, its Weather MCP tool (or `get_data`), its REST route, and its stability+ - [Full API reference](https://developers.smarterweather.com/api/reference): interactive reference rendered from the OpenAPI spec+ - [Developer pricing](https://developers.smarterweather.com/pricing): plans, rate limits, credits per call, and pay per call with x402+ - [Errors and rate limits](https://developers.smarterweather.com/errors): every error type, the `next_steps` extension, retry rules, and how rate limits work+ - [FAQ](https://developers.smarterweather.com/faq): keys, limits, pricing, and billing

https://smarterweather.com/llms.txt

− /v1/weather, /v1/windows and /v1/geocode/reverse return 404− outside-coverage for a point outside the 50 states and DC, and− /v1/weather/batch reports it per item as outside_coverage; /v1/point and− /v1/series return the same 404 only for points outside the US model− grids. Other routes may return empty results for points outside− coverage, so do not treat an empty result as an all-clear. Do not retry− an outside-coverage response. See− - [Blog](https://smarterweather.com/blog/): notes from the team− Agents: start here. There is nothing to install. Call the API; the− 1. `curl -sS 'https://api.smarterweather.com/v1/weather?lat=41.66&lon=-91.53'`−    `accept_terms` to true only after reading its `terms_url`.−    account and pay per call on the weather MCP via x402 (USDC on Base).−    401/403/429 bodies always say what to do next.+ Every route that takes a point (lat and lon, zip or location) returns+ 404 outside-coverage for a point outside the 50 states and DC.+ /v1/alerts and /v1/observations return it for a bounding box that+ touches no US domain (CONUS, Alaska, Hawaii); a box that touches one may+ still include area outside the US. /v1/weather/batch reports it per item+ as outside_coverage, and /v1/point with points and /v1/series/batch mark+ such points out_of_domain, as they do a point the check could not reach+ in time (retry it). If the location lookup is unavailable, the check can+ briefly fail open. Routes keyed by a station, radar site, forecast+ office or alert id, and nationwide lists, are not filtered by point, so+ do not treat an empty result as an all-clear. Do not retry an+ outside-coverage response. See+ Agents: start here. Nothing to install for REST (the `npx` steps below+ are optional key helpers and the MCP bridge). Call the API; the+ 1. `curl -sS 'https://api.smarterweather.com/v1/weather?lat=42.3601&lon=-71.0589'`+    `accept_terms` to true only after reading its `terms_url`. Trial+    terms are below.+    account and pay per call on the weather MCP via x402 (USDC on Base);+    x402 is MCP-only, REST always needs a key.+    401/403/429 bodies always say what to do next. Honor each response's+    `Cache-Control` max-age instead of calling again.+ Trial key terms:+ <!-- generated:example trial-terms -->+ A trial key allows 300 calls over 72 hours, 10 requests a minute (burst 5) on routes under `/v1/weather`, `/v1/geocode`, and `/v1/alerts`; `/v1/catalog` spends no trial call. A human can claim it within 7 days from the printed claim link to keep the same key on the Free plan (60 requests a minute, 1,000 a day, no card).+ <!-- /generated -->+ The Free plan is for evaluation, prototyping, and low-volume non-commercial use; commercial use needs a paid plan.+ - [Build a weather app](https://developers.smarterweather.com/build-a-weather-app): call the API from your own backend, the recommended query, caching, times, icons, attribution, and the /v1/weather field reference+ - [Guides](https://developers.smarterweather.com/guides): five how-tos, each one call, built from the playground's questions+ - [Rain arrival](https://developers.smarterweather.com/guides/rain-arrival): when rain reaches a site, from the radar nowcast and the hourly chance+ - [Alerts at a site](https://developers.smarterweather.com/guides/alerts-at-a-site): every active NWS alert at one point+ - [US warnings](https://developers.smarterweather.com/guides/us-warnings): the alerts in effect across the lower 48 from one bounding box+ - [ZIP to coordinates](https://developers.smarterweather.com/guides/zip-to-coordinates): a 5-digit ZIP to a place and its latitude and longitude+ - [Gust limits](https://developers.smarterweather.com/guides/gust-limits): hours where gusts top a lift limit, with the spread+ - [Authentication](https://developers.smarterweather.com/authentication): Bearer keys, keyless routes, trial keys, scopes+ - [FAQ](https://developers.smarterweather.com/faq): plans, keys, rate limits, and billing

https://raw.githubusercontent.com/smarterweather/developer/HEAD/AGENTS.md

− | Weather MCP | `https://mcp.smarterweather.com` | OAuth 2.1 + PKCE, or API key Bearer |+ | Weather MCP | `https://mcp.smarterweather.com` | API key Bearer; keyless: free discovery tools, x402 for the rest |+ - The weather MCP differs: keyless calls are not rejected. Discovery+   tools answer free; other `tools/call`s return in-band x402 payment+   requirements with `next_steps`. An invalid key gets HTTP `401` with+   a JSON-RPC error carrying `next_steps` and no `WWW-Authenticate`.+   OAuth sign-in for generic clients is not available yet (no dynamic+   client registration); use an API key.

description

Agent-first onboarding to Smarter Weather: plans, docs, signup, API keys, MCP config, billing. → Onboard to Smarter Weather from your agent: plans, docs, sign-up, API keys, MCP config, billing.

version

0.0.3 → 0.2.1

https://smarterweather.com/llms.txt

−    `trial.command` fields name those one-liners. A human can instead mint+ Coverage: Smarter Weather covers the 50 US states and DC only. The US+ territories (Puerto Rico, the US Virgin Islands, Guam, the Northern+ Mariana Islands and American Samoa) and other countries are outside it.+ /v1/weather, /v1/windows and /v1/geocode/reverse return 404+ outside-coverage for a point outside the 50 states and DC, and+ /v1/weather/batch reports it per item as outside_coverage; /v1/point and+ /v1/series return the same 404 only for points outside the US model+ grids. Other routes may return empty results for points outside+ coverage, so do not treat an empty result as an all-clear. Do not retry+ an outside-coverage response. See+ [Errors](https://developers.smarterweather.com/errors#outside-coverage).+    `trial.command` fields name those one-liners. Without Node, GET the+    trial `challenge_endpoint`: its `request_example` is the mint body; set+    `accept_terms` to true only after reading its `terms_url`.+    A human can instead mint