# AgentToll Weather Alerts

> AgentToll Weather Alerts is a paid API for AI agents from agenttoll.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Retrieves active NWS weather alerts for a specified US state or forecast zone

## Facts

- Endpoint: POST https://agenttoll.dev/paid/env/weather-alerts
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenttoll-weather-alerts-567307ac
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hdRi_tDLVX8-5DaJjJOrK

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 agenttoll-weather-alerts-567307ac -d '<json body>'
```

Example prompt: Are there any active weather alerts or warnings right now for California, or specifically for zone CAZ006?

## When to prefer this

Use this endpoint when you need real-time or near-real-time NWS weather alert data for a specific US state or forecast zone, especially in agent workflows requiring emergency situational awareness, travel safety checks, or environmental monitoring. Prefer this over generic weather APIs when you specifically need official NWS alert and warning data (watches, warnings, advisories) rather than forecast or current conditions data. Best suited for pay-per-call agent workflows using the x402 protocol on Base.

## Known failure modes

- Invalid or unrecognized state code returns empty results or error
- Invalid zone identifier returns no matching alerts
- No active alerts returns an empty data array with count 0
- Payment failure via x402 protocol blocks the request
- Upstream NWS API outage may cause stale or unavailable data
- Malformed request body returns a validation error

## How this service works

108+ receipt-backed x402 work products for AI agents. Clear prices, spend caps, buyer metadata, and structured results over Base USDC.

## Output

Returns a JSON object containing an array or object of active NWS weather alerts matching the query (by state or zone), along with metadata including the total alert count, the data source, and a generation timestamp. Also indicates whether the response was served from cache.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "zone": {
   "type": "string"
  },
  "state": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "oneOf": [
    {
     "type": "array"
    },
    {
     "type": "object"
    }
   ]
  },
  "meta": {
   "type": "object",
   "properties": {
    "count": {
     "type": "integer"
    },
    "source": {
     "type": "string"
    },
    "generated_at": {
     "type": "string",
     "format": "date-time"
    }
   }
  },
  "cached": {
   "type": "boolean"
  },
  "success": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agenttoll-weather-alerts-567307ac/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agenttoll.dev](https://www.zero.xyz/host/agenttoll.dev/llms.txt)