# com.shaq-log/freight-mcp

> Real-time ocean freight rates, LCL pricing, and booking management for global logistics.

- name: com.shaq-log/freight-mcp
- version: 2.2.0
- connection class: unknown (unknown)
- trust: 47/100 flags: no-repository, unreachable
- quality: 76/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.shaq-log%2Ffreight-mcp
- tools: https://api.protogrid.dev/v1/servers/com.shaq-log%2Ffreight-mcp/tools

**Not classified yet.** The remote endpoints have not been probed successfully, or the listing has nothing to connect to.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "freight-mcp": {
      "type": "sse",
      "url": "https://search.shaq-logistics.com/sse"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 0
- freshness: 85
- provenance: 45
- drivers: +dns-namespace -unreachable(4 failures) ~updated-69d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 76/100 (good)

### protocol: 50 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- warn `protocol.transport`: only the legacy HTTP+SSE transport, deprecated until 2027-07-28
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 86 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 13 of 13 tools declare readOnlyHint or destructiveHint
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_sailing_schedule (destructiveHint, idempotentHint, openWorldHint); get_port_fees (destructiveHint, idempotentHint, openWorldHint); get_customs_info (destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 2,238 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: 1 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 13, about 2,238 tokens to load them all
- tool set hash: 7cec27c0b3825c0364c29b8b69b5d581
- tools last changed: 2026-10-02T16:47:12.676Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.shaq-log/freight-mcp.svg)](https://protogrid.dev/servers/com.shaq-log/freight-mcp)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-02 `search_freight_rates` changed (description)
  - before: Search real-time ocean freight rates (FCL & LCL) between two ports. For each container type only the cheapest contracted carrier is returned (COSCO vs CMA CGM, whichever is lower). 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')
  - after: 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')

Full history: https://api.protogrid.dev/v1/servers/com.shaq-log%2Ffreight-mcp/changes

## Remotes

- https://search.shaq-logistics.com/sse (sse, auth none, reachable false, uptime30d 0.9537037)

## Packages

_none_

## Tools (13)

- `analyst_chat`: 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?')
- `cheapest_route`: 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')
- `create_booking`: 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_info`: 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_index`: 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_fees`: 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_sailing_schedule`: 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_ports`: 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')
- `rate_trends`: 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)
- `search_freight_rates`: 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')
- `search_freight_rates_batch`: 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.
- `subscribe_rate_alert`: 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_booking`: 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')