`get_aircraft`

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

Track a specific aircraft in real-time by ICAO24 transponder code (e.g., “a0b1c2”). Returns current position, altitude, velocity, and heading.

Parameters

Name	Type	Required	Description
`icao24`	string	yes	ICAO24 transponder address (6 hex characters, e.g. “a0b1c2”)

Example call

Arguments

{
  "icao24": "a0b1c2"
}

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_aircraft","arguments":{"icao24":"a0b1c2"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('get_aircraft', {
  "icao24": "a0b1c2"
});

More examples

{
  "icao24": "4b1d0f"
}

Response shape

Always returns: icao24, callsign, origin_country, longitude, latitude, altitude, velocity, heading, on_ground

Field	Type	Description
`icao24`	string	ICAO24 transponder address
`callsign`	string \| null	Aircraft callsign (trimmed)
`origin_country`	string	Country of origin
`longitude`	number \| null	Current longitude in degrees
`latitude`	number \| null	Current latitude in degrees
`altitude`	number \| null	Barometric altitude in meters
`velocity`	number \| null	Velocity in meters per second
`heading`	number \| null	True track heading in degrees
`on_ground`	boolean	Whether aircraft is on ground

Full JSON Schema

{
  "type": "object",
  "properties": {
    "icao24": {
      "type": "string",
      "description": "ICAO24 transponder address"
    },
    "callsign": {
      "type": [
        "string",
        "null"
      ],
      "description": "Aircraft callsign (trimmed)"
    },
    "origin_country": {
      "type": "string",
      "description": "Country of origin"
    },
    "longitude": {
      "type": [
        "number",
        "null"
      ],
      "description": "Current longitude in degrees"
    },
    "latitude": {
      "type": [
        "number",
        "null"
      ],
      "description": "Current latitude in degrees"
    },
    "altitude": {
      "type": [
        "number",
        "null"
      ],
      "description": "Barometric altitude in meters"
    },
    "velocity": {
      "type": [
        "number",
        "null"
      ],
      "description": "Velocity in meters per second"
    },
    "heading": {
      "type": [
        "number",
        "null"
      ],
      "description": "True track heading in degrees"
    },
    "on_ground": {
      "type": "boolean",
      "description": "Whether aircraft is on ground"
    }
  },
  "required": [
    "icao24",
    "callsign",
    "origin_country",
    "longitude",
    "latitude",
    "altitude",
    "velocity",
    "heading",
    "on_ground"
  ]
}

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_aircraft