Authenticate with the Freightos WebCargo API using your API key in the Authorization header
POST a rate request to the /rates endpoint specifying origin and destination (UNLOC codes for ocean, IATA codes for air), cargo weight, volume or dimensions, commodity type, and Incoterms
Parse the response array of rate offers, each containing the carrier name, service type, transit time, total freight charge, and validity date
Select the preferred rate offer by service level and price, then create a booking using the selected rate offer's ID via the /bookings endpoint
Retrieve the booking confirmation and document number from the API response to initiate the shipment workflow
Known gotchas
Spot rates on digital freight platforms are subject to capacity allocation; a rate returned does not guarantee space — the booking confirmation step is required to secure it
Fuel surcharges and peak season surcharges are sometimes excluded from the base rate quote and appear as additional line items; compare total-cost figures not base rates
Quoted transit times are port-to-port for ocean and airport-to-airport for air; door-to-door delivery adds pre-carriage and on-carriage legs that must be independently estimated
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp