`get_arrivals`

Pack: flights · Endpoint: https://gateway.pipeworx.io/flights/mcp

Aircraft currently ARRIVING at an airport — live ADS-B, no key required. Pass an ICAO code (e.g. “KSFO”, “EGLL”) and get inbound traffic descending toward the field, nearest first, with callsign, registration, aircraft type, altitude, descent rate and distance out. Use for “what is landing at right now”, “inbound traffic to ”. This is a live picture, not a scheduled timetable. (Historical windows via begin/end require OpenSky credentials and only work when self-hosting — OpenSky is unreachable from cloud egress.)

Parameters

Name	Type	Required	Description
`airport`	string	yes	ICAO airport code, e.g. “KJFK”, “EGLL”, “KSFO” (4 letters, not the 3-letter IATA code)
`radius_nm`	number	no	How far out to look, nautical miles (1-250, default 40).
`limit`	number	no	Max aircraft to return (1-200, default 50), nearest first.
`begin`	number	no	OPTIONAL historical window start (Unix seconds). Requires OpenSky credentials and only works when self-hosting; omit for live data.
`end`	number	no	OPTIONAL historical window end (Unix seconds, max 7 days after begin). Omit for live data.

Example call

Arguments

{
  "airport": "KJFK",
  "begin": 1609459200,
  "end": 1609545600
}

curl

curl -X POST https://gateway.pipeworx.io/flights/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_arrivals","arguments":{"airport":"KJFK","begin":1609459200,"end":1609545600}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_arrivals', {
  "airport": "KJFK",
  "begin": 1609459200,
  "end": 1609545600
});

More examples

{
  "airport": "EGLL",
  "begin": 1704067200,
  "end": 1704153600
}

Response shape

Always returns: count, flights

Field	Type	Description
`count`	number	Number of arrival flights found
`flights`	array

Full JSON Schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number",
      "description": "Number of arrival flights found"
    },
    "flights": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "icao24": {
            "type": "string",
            "description": "ICAO24 transponder address"
          },
          "callsign": {
            "type": [
              "string",
              "null"
            ],
            "description": "Flight callsign (trimmed)"
          },
          "first_seen": {
            "type": "number",
            "description": "Unix timestamp of first radar contact"
          },
          "last_seen": {
            "type": "number",
            "description": "Unix timestamp of last radar contact"
          },
          "departure_airport": {
            "type": [
              "string",
              "null"
            ],
            "description": "Estimated departure airport ICAO code"
          },
          "arrival_airport": {
            "type": [
              "string",
              "null"
            ],
            "description": "Estimated arrival airport ICAO code"
          }
        },
        "required": [
          "icao24",
          "callsign",
          "first_seen",
          "last_seen",
          "departure_airport",
          "arrival_airport"
        ]
      }
    }
  },
  "required": [
    "count",
    "flights"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "flights": {
      "url": "https://gateway.pipeworx.io/flights/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_arrivals