# Smarter Weather > We connect live weather to what a person or a business cares about and > advise before they ask. The public app is free on the web > (app.smarterweather.com); iOS and Android are in beta. Forecast accuracy > is published on this site. The developer platform is built for agents: > 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: 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 lists that cover the whole country, are not filtered by point, so do not treat an empty result as an all-clear. Do not retry a response with type `outside-coverage`. See [Errors](https://developers.smarterweather.com/errors#outside-coverage). ## This site - [Home](https://smarterweather.com/): Know what to do about the weather - [Products](https://smarterweather.com/products/): the app, the weather agent (research preview, not available yet), and the developer platform - [Research](https://smarterweather.com/research/): forecast accuracy and the Operational Weather Bench - [Forecast accuracy](https://smarterweather.com/accuracy): source-model skill against NOAA analysis - [Accuracy methodology](https://smarterweather.com/accuracy/methodology): how the scores are calculated - [Public app](https://app.smarterweather.com/): live conditions, radar, hourly, and the week ahead - [About](https://smarterweather.com/about/): the company - [Changelog](https://smarterweather.com/changelog/): what shipped - [Contact](https://smarterweather.com/contact/): operations, agents, or a security report - [Security contact](https://smarterweather.com/.well-known/security.txt): RFC 9116 vulnerability reporting ## For agents Agents: start here. Nothing to install for REST (the `npx` steps below are optional key helpers and the MCP bridge). Call the API; the response tells you the next step. 1. `curl -sS 'https://api.smarterweather.com/v1/weather?lat=42.3601&lon=-71.0589'` with no key returns `401 application/problem+json` whose `next_steps` member carries the links you need (`recommended` names the one to take first) plus an RFC 6750 `WWW-Authenticate: Bearer` challenge. 2. Get a key. Human present: run `npx -y @smarterweather/mcp-onboarding@latest login` (device grant; writes `.env`, prints only a prefix). No human: `npx -y @smarterweather/mcp-onboarding@latest trial` (or stdio `start_trial`). The 401 `next_steps.device_flow.command` / `trial.command` fields name those one-liners. Without Node, GET the trial `challenge_endpoint`: its `request_example` is the request body; set `accept_terms` to true only after reading its `terms_url`. Trial terms are below. A human can instead create a key at https://developers.smarterweather.com/dashboard/api-keys. If the client speaks MCP, connect anonymously to https://mcp.developers.smarterweather.com; after OAuth the stdio bridge sinks `create_api_key` into `.env`. Agents with a wallet can skip the account and pay per call on the Weather MCP via x402 (USDC on Base); x402 is MCP-only, REST always needs a key. 3. Repeat the call with `Authorization: Bearer $SMARTERWEATHER_API_KEY` (from `.env`). One metered allowance spans REST and MCP; the 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: 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). The Free plan is for evaluation, prototyping, and low-volume non-commercial use; commercial use needs a paid plan. Key handling (do this every time): keep the key only in `.env` as `SMARTERWEATHER_API_KEY=...` (mode 0600, gitignored); read `process.env` / `os.environ` in code; never echo the key into chat, logs, or a commit. `Authorization: Bearer` is the only accepted header (`X-API-Key` is rejected). Prefer `sw_test_*` keys in CI. MCP clients: Cursor should use the stdio bridge with `envFile: "${workspaceFolder}/.env"` (or let `@smarterweather/mcp-weather` fall back to `cwd/.env`). Prefer `npx -y @smarterweather/mcp-onboarding` over native `cursor://` OAuth (unreliable with Clerk). Remove the Onboarding MCP once the Weather MCP is set up. The human-facing walkthrough is [Built for agents](https://developers.smarterweather.com/agents). ## Machine-readable contracts - [Full documentation](https://developers.smarterweather.com/llms-full.txt): every doc below inlined in one file, for single-fetch ingestion - [API catalog](https://developers.smarterweather.com/.well-known/api-catalog): RFC 9727 linkset for the REST API and both MCP servers - [OpenAPI specification](https://developers.smarterweather.com/openapi.yaml): full machine-readable contract for api.smarterweather.com - [Weather MCP tool descriptors](https://developers.smarterweather.com/.well-known/mcp-tools.json): the live tool catalog for mcp.smarterweather.com (`toolCount` in the file; do not hardcode it) - [Agent Skills index](https://developers.smarterweather.com/.well-known/skills/index.json): installable SKILL.md skills for this platform - [smarterweather-api skill](https://developers.smarterweather.com/.well-known/skills/smarterweather-api/SKILL.md): REST integration guidance for agents - [smarterweather-mcp skill](https://developers.smarterweather.com/.well-known/skills/smarterweather-mcp/SKILL.md): MCP install, onboarding flow, x402 keyless access - [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 ## Docs - [Built for agents](https://developers.smarterweather.com/agents): one-click MCP installs, onboarding flow, agentic payments - [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 - [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 - [REST API guide](https://developers.smarterweather.com/api): auth, endpoints, rate-limit headers - [Full API reference](https://developers.smarterweather.com/api/reference): interactive reference rendered from the OpenAPI spec - [Authentication](https://developers.smarterweather.com/authentication): Bearer keys, keyless routes, trial keys, scopes - [Weather MCP server guide](https://developers.smarterweather.com/mcp-server): hosted endpoint, tool catalog, stdio bridge (@smarterweather/mcp-weather) - [MCP setup guide](https://developers.smarterweather.com/mcp-server/setup): client configuration for Cursor, Claude Code, VS Code, and others - [MCP tool reference](https://developers.smarterweather.com/mcp-server/tools): per-tool inputs and outputs - [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 ## Optional - [Public developer repo](https://github.com/smarterweather/developer): mirrored contracts, guides, and issue templates - [Developer terms](https://developers.smarterweather.com/legal/terms) - [Acceptable use](https://developers.smarterweather.com/legal/acceptable-use)