Flights

Calling it

Metered methods answer an unauthenticated call with 402 and an x402 challenge — pay it and the same request succeeds, with no account at all. A token works too.

curl -H "Authorization: Bearer $MU_TOKEN" \
  https://micro.mu/api/v1/flights/airport

The same method over MCP, which is what an agent speaks: flights_airport. The answer is identical.

How every call behaves →

Methods

GET /api/v1/flights/airport

Report what is happening at an airport right now: what is on the ground, what is on approach and what is climbing out. Live positions, not the timetable, so it says nothing about scheduled or delayed departures

Argument	Type	Description
`code` *	string	An airport code or name, e.g. 'LHR', 'EGLL' or 'Heathrow'

curl \
  "https://micro.mu/api/v1/flights/airport?code=code"

code *

GET /api/v1/flights/overhead

List the aircraft flying near a location right now, nearest first, with altitude, speed, heading and distance. Live positions broadcast by the aircraft themselves, not a schedule

Argument	Type	Description
`near`	string	Where to look: a place name, or an airport name or code, e.g. 'Camden, London' or 'LHR'
`lat`	number	Optional latitude, if the location is already known
`lon`	number	Optional longitude, if the location is already known
`radius`	number	Optional radius in nautical miles (default 30, maximum 250)

curl \
  "https://micro.mu/api/v1/flights/overhead"

nearlatlonradius

3 creditsGET /api/v1/flights/status

Scheduled, estimated and actual flight arrival/departure times from Aviationstack. Requires a configured provider.

Draws 3 credits per call, or accepts payment.

Argument	Type	Description
`flight`	string	IATA flight number, e.g. BA117
`airport`	string	IATA airport code, e.g. LHR
`direction`	string	arrivals or departures (default arrivals)

curl \
  -H "Authorization: Bearer $MU_TOKEN" \
  "https://micro.mu/api/v1/flights/status"

flightairportdirection

Costs 3 credits

GET /api/v1/flights/track

Find where an aircraft is right now by flight number ('BA117'), radio callsign ('BAW117') or registration ('G-ZBKL'). Only sees aeroplanes that are airborne and in range of a receiver — not finding one does not mean the flight was cancelled

Argument	Type	Description
`flight` *	string	A flight number ('BA117'), a radio callsign ('BAW117'), or an aircraft registration ('G-ZBKL')

curl \
  "https://micro.mu/api/v1/flights/track?flight=flight"

flight *

The same methods are tools over MCP, and every service on this instance is in one reference.