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
| Method | Path | Summary |
|---|---|---|
GET | /api/v1/astro/asteroids | Live orbital elements of the notable asteroids (JPL SBDB), cached 12 h. |
GET | /api/v1/astro/close-approaches | Recent and upcoming close approaches of near-Earth objects (JPL CAD), cached 12 h. |
GET | /api/v1/astro/comets | Live orbital elements of the notable comets (JPL SBDB), cached 12 h. |
GET | /api/v1/astro/satellites | Satellites of the CelesTrak stations and visual groups, for client-side propagation. |
GET | /api/v1/astro/satellites/{norad}/transmitters | Radio transmitters and transponders of a satellite (SatNOGS DB, answers cached for 6 h). |
GET | /api/v1/astro/satellites/search | Find satellites by name or NORAD number on CelesTrak (answers cached for 6 h per query). |
GET | /api/v1/astro/tle | Current TLEs of the ISS, Tiangong and Hubble (CelesTrak, SatNOGS fallback), cached 6 h. |
Plate solving
| Method | Path | Summary |
|---|---|---|
POST | /api/v1/platesolve/preview | Convert a FITS upload to a PNG the browser can show (image part, same limits as a solve). |
POST | /api/v1/platesolve/solve | Solve an image: SSE with ?stream=1, JSON otherwise. |
Plate-solve gallery
| Method | Path | Summary |
|---|---|---|
GET | /api/v1/platesolve/gallery | The public gallery, newest first. |
GET | /api/v1/platesolve/gallery/{id} | One picture with its solve document. |
GET | /api/v1/platesolve/gallery/{id}/image | The picture (AVIF, at most 1920 px, no metadata). |
POST | /api/v1/platesolve/gallery/{id}/report | Report a picture. |
GET | /api/v1/platesolve/gallery/{id}/thumb | The thumbnail (AVIF, at most 320 px). |
Radiosondes
| Method | Path | Summary |
|---|---|---|
GET | /api/v1/radiosonde/burst-estimate | Mean 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/landings | Landing 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/live | Server-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/sites | Radiosonde 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/sondes | Every sonde SondeHub heard in the range (flying, landed or lost) with its newest frame. |
GET | /api/v1/radiosonde/sondes/{serial}/telemetry | Complete 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/wind | Forecast 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/field | Forecast 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
| Method | Path | Summary |
|---|---|---|
GET | /api/v1/sky/aircraft | Live aircraft heard by our receiver (public). |
Subjects
| Method | Path | Summary |
|---|---|---|
GET | /api/v1/subjects | List the subjects. |
Weather
| Method | Path | Summary |
|---|---|---|
GET | /api/v1/weather/forecast | Hourly 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