Flights

live Travel

Live aircraft positions, arrivals, and departures from the OpenSky Network

4 tools
0ms auth
free tier 50 calls/day

Tools

get_flights_in_area required: lamin, lomin, lamax, lomax

Get all aircraft currently in a geographic bounding box. Returns icao24, callsign, origin country, position, altitude, velocity, and heading.

Parameters
Name Type Description
lamin req number Minimum latitude of the bounding box (degrees)
lomin req number Minimum longitude of the bounding box (degrees)
lamax req number Maximum latitude of the bounding box (degrees)
lomax req number Maximum longitude of the bounding box (degrees)
Try it
get_aircraft required: icao24

Track a specific aircraft by its ICAO24 transponder address. Returns current position, velocity, altitude, and heading.

Parameters
Name Type Description
icao24 req string ICAO24 transponder address (6 hex characters, e.g. "a0b1c2")
Try it
get_arrivals required: airport, begin, end

Get flights that arrived at an airport within a time range. Requires an ICAO airport code and Unix timestamps.

Parameters
Name Type Description
airport req string ICAO airport code (e.g. "KLAX", "EGLL")
begin req number Start of time range as Unix timestamp (seconds)
end req number End of time range as Unix timestamp (seconds, max 7 days after begin)
Try it
get_departures required: airport, begin, end

Get flights that departed from an airport within a time range. Requires an ICAO airport code and Unix timestamps.

Parameters
Name Type Description
airport req string ICAO airport code (e.g. "KLAX", "EGLL")
begin req number Start of time range as Unix timestamp (seconds)
end req number End of time range as Unix timestamp (seconds, max 7 days after begin)
Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/flights/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/flights/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_flights_in_area","arguments":{"lamin": 10, "lomin": 10, "lamax": 10, "lomax": 10}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("get_flights_in_area", {"lamin":"example","lomin":"example","lamax":"example","lomax":"example"});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("live aircraft positions, arrivals, and departures from the opensky network");

Related packs

Other Pipeworx packs in the same categories (Travel):