freight-mcp
mcpother no repoReal-time ocean freight rates, LCL pricing, and booking management for global logistics.
run it
web service onlyconnect to it
copy what your client needs{
"mcpServers": {
"freight": {
"command": "CHANGE_ME",
"args": []
}
}
}
#!/usr/bin/env bash # Registers every server with Claude Code (run once; `claude mcp list` to check). set -euo pipefail set -a; [ -f .env ] && source .env; set +a claude mcp add freight -- CHANGE_ME
{
"mcpServers": {
"freight": {
"command": "CHANGE_ME",
"args": []
}
}
}
{
"servers": {
"freight": {
"type": "stdio",
"command": "CHANGE_ME",
"args": []
}
}
}
name: my-agent target: local servers: - hub: com.shaq-log/freight-mcp
- trust flag: no_repo
- tier other: no package, image or remote; fill the files by hand
tools · 13
analyst_chatAsk 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?')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?')
pin 23f20f25376d4de99317137e2e19f0bba73a79beac98610034c785862a0eb6f8cheapest_routeFind 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')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')
pin afa37cd68b0ad378e3dfdda6aed1a72203c8980bc8c442dfcb9dfe8c3b17880dcreate_bookingSubmit 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')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')
pin 1b356fe2c58fb3dfbfa346af52691debc65dd6a6f2400055ed0637c9c60121eaget_customs_infoGet 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 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')
pin e40c2265976824dfcd2bf28166acf54c45c4073481979f69bb6ffc98d7d5e351get_freight_indexGet 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 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')
pin fa7e28032d6e173fa93f96329b0f483443d80056c1ac7165ebccb524315e045bget_port_feesGet 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 categoriesGet 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
pin 0924b6f8bf3ce279b89f28aad05040c227793c8d38facf9dbc1d211d81530370get_sailing_scheduleGet 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')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')
pin 3f316a401ea8b5c7bac74a064bd9482d81256d0eee1600d58586f1d8800673a5list_portsList 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')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')
pin 4c08b94603682431c71f96b8b3e7894fb8772cf6d3ab132221c9a125daf93962rate_trendsGet 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)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)
pin 2bf5b05241a21795e1fa5a4fa0b40ff362d1e1eff6db3ed467e9435d00125977search_freight_ratesSearch 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')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')
pin a864b1b229b22933909d97c465319e48f15d781965ff865e665581c06792c5f0search_freight_rates_batchSearch 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.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.
pin 9111a23a6dff6ca7113fc17996fb78bf2474e391ce9505ca132c4427f1c3ec6esubscribe_rate_alertSubscribe 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')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')
pin 816eee585e53fade03fa8b5cc12bc60486e4295c767f0ed31453191f050d2170track_bookingTrack 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')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')
pin cd707ce4a4e8d56baf8c031af3b9853e703530f74340cc7483aff28562ebe449
runs · 1
the latest tests of this entry by the hub and its workers, newest first| date | worker | method | status | sandbox | reason |
|---|---|---|---|---|---|
| 2026-10-16 09:46 | local-mac | remotemcp 2025-11-25 | ok13 tools | none | — |