{
  "format": "delx/intent-card/v1",
  "id": "us-weather-forecast-api",
  "intent": "get a weather forecast for a US location",
  "title": "US weather forecast API for agents",
  "description": "Return normalized forecast periods for US coordinates for $0.001 through the public National Weather Service API, with coordinate-only input and explicit US coverage.",
  "keywords": [
    "weather forecast API",
    "US weather API",
    "National Weather Service API",
    "NOAA forecast",
    "agent weather data",
    "x402 weather"
  ],
  "updated_at": "2026-08-01",
  "canonical_url": "https://commerce.delx.ai/intents/us-weather-forecast-api",
  "machine_url": "https://commerce.delx.ai/intents/us-weather-forecast-api.json",
  "recommendation": {
    "tool_name": "get_weather_forecast_nws",
    "service_name": "Delx NWS Weather Forecast",
    "method": "POST",
    "resource": "https://api.delx.ai/api/v1/x402/weather-forecast",
    "price_usdc": "0.001",
    "payment_protocols": [
      "x402",
      "mpp"
    ],
    "input_schema": {
      "type": "object",
      "properties": {
        "latitude": {
          "type": "number",
          "minimum": -90,
          "maximum": 90,
          "description": "Latitude in decimal degrees; NWS coverage is limited to the United States."
        },
        "longitude": {
          "type": "number",
          "minimum": -180,
          "maximum": 180,
          "description": "Longitude in decimal degrees; NWS coverage is limited to the United States."
        },
        "periods": {
          "type": "integer",
          "minimum": 1,
          "maximum": 10,
          "default": 5,
          "description": "Number of forecast periods to return."
        },
        "timeout": {
          "type": "integer",
          "minimum": 2,
          "maximum": 8,
          "default": 8,
          "description": "Upstream timeout in seconds."
        }
      },
      "required": [
        "latitude",
        "longitude"
      ],
      "additionalProperties": false
    },
    "example_input": {
      "latitude": 38.9072,
      "longitude": -77.0369,
      "periods": 2
    },
    "example_output": {
      "tool_name": "get_weather_forecast_nws",
      "result": {
        "schema": "delx/weather-forecast/v1",
        "coverage": "US",
        "coordinates": {
          "latitude": 38.9072,
          "longitude": -77.0369
        },
        "periods_requested": 2,
        "periods_returned": 2,
        "periods": [
          {
            "number": 1,
            "name": "Today",
            "startTime": "2026-08-01T12:00:00-04:00",
            "endTime": "2026-08-01T18:00:00-04:00",
            "isDaytime": true,
            "temperature": 87,
            "temperatureUnit": "F",
            "shortForecast": "Mostly Sunny"
          },
          {
            "number": 2,
            "name": "Tonight",
            "startTime": "2026-08-01T18:00:00-04:00",
            "endTime": "2026-08-02T06:00:00-04:00",
            "isDaytime": false,
            "temperature": 70,
            "temperatureUnit": "F",
            "shortForecast": "Mostly Clear"
          }
        ],
        "provider": "National Weather Service (NOAA)",
        "provider_url": "https://www.weather.gov/",
        "forecast_url": "https://api.weather.gov/gridpoints/LWX/96,70/forecast",
        "attribution": "Forecast data supplied by the National Weather Service; see provider_url for source and coverage.",
        "cache": "miss"
      }
    },
    "agentcash": {
      "buy": "npx agentcash@latest fetch https://api.delx.ai/api/v1/x402/weather-forecast -m POST -H 'x-delx-source: intent-card-us-weather-forecast-api' --max-amount 0.001 -b '{\"latitude\":38.9072,\"longitude\":-77.0369,\"periods\":2}'",
      "max_amount_usdc": "0.001"
    }
  },
  "attribution": {
    "header": "x-delx-source",
    "value": "intent-card-us-weather-forecast-api"
  },
  "evidence": {
    "paid_openapi": "https://api.delx.ai/openapi.x402.json",
    "governed_portfolio": "https://api.delx.ai/x402-portfolio.json",
    "live_contract": "https://api.delx.ai/api/v1/x402/weather-forecast"
  }
}