get_aircraft

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

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

Look up one aircraft by its ICAO24 transponder address (hex, e.g. “3c675a”) and return where it is right now: position, altitude, speed, heading, squawk, registration, type and operator. Keyless. Historical flight legs for an aircraft are not available from the live feeds — for the scheduled route a callsign flies, use get_flight_route in the flights pack.

Parameters

NameTypeRequiredDescription
icao24stringyesICAO24 transponder address in hex (e.g. “3c675a”).
beginnumbernoIgnored — retained for compatibility; the live feeds carry no history.
endnumbernoIgnored — retained for compatibility; the live feeds carry no history.

Example call

Arguments

{
  "icao24": "40825f"
}

curl

curl -X POST https://gateway.pipeworx.io/opensky/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_aircraft","arguments":{"icao24":"40825f"}}}'

TypeScript (@pipeworx/sdk)

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

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

More examples

{
  "icao24": "3c68cb"
}

Connect

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

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

See Getting Started for client-specific install steps.

Regenerated from source · build September 22, 2026