freight-mcp

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')

{
  "type": "object",
  "properties": {
    "origin": {
      "title": "Origin",
      "type": "string"
    },
    "destination": {
      "title": "Destination",
      "type": "string"
    },
    "container_type": {
      "default": "",
      "title": "Container Type",
      "type": "string"
    }
  },
  "required": [
    "origin",
    "destination"
  ],
  "title": "search_freight_ratesArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "search_freight_ratesOutput"
}

Submit a shipping booking request (FCL or LCL). REQUIRES pin parameter (contact SHAQ at [email protected] 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='[email protected]', contact_phone='+1234567890', supplier_name='ABC Factory', supplier_phone='+8613800001111', supplier_email='[email protected]', po_number='PO-2026-0001', product_name='Electronics')

{
  "type": "object",
  "properties": {
    "pin": {
      "title": "Pin",
      "type": "string"
    },
    "origin_port": {
      "title": "Origin Port",
      "type": "string"
    },
    "destination_port": {
      "title": "Destination Port",
      "type": "string"
    },
    "contact_name": {
      "title": "Contact Name",
      "type": "string"
    },
    "contact_phone": {
      "title": "Contact Phone",
      "type": "string"
    },
    "contact_email": {
      "title": "Contact Email",
      "type": "string"
    },
    "supplier_name": {
      "title": "Supplier Name",
      "type": "string"
    },
    "supplier_phone": {
      "title": "Supplier Phone",
      "type": "string"
    },
    "supplier_email": {
      "title": "Supplier Email",
      "type": "string"
    },
    "po_number": {
      "title": "Po Number",
      "type": "string"
    },
    "container_type": {
      "default": "40GP",
      "title": "Container Type",
      "type": "string"
    },
    "container_count": {
      "default": 1,
      "title": "Container Count",
      "type": "integer"
    },
    "weight_per_container": {
      "default": "",
      "title": "Weight Per Container",
      "type": "string"
    },
    "product_name": {
      "default": "",
      "title": "Product Name",
      "type": "string"
    },
    "hs_code": {
      "default": "",
      "title": "Hs Code",
      "type": "string"
    },
    "service_type": {
      "default": "FCL",
      "title": "Service Type",
      "type": "string"
    },
    "freight_rate_usd": {
      "default": 0,
      "title": "Freight Rate Usd",
      "type": "number"
    },
    "remark": {
      "default": "",
      "title": "Remark",
      "type": "string"
    }
  },
  "required": [
    "pin",
    "origin_port",
    "destination_port",
    "contact_name",
    "contact_phone",
    "contact_email",
    "supplier_name",
    "supplier_phone",
    "supplier_email",
    "po_number"
  ],
  "title": "create_bookingArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "create_bookingOutput"
}

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')

{
  "type": "object",
  "properties": {
    "order_number": {
      "title": "Order Number",
      "type": "string"
    }
  },
  "required": [
    "order_number"
  ],
  "title": "track_bookingArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "track_bookingOutput"
}

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')

{
  "type": "object",
  "properties": {
    "query": {
      "default": "",
      "title": "Query",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "list_portsArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "list_portsOutput"
}

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')

{
  "type": "object",
  "properties": {
    "route": {
      "default": "",
      "title": "Route",
      "type": "string"
    }
  },
  "title": "get_freight_indexArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "get_freight_indexOutput"
}

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

{
  "type": "object",
  "properties": {
    "email": {
      "title": "Email",
      "type": "string"
    },
    "origin": {
      "title": "Origin",
      "type": "string"
    },
    "destination": {
      "title": "Destination",
      "type": "string"
    },
    "service_type": {
      "default": "FCL",
      "title": "Service Type",
      "type": "string"
    }
  },
  "required": [
    "email",
    "origin",
    "destination"
  ],
  "title": "subscribe_rate_alertArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "subscribe_rate_alertOutput"
}

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')

{
  "type": "object",
  "properties": {
    "origin": {
      "title": "Origin",
      "type": "string"
    },
    "destination": {
      "title": "Destination",
      "type": "string"
    },
    "limit": {
      "default": 5,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "origin",
    "destination"
  ],
  "title": "get_sailing_scheduleArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "get_sailing_scheduleOutput"
}

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

{
  "type": "object",
  "properties": {
    "port": {
      "title": "Port",
      "type": "string"
    },
    "fee_type": {
      "default": "",
      "title": "Fee Type",
      "type": "string"
    }
  },
  "required": [
    "port"
  ],
  "title": "get_port_feesArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "get_port_feesOutput"
}

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')

{
  "type": "object",
  "properties": {
    "country": {
      "title": "Country",
      "type": "string"
    }
  },
  "required": [
    "country"
  ],
  "title": "get_customs_infoArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "get_customs_infoOutput"
}

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). 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)

{
  "type": "object",
  "properties": {
    "origin": {
      "title": "Origin",
      "type": "string"
    },
    "destination": {
      "title": "Destination",
      "type": "string"
    },
    "container_type": {
      "default": "",
      "title": "Container Type",
      "type": "string"
    },
    "weeks": {
      "default": 4,
      "title": "Weeks",
      "type": "integer"
    }
  },
  "required": [
    "origin",
    "destination"
  ],
  "title": "rate_trendsArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "rate_trendsOutput"
}

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')

{
  "type": "object",
  "properties": {
    "origin": {
      "title": "Origin",
      "type": "string"
    },
    "country": {
      "title": "Country",
      "type": "string"
    },
    "container_type": {
      "default": "",
      "title": "Container Type",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "origin",
    "country"
  ],
  "title": "cheapest_routeArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "cheapest_routeOutput"
}

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?')

{
  "type": "object",
  "properties": {
    "question": {
      "title": "Question",
      "type": "string"
    }
  },
  "required": [
    "question"
  ],
  "title": "analyst_chatArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "analyst_chatOutput"
}

Search ocean freight rates for MULTIPLE routes in one call. Accepts natural-language queries: 'Shenzhen to Los Angeles 40HC', '盐田到长滩小柜', 'Shanghai to Hamburg reefer'. Understands Chinese jargon: 小柜=20GP, 大柜=40GP, 高柜=40HQ, 冷藏/冻柜=reefer. Returns a compact per-route summary (rate count, container types, lowest rates). Max 10 queries per call.

{
  "type": "object",
  "properties": {
    "queries": {
      "items": {
        "type": "string"
      },
      "title": "Queries",
      "type": "array"
    }
  },
  "required": [
    "queries"
  ],
  "title": "search_freight_rates_batchArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "search_freight_rates_batchOutput"
}