# ForgeMesh US Weather Alerts API

> ForgeMesh US Weather Alerts API is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns all active NWS weather warnings, watches, and advisories for a given US state as normalized JSON, including event type, severity, urgency, affected zones, and full alert text.

## Facts

- Endpoint: POST https://x402.forgemesh.io/weather-alerts
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-us-weather-alerts-api-49bae909
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7-A4YNGoaU09_SS1ohsXU

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 forgemesh-us-weather-alerts-api-49bae909 -d '<json body>'
```

Example prompt: Pull all active weather alerts for Texas right now — I need the event type, severity, and which zones are affected so I can decide whether to delay our delivery routes.

## When to prefer this

Use this endpoint when you need a normalized, ready-to-parse JSON view of all active NWS weather alerts for a specific US state, rather than scraping the raw NWS API or ATOM/CAP feeds yourself. Ideal for logistics routing agents, event safety checks, or any workflow needing structured alert data without parsing XML. Best for US-only use cases; does not cover international weather alerts.

## Known failure modes

- Invalid or non-US state code returns an error or empty result
- No active alerts returns an empty array (not an error)
- NWS upstream data temporarily unavailable may return stale cached data up to 5 minutes old
- Non-US locations are not supported and will return no results
- Payment failure (insufficient USDC) returns a 402 error

## How this service works

US weather alerts API: all active weather warnings, watches, and advisories for any US state — event type, severity, urgency, affected zones, and full alert text as normalized JSON. US COVERAGE ONLY. Use for logistics, event planning, and safety agents. Public-domain government data; cached 5 minutes.

## Output

A normalized JSON array of all currently active NWS weather alerts for the requested state, each containing event type (e.g. Tornado Warning, Flood Watch), severity classification, urgency, affected zone IDs, and the full official alert text. Data is cached up to 5 minutes from NWS public-domain feeds.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "state": {
   "type": "string",
   "description": "Two-letter US state code, e.g. TX"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "features": [
    {
     "properties": {
      "event": "Heat Advisory",
      "severity": "Minor"
     }
    }
   ]
  },
  "attribution": "US National Weather Service (public domain)"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-us-weather-alerts-api-49bae909/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)