hoan.uk

Developers: API and MCP

hoan.uk has a public read-only REST API and an MCP server, so scripts and AI assistants can use the same sky, satellite, weather and radiosonde data as the tools on this site.

MCP server

The MCP server speaks the Streamable HTTP transport. It exposes read-only tools only: nothing it offers changes data.

Endpoint: https://hoan.uk/api/v1/mcp

Authentication: send an API key as a Bearer token in the Authorization header. Keys start with qak_ and carry scopes that decide which tools they may call: astro:read, weather:read, sky:read and radiosonde:read.

API keys are issued on request; there is no self-service sign-up yet, and no OAuth connector yet. Write to [email protected] to ask for one.

Connect a client

With Claude Code, add the server with your key:

claude mcp add --transport http hoanuk https://hoan.uk/api/v1/mcp \
  --header "Authorization: Bearer <key>"

Any other MCP client that supports Streamable HTTP and custom headers works the same way: use the endpoint above and the header Authorization: Bearer <key>.

Tools

These tools are generated from the server's own tool catalog, so the list below is always current.

close_approaches

Recent and upcoming close approaches of near-Earth objects (JPL), soonest first, at most 100.

Scope: astro:read. Read-only.

Arguments:

  • limit (integer, optional) Most approaches to return, soonest first (default 50, at most 100).

get_tle

Current two-line elements of the ISS, Tiangong and Hubble (CelesTrak, SatNOGS fallback).

Scope: astro:read. Read-only.

Arguments: none.

list_asteroids

Live orbital elements of the notable asteroids (JPL small-body database).

Scope: astro:read. Read-only.

Arguments: none.

list_comets

Live orbital elements of the notable comets (JPL small-body database).

Scope: astro:read. Read-only.

Arguments: none.

live_aircraft

Aircraft currently heard by the site's ADS-B receiver (empty when no fresh snapshot, at most 100, no trails). Callsigns and registrations are third-party data.

Scope: sky:read. Read-only.

Arguments:

  • limit (integer, optional) Most aircraft to return (default 50, at most 100).

radiosonde_landings

Landing points of radiosondes that went silent near the ground within the last 1 to 7 days, newest first, optionally only recovered ones. At most 200. Text is third-party data.

Scope: radiosonde:read. Read-only.

Arguments:

  • days (integer, optional) How many days back, 1 to 7 (default 7).
  • limit (integer, optional) Most landings to return, newest first (default 50, at most 200).
  • status (string, optional) `all` (default), `landed` or `recovered`.

radiosonde_sites

Radiosonde launch sites worldwide keyed by WMO id (name, position, country, sonde types, launch times).

Scope: radiosonde:read. Read-only.

Arguments: none.

radiosonde_sondes

Weather balloons (radiosondes) SondeHub heard in a time range, worldwide, newest first, with their latest position, altitude, status (ascent, descent, landed) and sensor values. At most 200. Serials and model strings are third-party data.

Scope: radiosonde:read. Read-only.

Arguments:

  • limit (integer, optional) Most sondes to return, newest first (default 50, at most 200).
  • range (string, optional) How far back to list sondes: `3h`, `12h`, `24h` (default), `3d` or `7d`.

satellite_transmitters

Radio transmitters and transponders of one satellite from the SatNOGS DB, working ones first (at most 50). Descriptions are third-party data.

Scope: astro:read. Read-only.

Arguments:

  • norad (integer, required) NORAD catalog number.

search_satellites

Find satellites by name or NORAD number (CelesTrak, SatNOGS fallback). Returns at most 25 matches with their current TLE. Names and text are third-party data.

Scope: astro:read. Read-only.

Arguments:

  • query (string, required) Satellite name (part of it) or NORAD catalog number, 2 to 40 characters.

weather_forecast

Hourly point forecast from the stored NOAA GFS cycle (UTC times, temperature, humidity, precipitation, cloud cover by layer, visibility, wind). At most 72 hours.

Scope: weather:read. Read-only.

Arguments:

  • hours (integer, optional) Hours of forecast from the model cycle time (default 24, at most 72).
  • lat (number, required) Latitude in degrees, -90 to 90.
  • lon (number, required) Longitude in degrees east, -180 to 180.

