`flights_get_aircraft`

Pack: flights · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/flights_get_aircraft for the schema, then POST the same URL with its arguments for the data.

Look up ONE aircraft by ICAO24 transponder hex (e.g. “a4d97e”). Returns registry details — registration/tail number, manufacturer, type, and registered owner/operator — plus its LIVE position if it is currently transmitting. No key required. Use for “what is aircraft ”, “who operates ”, “where is now”. If you only have a flight number/callsign, use get_flight_route instead.

Parameters

Name	Type	Required	Description
`icao24`	string	yes	ICAO24 transponder address — 6 hex characters, e.g. “a4d97e” (case-insensitive)

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

TypeScript (@pipeworx/sdk)

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

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

More examples

{
  "icao24": "4b1d0f"
}

Response shape

Always returns: icao24

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
`registration`	string
`aircraft_type`	string
`icao_type_code`	string
`manufacturer`	string
`operator`	string
`operator_country`	string
`photo_url`	string
`currently_tracked`	boolean
`live_position`	null
`note`	string

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"
    },
    "registration": {
      "type": "string"
    },
    "aircraft_type": {
      "type": "string"
    },
    "icao_type_code": {
      "type": "string"
    },
    "manufacturer": {
      "type": "string"
    },
    "operator": {
      "type": "string"
    },
    "operator_country": {
      "type": "string"
    },
    "photo_url": {
      "type": "string"
    },
    "currently_tracked": {
      "type": "boolean"
    },
    "live_position": {
      "type": "null"
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "icao24"
  ]
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

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

Connect to just the flights pack

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

See Getting Started for client-specific install steps.

flights_get_aircraft