# AgentBodega US Weather Forecast

> AgentBodega US Weather Forecast is a paid API for AI agents from agentbodega.store, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns current conditions, hourly forecasts, multi-day forecasts, and weather alerts for any US location via coordinates, ZIP, or city name.

## Facts

- Endpoint: POST https://agentbodega.store/api/public-data/us-weather-forecast
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentbodega-us-weather-forecast-e30b5d30
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DXAMFlJXvL70AMU2cYC30

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 agentbodega-us-weather-forecast-e30b5d30 -d '<json body>'
```

Example prompt: What's the weather looking like in Boulder, CO right now? Include current conditions, tonight's forecast, and the next 12 hours of hourly data — and flag any active weather alerts.

## When to prefer this

Choose this endpoint when you need structured US weather data (current conditions, hourly, multi-day, alerts) in a single call without managing NOAA API keys or geocoding yourself. It accepts flexible location inputs (lat/lon, ZIP, city+state, or free-text) making it ideal for agent workflows where the location format may vary. At $0.005 USDC per call it suits occasional to moderate usage. Prefer a dedicated weather platform if you need international coverage or very high-volume polling.

## Known failure modes

- Location not resolvable — if the provided city/state/ZIP/coordinates cannot be geocoded to a US NWS grid, the response will indicate failure
- Non-US location — this endpoint only covers US territories served by NOAA/NWS; international coordinates will fail
- Ambiguous city name without state — may resolve to wrong location or fail
- NWS upstream outage — NOAA APIs occasionally have downtime causing empty or error responses
- Payment failure — x402 micropayment of $0.005 USDC must succeed before the request is processed

## How this service works

Small x402-payable utility APIs for agents: endpoint inspection, launch checks, and hosted artifacts.

## Output

A JSON object containing: NWS grid info (WFO, gridX, gridY), resolved location (lat/lon, timezone, city/state), current observation from the nearest station (temperature in °F, text description, station ID), an array of hourly forecast periods (start time, temperature, short forecast), a multi-day forecast array (period name, temperature, short forecast), and a weather alerts array. Success flag is included.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "body": {
     "fields": [
      {
       "name": "lat",
       "type": "number",
       "required": false
      },
      {
       "name": "lon",
       "type": "number",
       "required": false
      },
      {
       "name": "zip",
       "type": "string",
       "required": false
      },
      {
       "name": "city",
       "type": "string",
       "required": false
      },
      {
       "name": "state",
       "type": "string",
       "required": false
      },
      {
       "name": "location",
       "type": "string",
       "required": false
      },
      {
       "name": "includeCurrent",
       "type": "boolean",
       "required": false
      },
      {
       "name": "includeHourly",
       "type": "boolean",
       "required": false
      },
      {
       "name": "includeAlerts",
       "type": "boolean",
       "required": false
      },
      {
       "name": "includeOffice",
       "type": "boolean",
       "required": false
      },
      {
       "name": "hourlyLimit",
       "type": "integer",
       "required": false
      },
      {
       "name": "dailyLimit",
       "type": "integer",
       "required": false
      }
     ],
     "required": [],
     "fieldCount": 13,
     "contentType": "application/json",
     "optionalPreview": [
      "lat",
      "lon",
      "zip",
      "city",
      "state",
      "location",
      "includeCurrent",
      "includeHourly",
      "includeAlerts",
      "includeOffice",
      "hourlyLimit",
      "dailyLimit"
     ],
     "omittedFieldCount": 1
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object",
     "additionalProperties": true
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "grid": {
   "wfo": "BOU",
   "gridX": 54,
   "gridY": 74
  },
  "tool": {
   "id": "us-weather-forecast",
   "name": "US Weather Forecast",
   "department": "Public Data"
  },
  "alerts": [],
  "success": true,
  "location": {
   "lat": 40.015,
   "lon": -105.2705,
   "input": "Boulder, CO",
   "time_zone": "America/Denver",
   "relative_location": {
    "city": "Boulder",
    "state": "CO"
   }
  },
  "forecast_hourly": [
   {
    "start_time": "2026-07-03T18:00:00-06:00",
    "temperature": 72,
    "short_forecast": "Sunny",
    "temperature_unit": "F"
   }
  ],
  "forecast_multi_day": [
   {
    "name": "Tonight",
    "temperature": 54,
    "short_forecast": "Partly Cloudy",
    "temperature_unit": "F"
   }
  ],
  "current_observation": {
   "station_id": "KBDU",
   "temperature_f": 71.6,
   "text_description": "Mostly Cloudy"
  }
 }
}
```

## More

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