com.shaq-log/freight-mcp

Ask SHAQ Freight Analyst a natural-language question about ocean freight rates, routes, trends, container types, surcharges, or Incoterms. The analyst retrieves real-time SHAQ data and answers in the same language as the question. Example: analyst_chat(question='Is the rate from Shenzhen to Manzanillo rising or falling for a 40HC?')

Find the lowest-priced destination ports in a country from one origin, across all carriers. Returns ranked destinations with the cheapest currently-valid rate, carrier and validity. Use this when the customer asks where it is cheapest to ship within a country. Example: cheapest_route(origin='Shenzhen', country='Mexico')

Submit a shipping booking request (FCL or LCL). REQUIRES pin parameter (contact SHAQ at info@shaq-logistics.com to get your pin). REQUIRES 7 mandatory fields: contact_name, contact_phone, contact_email, supplier_name, supplier_phone, supplier_email, po_number. If any mandatory field is missing, the tool returns an error listing which fields are needed. All bookings are created with 'pending_review' status. Example: create_booking(pin='shaq2026', origin_port='Shenzhen', destination_port='Los Angeles', container_type='40HC', container_count=1, contact_name='John', contact_email='john@example.com', contact_phone='+1234567890', supplier_name='ABC Factory', supplier_phone='+8613800001111', supplier_email='sales@abcfactory.com', po_number='PO-2026-0001', product_name='Electronics')

Get customs compliance information for importing to a specific country. Returns required documents, special requirements, restricted items, duty/tax rates, and FTA info. Use this when customers ask about customs, documents, import requirements, or duties. Example: get_customs_info(country='Australia')

Get freight rate index data for market trends. Shows average rates for major trade lanes (e.g. China-US West Coast, China-Europe). Example: get_freight_index(route='china-us-west-coast')

Get port fee types for a given port. Returns fee categories, not specific amounts. Args: port: Port name (e.g., Shenzhen, Shanghai, Ningbo) fee_type: Optional filter by fee type Returns: List of port fee types and categories

Get upcoming vessel sailing schedules between two ports. Returns vessel name, voyage number, ETD, ETA, transit time, and frequency. Use this when customers ask 'when is the next ship' or 'how long does it take'. Example: get_sailing_schedule(origin='Shenzhen', destination='Los Angeles')

List available ports with alias support. Search by name, code, or country. Returns matching ports and their aliases. Example: list_ports(query='China', limit=20) or list_ports(query='Los Angeles')

Get freight rate trend for a lane: are prices rising or falling? Compares currently-valid carrier tariff windows with recently-expired windows, plus market indices (SCFI, Freightos Baltic Index). Use this when the customer asks whether rates are going up or down, or about market direction. Example: rate_trends(origin='Busan', destination='Altamira', weeks=4)

Search real-time ocean freight rates (FCL & LCL) between two ports. Returns available rates with price and validity. Port names support aliases (e.g. 'Shenzhen' matches all Shenzhen terminals, 'LA' matches 'Los Angeles'). Example: search_freight_rates(origin='Shenzhen', destination='Los Angeles', container_type='40HC')

Subscribe to freight rate change alerts. Get notified by email when rates change for a specific route. Example: subscribe_rate_alert(email='john@example.com', origin='Shenzhen', destination='Los Angeles')

Track a shipping booking order by order number. Returns current status (pending_review, confirmed, shipped, etc.), timeline, and booking details. Example: track_booking(order_number='SQ-2026-001')