# Aviation & Space Weather Data (Tanod)

> Flight and sky conditions for agents, from METAR/TAF and airports to aurora and satellite passes. A focused part of Tanod (https://tanod.dev/llms.txt covers every family), over HTTP and MCP.
>
> Pay per call in USDC on Base or Polygon or Solana or BNB Chain or Arbitrum with x402, or on Tempo with MPP; no account or API key. Free tier: a small daily per-IP
> pool per family; over HTTP add the header `X-Tanod-Free: 1` to an unpaid call (without it every unpaid call gets the 402); over MCP
> the free tier is automatic.
> Every result is automated and heuristic, not an audit: findings can be false positives, and a clean result is not proof that code or a package is free of risk.
> Tanod is operated by an autonomous AI agent on behalf of its owner. Scans run automatically; no person reviews individual results.

## API

- [OpenAPI spec](https://sky.tanod.dev/openapi.json): machine-readable description of this family's 15 routes.
- [x402 resources](https://sky.tanod.dev/.well-known/x402)
- MCP: `https://tanod.dev/mcp/sky` (server `tanod-sky`); also at `https://sky.tanod.dev/mcp` on this host

## Routes

- `POST https://sky.tanod.dev/v1/weather` (get_weather_forecast): Use when an agent needs an hourly weather forecast for a city or coordinates.
- `POST https://sky.tanod.dev/v1/geocode` (geocode_city): Use when an agent must turn a city name into coordinates, or coordinates into the nearest city.
- `POST https://sky.tanod.dev/v1/aviation/metar` (get_metar_airport_weather): Use when an agent needs the current METAR weather observation for 1-20 airports.
- `POST https://sky.tanod.dev/v1/aviation/metar/decode` (decode_metar_taf_report): Use when an agent holds a raw METAR or TAF string and needs it decoded into fields.
- `POST https://sky.tanod.dev/v1/aviation/taf` (get_taf_airport_forecast): Use when an agent needs the terminal aerodrome forecast (TAF) for 1-20 airports.
- `POST https://sky.tanod.dev/v1/aviation/airport` (lookup_airport): Use when an agent needs an airport's codes, location, elevation or runways from an ICAO or IATA code.
- `POST https://sky.tanod.dev/v1/aviation/distance` (airport_great_circle_distance): Use when an agent needs the great-circle distance between two airports or coordinates.
- `POST https://sky.tanod.dev/v1/space/weather` (get_space_weather_kp_index): Use when an agent needs the current geomagnetic Kp index, solar wind data or space weather alerts.
- `POST https://sky.tanod.dev/v1/space/aurora` (aurora_forecast): Use when an agent needs the aurora probability at a given latitude and longitude right now.
- `POST https://sky.tanod.dev/v1/space/asteroids` (asteroid_close_approaches): Use when an agent needs upcoming asteroid close approaches to Earth.
- `POST https://sky.tanod.dev/v1/space/sun-moon` (sunrise_sunset_moon_times): Use when an agent needs sunrise, sunset, twilight times or moon phase for a place and date.
- `POST https://sky.tanod.dev/v1/space/passes` (predict_iss_satellite_passes): Use when an agent needs when a satellite will pass over a given location.
- `POST https://sky.tanod.dev/v1/geo/satellite-image` (get_satellite_image_imagery_place_location_ndvi): Use when an agent needs a recent satellite picture of a place or coordinates, or its NDVI or NDWI view.
- `POST https://sky.tanod.dev/v1/sky/airport-delays` (get_airport_delays): Use when an agent needs live US airport delays, FAA ground stops, ground delay programs or closures.
- `POST https://sky.tanod.dev/v1/places/nearby` (find_places_nearby_osm): Use when an agent must find the nearest pharmacy, cafe, ATM, shop or hospital to a point, with hours and phone.