# Tanod Sky

> Aviation and space: METAR/TAF, airports, space weather, aurora, asteroids, satellite passes, images. 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 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 13 routes.
- [x402 resources](https://sky.tanod.dev/.well-known/x402)
- MCP: `https://tanod.dev/mcp/sky` (server `tanod-sky`)

## Routes

- `POST https://sky.tanod.dev/v1/weather` (get_weather_forecast): Get the weather forecast for a city: hourly weather for a city or coordinates (weatherpeek) Use when an agent needs an hourly weather forecast for a city or coordinates.
- `POST https://sky.tanod.dev/v1/geocode` (geocode_city): Geocode a city: get its coordinates, or reverse geocode coordinates, offline (utilpeek) 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): Get current METAR airport weather reports (up to 20 airports) (skypeek) 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): Decode a METAR or TAF weather report (skypeek) 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): Get current TAF airport weather forecasts (up to 20 airports) (skypeek) Use when an agent needs the terminal aerodrome forecast (TAF) for 1-20 airports.
- `POST https://sky.tanod.dev/v1/aviation/airport` (lookup_airport): Look up an airport by ICAO or IATA code or by name (skypeek) 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): Calculate the great-circle distance between two airports or points (skypeek) 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): Get space weather: Kp index, forecast, solar wind, alerts (skypeek) 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): Aurora forecast: the chance of visible aurora at a location in the next 30-90 minutes (skypeek) 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): List asteroid and comet close approaches to Earth (skypeek) Use when an agent needs upcoming asteroid close approaches to Earth.
- `POST https://sky.tanod.dev/v1/space/sun-moon` (sunrise_sunset_moon_times): Get sunrise, sunset, twilight, moonrise and moon phase for a place and date (skypeek) 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): Predict satellite passes over a location (ISS and others) (skypeek) 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): Get a recent satellite image of a location, place or coordinates: true color, NDVI, NDWI (skypeek) Use when an agent needs a recent satellite picture of a place or coordinates, or its NDVI or NDWI view.