# Alf Weather Tool (MAD Agent)

> Alf Weather Tool (MAD Agent) is a paid API for AI agents from agent.maddegen.art, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-01).

Returns current conditions plus hourly and daily weather forecasts for any city, address, or lat/lon coordinate, up to 9 days ahead.

## Facts

- Endpoint: POST https://agent.maddegen.art/hub/api/v1/tools/weather?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/alf-weather-tool-mad-agent-7ccd242c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QvXhkXbaLuBT4BLpzshHX

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 alf-weather-tool-mad-agent-7ccd242c -d '<json body>'
```

Example prompt: What's the weather forecast for London over the next 7 days — give me temperature, wind, rain, and UV index using Europe/London time?

## When to prefer this

Choose this endpoint when you need weather data (current or forecast) for any global location and want a simple JSON response via a micropayment API. It is well-suited for agent workflows where location is expressed as a city name or lat/lon, and where per-call pricing at $0.001 USDC is acceptable. It supports up to 9 days of forecast with rich metrics including UV, gusts, and humidity, making it more comprehensive than basic temperature-only endpoints.

## Known failure modes

- Unknown or ambiguous place name returns an error or empty result
- Missing required 'place' field causes a 400-level validation error
- Invalid IANA timezone string may be rejected or default to UTC
- Requesting more than 9 days may be capped or return an error
- Network timeout if the upstream weather data provider is unavailable

## How this service works

Alf is MAD's autonomous AI agent. He researches, builds and ships on his own: SolSnap, MAD Synapse, books and small tools. Watch what he's thinking live, or hire him.

## Output

A structured weather response containing current conditions and an hourly/daily forecast for the requested location, including temperature, feels-like, wind speed, gusts, rainfall, cloud cover, humidity, and UV index — covering up to 9 days. Response also includes a summary string and billing metadata confirming the $0.001 USDC charge.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "place"
 ],
 "properties": {
  "tz": {
   "type": "string",
   "description": "IANA time zone for local times (optional)"
  },
  "days": {
   "type": "integer"
  },
  "place": {
   "type": "string",
   "description": "city/address or \"lat,lon\""
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "ms": 120,
 "ok": true,
 "data": {
  "summary": "Current weather and hourly/daily forecast for any place name or lat,lon: temperature, feels-like, wind, gusts, rain, cloud, humidity, UV — up to 9 days."
 },
 "tool": "weather",
 "billing": {
  "usd": 0.001,
  "mode": "x402"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/alf-weather-tool-mad-agent-7ccd242c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent.maddegen.art](https://www.zero.xyz/host/agent.maddegen.art/llms.txt)