# AgentToll Weather Forecast

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

Returns a weather forecast for a given geographic coordinate (latitude/longitude) via a pay-per-call x402 API.

## Facts

- Endpoint: POST https://agenttoll.dev/paid/env/weather-forecast
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenttoll-weather-forecast-fedddcc8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nA68bOa5sFOlC4zI7Z4fg

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-forecast-fedddcc8 -d '<json body>'
```

Example prompt: What's the weather forecast for the coordinates 37.7749° N, 122.4194° W — that's San Francisco?

## When to prefer this

Choose this endpoint when you need programmatic, pay-per-call weather forecast data keyed by precise geographic coordinates (lat/lon) without a subscription or API key setup. It is ideal for AI agents that need occasional weather lookups billed in USDC on Base via the x402 protocol, especially within a broader agenttoll.dev MCP tool workflow. Prefer this over subscription-based weather APIs when usage is sporadic or you need to avoid API key management overhead.

## Known failure modes

- Invalid or out-of-range latitude/longitude values may return an error or empty result
- Missing required lat or lon parameters will cause a validation error
- Payment failure or insufficient USDC balance will result in a 402 Payment Required response
- Coordinates in remote or ocean areas may return limited or no forecast data
- Network timeouts from the upstream weather data provider

## 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

A weather forecast object for the specified latitude/longitude coordinate, likely including current or upcoming conditions such as temperature, precipitation, wind speed, humidity, and sky conditions. The response schema is a generic object, so the exact fields may vary but represent standard meteorological forecast data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lat": {
   "type": "number",
   "description": "number latitude"
  },
  "lon": {
   "type": "number",
   "description": "number longitude"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agenttoll-weather-forecast-fedddcc8/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)