# Tollkit Data – US Weather Forecast

> Tollkit Data – US Weather Forecast is a paid API for AI agents from extract.tollkit.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-10).

Returns the National Weather Service 7-day forecast (temperature, rain chance, wind, summary) and active weather alerts for a given US latitude/longitude.

## Facts

- Endpoint: POST https://extract.tollkit.dev/weather?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tollkit-data-us-weather-forecast-abb9f1e2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wRgWTPQ_cGiwVIaWBp-5I

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tollkit-data-us-weather-forecast-abb9f1e2 -d '<json body>'
```

Example prompt: What's the NWS 7-day weather forecast for coordinates 38.98°N, 76.49°W — give me temperature, rain chance, and wind for each day and night period, and flag any active weather alerts for that spot.

## When to prefer this

Choose this endpoint when you need official US government (NWS/NOAA) weather forecasts for a precise geographic coordinate, including active weather alerts, at very low cost per call. Prefer it over general weather APIs when NWS authority and alert data are important, or when you need granular day/night period breakdowns. Note it is strictly limited to locations within NWS coverage (United States and territories).

## Known failure modes

- Coordinates outside the United States or NWS coverage area — returns an error, no charge applied
- Invalid latitude or longitude values (out of range or wrong type) — validation error
- NWS API upstream unavailability — temporary service error
- Periods parameter out of range (below 1 or above 14) — validation error

## How this service works

US weather: give a latitude and longitude, get the National Weather Service forecast for the next 7 days (day and night periods: temperature, rain chance, wind, summary) and any active weather alerts for that spot. United States only. $0.003 per call; a location outside NWS coverage is not charged.

## Output

An array of up to 14 consecutive 12-hour forecast periods (day/night alternating), each containing: period name, temperature, precipitation chance, wind speed and direction, and a short text summary. Also returns any currently active NWS weather alerts (e.g. tornado warnings, winter storm watches) for the queried location. Locations outside NWS coverage return an appropriate error and are not charged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lat": {
   "type": "number",
   "description": "Latitude, e.g. 38.98"
  },
  "lon": {
   "type": "number",
   "description": "Longitude, e.g. -76.49"
  },
  "address": {
   "type": "string",
   "maxLength": 200,
   "description": "US street address instead of lat/lon, e.g. \"1600 Pennsylvania Ave NW, Washington, DC 20500\"."
  },
  "periods": {
   "type": "integer",
   "default": 14,
   "maximum": 14,
   "minimum": 1,
   "description": "How many 12-hour periods to return."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tollkit-data-us-weather-forecast-abb9f1e2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from extract.tollkit.dev](https://www.zero.xyz/host/extract.tollkit.dev/llms.txt)
