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
| Name | Type | Required | Description |
|---|---|---|---|
icao24 | string | yes | ICAO24 transponder address in hex (e.g. “3c675a”). |
begin | number | no | Ignored — retained for compatibility; the live feeds carry no history. |
end | number | no | Ignored — 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.