From 2ccefaabd6d859801c26c3d9f40e1ac1f8f75509 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Thu, 10 Sep 2026 18:54:09 +0000 Subject: [PATCH 1/2] docs: align MCP tool parameters with live schemas Co-authored-by: Akshay Dodeja --- docs/mcp/home.mdx | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/docs/mcp/home.mdx b/docs/mcp/home.mdx index cf811135..13429bd4 100644 --- a/docs/mcp/home.mdx +++ b/docs/mcp/home.mdx @@ -234,7 +234,7 @@ Get detailed container information with flexible data loading. Choose what to in - `include` *(string[], optional)* – what to load: - `shipment` – routing, BOL, line, ref numbers (lightweight) - `pod_terminal` – terminal name, location (lightweight) - - `transport_events` – full event history (heavy, 50-100 events) + - `transport_events` – event count and latest event summary; use `get_container_transport_events` for the full timeline ```json @@ -394,13 +394,14 @@ See [Entitlements and Paid Features](/api-docs/useful-info/entitlements) for the List shipments with optional filters and pagination. **Parameters** -- `status`, `port`, `carrier`, `updated_after` *(string, optional)* +- `number` *(string, optional)* – shipment, booking, or Bill of Lading identifier +- `tracking_stopped` *(boolean, optional)* – filter by whether shipping-line tracking has stopped - `include_containers` *(boolean, optional)* - `page`, `page_size` *(number, optional)* **Good for** - "List recent shipments" -- "Show in-transit shipments for MAEU" +- "Find a shipment by booking or Bill of Lading number" **REST equivalent**: [GET /shipments](/api-docs/api-reference/shipments/list-shipments) @@ -411,13 +412,12 @@ List shipments with optional filters and pagination. List containers with optional filters and pagination. **Parameters** -- `status`, `port`, `carrier`, `updated_after` *(string, optional)* -- `include` *(string, optional)* – comma-separated include list +- `include` *(string[], optional)* – include `shipment`, `pod_terminal`, or both - `page`, `page_size` *(number, optional)* **Good for** -- "List containers updated in the last 24h" -- "Show containers at a specific POD port" +- "List containers in my account" +- "List containers with their shipment and POD terminal details" **REST equivalent**: [GET /containers](/api-docs/api-reference/containers/list-containers) @@ -428,7 +428,9 @@ List containers with optional filters and pagination. List tracking requests with optional filters and pagination. **Parameters** -- `filters` *(object, optional)* – raw query filters +- `request_number` *(string, optional)* – tracking request identifier +- `status` *(string, optional)* – `created`, `pending`, `succeeded`, or `failed` +- `scac` *(string, optional)* – four-letter shipping line SCAC - `page`, `page_size` *(number, optional)* **Good for** From df7963d4d5f5171ea82700a3363ee7ff0aeecbda Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Thu, 10 Sep 2026 18:55:03 +0000 Subject: [PATCH 2/2] docs: clarify get container event summary Co-authored-by: Akshay Dodeja --- docs/mcp/home.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/mcp/home.mdx b/docs/mcp/home.mdx index 13429bd4..9488da1a 100644 --- a/docs/mcp/home.mdx +++ b/docs/mcp/home.mdx @@ -234,7 +234,9 @@ Get detailed container information with flexible data loading. Choose what to in - `include` *(string[], optional)* – what to load: - `shipment` – routing, BOL, line, ref numbers (lightweight) - `pod_terminal` – terminal name, location (lightweight) - - `transport_events` – event count and latest event summary; use `get_container_transport_events` for the full timeline + - `transport_events` – adds `events.count`, `events.rail_events_count`, and `events.latest_event`; use `get_container_transport_events` for the full timeline + +The response may also include `_metadata` with factual details such as `includes_loaded`. ```json