# AgentWeather API
> Token-efficient weather for AI agents. Pay-per-request via MPP.

## Endpoints
GET /v1/weather?location={city}
GET /v1/weather?lat={lat}&lon={lon}

## Query Parameters
- location: City name (e.g., "Brooklyn", "London, UK")
- lat, lon: Coordinates (use together)
- include: Comma-separated list: "hourly", "airquality"
- start, end: Date range for historical data (YYYY-MM-DD, max 365 days)
- format: "csv" for CSV output (default: JSON)

## Pricing
- $0.001: Current conditions + 3-day forecast (any include combo)
- $0.005: Historical data (<=31 days)
- $0.01: Historical data (<=365 days)

## Payment
Protocol: MPP (Machine-Payable Protocol)
Flow: Request -> 402 Payment Required -> Pay -> 200 OK

## Response
Compact JSON with summary + tips. Dual units (metric + imperial).
Includes: location, current conditions, 3-day forecast, summary, tips.
Optional: hourly forecast, air quality, historical daily.

## OpenAPI
https://api.agentweather.dev/openapi.json