freight-mcp
Real-time ocean freight rates, LCL pricing, and booking management for global logistics.
我該用這個嗎
品質與安全性
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"freight-mcp": {
"url": "https://search.shaq-logistics.com/sse"
}
}
}遠端端點
https://search.shaq-logistics.com/ssesse它能做什麼
工具清單
工具（13）
🟢search_freight_rates(origin, destination, container_type)
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"
}🔴create_booking(pin, origin_port, destination_port, contact_name, contact_phone, ...)
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_booking(order_number)
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_ports(query, limit)
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_index(route)
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_rate_alert(email, origin, destination, service_type)
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_sailing_schedule(origin, destination, limit)
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_fees(port, fee_type)
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_info(country)
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"
}🟢rate_trends(origin, destination, container_type, weeks)
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"
}🟢cheapest_route(origin, country, container_type, limit)
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"
}🟢analyst_chat(question)
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_freight_rates_batch(queries)
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"
}社群
證據