Air freight, as one API call.
Track any air waybill across 83 cargo airlines over one REST endpoint and one MCP connection. Every airline is normalised onto the same IATA Cargo-IMP milestones, so an Emirates AWB and a Cebu Pacific AWB read identically. Base URL https://api.aircargomcp.com.
Endpoints
- GET /track/:awb Primary endpoint. Any AWB → status, route, pieces, weight, ETA and Cargo-IMP milestones.
- GET /prefix/:code 3-digit AWB prefix → the issuing airline (the AWB-prefix oracle).
- POST /rates/quote Price a lane per kg: chargeable weight, weight band, fuel & security surcharges, all-in.
- GET /aircraft/flight/:flightNumber Live freighter position by flight number, via ADS-B.
Track by AWB number
The primary endpoint. GET /track/203-12345675 returns { data: AwbTrackingData }: the AWB, issuing airline, normalised status (booked, accepted, in_transit, arrived, available, delivered), origin and destination stations, pieces, gross weight, ETA, and a chronological list of Cargo-IMP milestone events. Errors return { error: { code, message } } with codes invalid_reference, unsupported_carrier, not_found, blocked, rate_limited or upstream_error.
MCP for AI agents
Connect any MCP client to https://mcp.aircargomcp.com/mcp. Tools: track_awb, resolve_awb_prefix, air_rate_quote.
FAQ
How do I track an air waybill with the AirCargoMCP API?
Call GET https://api.aircargomcp.com/track/{awb} with the 11-digit AWB (3-digit airline prefix + 8-digit serial). The response is { data: AwbTrackingData }, status, origin, destination, pieces, weight, ETA and a chronological list of IATA Cargo-IMP milestones (RCS, MAN, DEP, ARR, RCF, NFD, DLV), normalised the same way across every airline.
What is the AWB-prefix oracle?
GET /prefix/{code} resolves a 3-digit AWB prefix to its issuing airline, name, IATA code and public tracking site. It is the air equivalent of a container BIC-prefix lookup, free and offline, covering 83 cargo airlines.
Does AirCargoMCP support MCP for AI agents?
Yes. The MCP server at https://mcp.aircargomcp.com/mcp exposes three tools, track_awb, resolve_awb_prefix and air_rate_quote, so Claude, Cursor or any MCP client can read live shipment state, resolve prefixes and price lanes.