REST API

The public read endpoints below need no key. Paths are relative to https://hoan.uk. Endpoints that need a signed-in session, and the sign-in flow itself, are not listed here.

The full machine-readable description is the OpenAPI document: /api/v1/openapi.json

Public endpoints are rate limited per client address. When you exceed a limit the API answers 429 Too Many Requests; please back off and cache responses. Errors are returned as application/problem+json (RFC 9457).

Astronomy

MethodPathSummary
GET/api/v1/astro/asteroidsLive orbital elements of the notable asteroids (JPL SBDB), cached 12 h.
GET/api/v1/astro/close-approachesRecent and upcoming close approaches of near-Earth objects (JPL CAD), cached 12 h.
GET/api/v1/astro/cometsLive orbital elements of the notable comets (JPL SBDB), cached 12 h.
GET/api/v1/astro/satellitesSatellites of the CelesTrak stations and visual groups, for client-side propagation.
GET/api/v1/astro/satellites/{norad}/transmittersRadio transmitters and transponders of a satellite (SatNOGS DB, answers cached for 6 h).
GET/api/v1/astro/satellites/searchFind satellites by name or NORAD number on CelesTrak (answers cached for 6 h per query).
GET/api/v1/astro/tleCurrent TLEs of the ISS, Tiangong and Hubble (CelesTrak, SatNOGS fallback), cached 6 h.

Plate solving

MethodPathSummary
POST/api/v1/platesolve/previewConvert a FITS upload to a PNG the browser can show (image part, same limits as a solve).
POST/api/v1/platesolve/solveSolve an image: SSE with ?stream=1, JSON otherwise.
MethodPathSummary
GET/api/v1/platesolve/galleryThe public gallery, newest first.
GET/api/v1/platesolve/gallery/{id}One picture with its solve document.
GET/api/v1/platesolve/gallery/{id}/imageThe picture (AVIF, at most 1920 px, no metadata).
POST/api/v1/platesolve/gallery/{id}/reportReport a picture.
GET/api/v1/platesolve/gallery/{id}/thumbThe thumbnail (AVIF, at most 320 px).

Radiosondes

MethodPathSummary
GET/api/v1/radiosonde/burst-estimateMean burst altitude of the last 3 flights that burst after a launch within 40 km of a point: where a landing predictor should burst a balloon that is still climbing.
GET/api/v1/radiosonde/landingsLanding records of sondes that went silent near the ground (below 3000 m) within the last days: the last frame is the landing point.
GET/api/v1/radiosonde/liveServer-sent events: {"type":"radiosonde_init"} on connect, then one {"type":"radiosonde", "data":{serial, datetime, lat, lon, alt, vel_v, vel_h, heading, temp, humidity, pressure, batt, sats, frequency, type, subtype}} per sonde whose newest frame changed.
GET/api/v1/radiosonde/sitesRadiosonde launch sites worldwide, keyed by WMO id (station_name, position as [lon, lat], lat, lon, country when the name carries one, wmo_id).
GET/api/v1/radiosonde/sondesEvery sonde SondeHub heard in the range (flying, landed or lost) with its newest frame.
GET/api/v1/radiosonde/sondes/{serial}/telemetryComplete telemetry of one flight from SondeHub: duplicates from several receivers removed, glitches dropped, thinned to about 1700 points keeping the launch, the burst, the landing and the lowest 1500 m.
GET/api/v1/radiosonde/windForecast wind at every pressure level above a point (NOAA GFS, bilinear in space and linear in time), by increasing geopotential height: input of the client-side landing prediction.
GET/api/v1/radiosonde/wind/fieldForecast wind columns on a 5x5 whole-degree grid around a point at four 3-hourly instants (NOAA GFS), by increasing geopotential height: input of the 4D client-side landing prediction.

Sky

MethodPathSummary
GET/api/v1/sky/aircraftLive aircraft heard by our receiver (public).

Subjects

MethodPathSummary
GET/api/v1/subjectsList the subjects.

Weather

MethodPathSummary
GET/api/v1/weather/forecastHourly point forecast (7 days) from the stored NOAA GFS cycle, bilinearly interpolated.

A short machine-readable summary of the site for AI agents is at /llms.txt. /llms.txt