`terminal49_track`

Pack: terminal49 · Endpoint: https://gateway.pipeworx.io/terminal49/mcp

Start tracking an ocean shipment or container by submitting a bill of lading, booking, or container number plus the carrier SCAC. Returns the tracking request id and status (pending -> created/failed). Example: terminal49_track({ request_number: “MEDUFR030802”, request_type: “bill_of_lading”, scac: “MSCU”, _apiKey: “your-key” })

Parameters

Name	Type	Required	Description
`request_number`	string	yes	The shipping-line booking number, master bill of lading number, or container number to track, e.g. “MEDUFR030802”.
`request_type`	string	no	What request_number is: “bill_of_lading”, “booking”, or “container”. Aliases like “bol”/“booking_number” are normalized. Defaults to bill_of_lading.
`scac`	string	no	Carrier SCAC (Standard Carrier Alpha Code), e.g. “MSCU” (MSC), “MAEU” (Maersk). Optional if auto_detect_scac is true.
`auto_detect_scac`	boolean	no	Let Terminal49 auto-detect the carrier SCAC instead of supplying one. Defaults to false.
`ref_numbers`	array	no	Optional array of your internal reference numbers (e.g. PO numbers) to attach to the shipment.
`items`	string	no
`shipment_tags`	array	no	Optional array of tags to attach to the resulting shipment.
`items`	string	no
`_apiKey`	string	yes	Terminal49 API key (create one at https://app.terminal49.com/developers/api-keys).

Example call

Arguments

{
  "request_number": "MEDUFR030802",
  "request_type": "bill_of_lading",
  "scac": "MSCU",
  "_apiKey": "your-terminal49-api-key"
}

curl

curl -X POST https://gateway.pipeworx.io/terminal49/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"terminal49_track","arguments":{"request_number":"MEDUFR030802","request_type":"bill_of_lading","scac":"MSCU","_apiKey":"your-terminal49-api-key"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('terminal49_track', {
  "request_number": "MEDUFR030802",
  "request_type": "bill_of_lading",
  "scac": "MSCU",
  "_apiKey": "your-terminal49-api-key"
});

More examples

{
  "request_number": "TCLU1234567",
  "request_type": "booking",
  "auto_detect_scac": true,
  "ref_numbers": [
    "PO-2024-001"
  ],
  "shipment_tags": [
    "urgent",
    "electronics"
  ],
  "_apiKey": "your-terminal49-api-key"
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "terminal49": {
      "url": "https://gateway.pipeworx.io/terminal49/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

terminal49_track