---
type: "firecrawl-provider"
description: "MSC (Mediterranean Shipping Company) public tools on msc.com: container, bill-of-lading and booking tracking with milestone events, point-to-point sailing schedules, vessel port-call schedules, port arrivals and departures, the port and vessel reference lists, first-EU-port arrivals and the customer advisories newsroom. Anonymous JSON endpoints behind the site's Sitecore pages."
use_when: "MSC (Mediterranean Shipping Company) public tools on msc.com: container, bill-of-lading and booking tracking with milestone events, point-to-point sailing schedules, vessel port-call schedules, port arrivals and departures, the port and vessel reference lists, first-EU-port arrivals and the customer advisories newsroom. Anonymous JSON endpoints behind the site's Sitecore pages."
categories: "Company"
capabilities: 8
credits_per_call: 5
---
# MSC shipment tracking and schedules on Firecrawl Alexandria

MSC (Mediterranean Shipping Company) public tools on msc.com: container, bill-of-lading and booking tracking with milestone events, point-to-point sailing schedules, vessel port-call schedules, port arrivals and departures, the port and vessel reference lists, first-EU-port arrivals and the customer advisories newsroom. Anonymous JSON endpoints behind the site's Sitecore pages.

- Categories: Company
- Category index: [Company category](https://firecrawl.dev/alexandria/agents/categories/company)
- Provider key: `msc-com`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/msc-com)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/msc-com/openapi.json)

## Capabilities

- [Eu first port arrivals](https://firecrawl.dev/alexandria/agents/providers/msc-com/shipment-tracking/eu_first_port_arrivals): MSC's VSA tool: upcoming vessel arrivals at their first EU port (vessel, IMO, voyage, port, ETA, customs office reference), optionally filtered by vessel name or IMO substring. One MSC response lists every vessel; the filter is applied client-side.
- [List advisories](https://firecrawl.dev/alexandria/agents/providers/msc-com/shipment-tracking/list_advisories): MSC newsroom customer advisories and price announcements, newest first, with optional publication date range and 0-based pagination; each row has MSC's article id, title, absolute URL, date (ISO) and type, plus the facet counts MSC returns.
- [List ports](https://firecrawl.dev/alexandria/agents/providers/msc-com/shipment-tracking/list_ports): MSC's schedule-search reference list of ports (MSC port id, name, UN/LOCODE, country, coordinates) and countries, optionally filtered by a name/UN-LOCODE substring and/or ISO-2 country. Resolves a UN/LOCODE or port name to the MSC port id and UN/LOCODE the schedule functions take.
- [List vessels](https://firecrawl.dev/alexandria/agents/providers/msc-com/shipment-tracking/list_vessels): MSC's vessel reference list (vessel name and IMO / Lloyd's number) used by the vessel-schedule search, optionally filtered by a name or IMO substring. Duplicate rows MSC publishes are collapsed.
- [Port arrivals departures](https://firecrawl.dev/alexandria/agents/providers/msc-com/shipment-tracking/port_arrivals_departures): Upcoming vessel arrivals and departures at one port (UN/LOCODE) from MSC's schedule tool, with voyage, service, vessel details and the departure cut-off rules. MSC answers 'no results' both for an unknown code and for a port without sailings; that is reported as not_found.
- [Search sailing schedule](https://firecrawl.dev/alexandria/agents/providers/msc-com/shipment-tracking/search_sailing_schedule): Point-to-point sailing schedules from MSC's search-a-schedule tool: for an origin and destination port and an earliest departure date, every route (service, direct or transhipment, transit time, CO2 footprint) with its sailings (vessel, voyage, ETD/ETA, cut-offs, legs with vessels and ports). Ports are given as MSC port id or UN/LOCODE; UN/LOCODEs are resolved through MSC's port list.
- [Track shipment](https://firecrawl.dev/alexandria/agents/providers/msc-com/shipment-tracking/track_shipment): Track an MSC shipment by container number, bill of lading number or booking number: route summary (shipped from/to, ports, transshipments), ETA at the port of discharge and every milestone event per container with vessel, voyage, terminal and intermediary port calls. Dates are local port dates normalised to ISO; MSC's own result label (Central Europe time) is kept verbatim.
- [Vessel schedule](https://firecrawl.dev/alexandria/agents/providers/msc-com/shipment-tracking/vessel_schedule): Live port-call schedule of one MSC-operated vessel by IMO number: each port with arrival and departure (ISO local, no zone), whether it is the current location, service and voyage number.

## 1. Choose this provider when

MSC (Mediterranean Shipping Company) public tools on msc.com: container, bill-of-lading and booking tracking with milestone events, point-to-point sailing schedules, vessel port-call schedules, port arrivals and departures, the port and vessel reference lists, first-EU-port arrivals and the customer advisories newsroom. Anonymous JSON endpoints behind the site's Sitecore pages.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "msc-com",
  "capability": "shipment-tracking/eu_first_port_arrivals",
  "options": {
    "vessel": "MSC"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `vessel` (string): Case-insensitive substring matched against vessel name and IMO. Example: `<vessel>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "msc-com",
    capability: "shipment-tracking/eu_first_port_arrivals",
    options: {
      vessel: "MSC",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "msc-com",
  "capability": "shipment-tracking/eu_first_port_arrivals",
  "options": {
    "vessel": "MSC"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "msc-com",
    "capability": "shipment-tracking/eu_first_port_arrivals",
    "options": {
      "vessel": "MSC"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'msc-com/shipment-tracking/eu_first_port_arrivals' \
  --options '{"vessel":"MSC"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "msc-com",
  "capability": "shipment-tracking/eu_first_port_arrivals",
  "options": {
    "vessel": "MSC"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "msc-com",
  "capability": "shipment-tracking/eu_first_port_arrivals",
  "options": {
    "vessel": "MSC"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "arrivals": [
    {
      "customs_office_reference": "DE004851",
      "eta": "2026-09-29T12:00:00",
      "first_european_port": "HAMBURG, DE (1st EU Port)",
      "imo": "9720500",
      "vessel_name": "MSC SASHA",
      "voyage_number": "MA640A"
    },
    {
      "customs_office_reference": "NL000396",
      "eta": "2026-09-29T12:00:00",
      "first_european_port": "ROTTERDAM, NL (1st EU Port)",
      "imo": "1031159",
      "vessel_name": "MSC MARIA LAURA",
      "voyage_number": "NA639A"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-09-30T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9540065",
      "vessel_name": "MSC AUDREY",
      "voyage_number": "QX639E"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-09-30T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9484429",
      "vessel_name": "MSC CLORINDA",
      "voyage_number": "QX639E"
    },
    {
      "customs_office_reference": "BE101000",
      "eta": "2026-10-01T12:00:00",
      "first_european_port": "ANTWERP, BE (1st EU Port)",
      "imo": "9409041",
      "vessel_name": "MSC WEST V",
      "voyage_number": "03E38"
    },
    {
      "customs_office_reference": "DE004851",
      "eta": "2026-10-01T12:00:00",
      "first_european_port": "HAMBURG, DE (1st EU Port)",
      "imo": "9720500",
      "vessel_name": "MSC SASHA",
      "voyage_number": "MA640A"
    },
    {
      "customs_office_reference": "ES004611",
      "eta": "2026-10-02T12:00:00",
      "first_european_port": "VALENCIA, ES (1st EU Port)",
      "imo": "9605243",
      "vessel_name": "MSC NAIROBI X",
      "voyage_number": "NI635R"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-02T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "1016692",
      "vessel_name": "MSC ADELE",
      "voyage_number": "NA635R"
    },
    {
      "customs_office_reference": "NL000396",
      "eta": "2026-10-03T12:00:00",
      "first_european_port": "ROTTERDAM, NL (1st EU Port)",
      "imo": "1016692",
      "vessel_name": "MSC ADELE",
      "voyage_number": "NA640A"
    },
    {
      "customs_office_reference": "ES003591",
      "eta": "2026-10-04T12:00:00",
      "first_european_port": "LAS PALMAS, ES (1st EU Port)",
      "imo": "9605267",
      "vessel_name": "MSC AJACCIO",
      "voyage_number": "MM637R"
    },
    {
      "customs_office_reference": "GB000080",
      "eta": "2026-10-04T12:00:00",
      "first_european_port": "LIVERPOOL, GB (1st UK Port)",
      "imo": "9351593",
      "vessel_name": "MSC ANGELA",
      "voyage_number": "12W39"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-04T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "1031159",
      "vessel_name": "MSC MARIA LAURA",
      "voyage_number": "NA639A"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-04T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9720500",
      "vessel_name": "MSC SASHA",
      "voyage_number": "MA630R"
    },
    {
      "customs_office_reference": "DE004851",
      "eta": "2026-10-06T12:00:00",
      "first_european_port": "HAMBURG, DE (1st EU Port)",
      "imo": "1031159",
      "vessel_name": "MSC MARIA LAURA",
      "voyage_number": "NA639A"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-10-07T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9932062",
      "vessel_name": "MSC FREYA",
      "voyage_number": "QX640E"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-08T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9605243",
      "vessel_name": "MSC NAIROBI X",
      "voyage_number": "NI635R"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-09T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9618305",
      "vessel_name": "MSC ATHENS",
      "voyage_number": "NA636R"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-09T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9304435",
      "vessel_name": "MSC JOANNA",
      "voyage_number": "MA632R"
    },
    {
      "customs_office_reference": "ES004611",
      "eta": "2026-10-10T12:00:00",
      "first_european_port": "VALENCIA, ES (1st EU Port)",
      "imo": "9842061",
      "vessel_name": "MSC JOSSELINE",
      "voyage_number": "QX638E"
    },
    {
      "customs_office_reference": "GB000080",
      "eta": "2026-10-10T12:00:00",
      "first_european_port": "LIVERPOOL, GB (1st UK Port)",
      "imo": "9409041",
      "vessel_name": "MSC WEST V",
      "voyage_number": "04W40"
    },
    {
      "customs_office_reference": "IT172100",
      "eta": "2026-10-10T12:00:00",
      "first_european_port": "GIOIA TAURO, IT (1st EU Port)",
      "imo": "9842061",
      "vessel_name": "MSC JOSSELINE",
      "voyage_number": "QX638E"
    },
    {
      "customs_office_reference": "NL000396",
      "eta": "2026-10-10T12:00:00",
      "first_european_port": "ROTTERDAM, NL (1st EU Port)",
      "imo": "9618305",
      "vessel_name": "MSC ATHENS",
      "voyage_number": "NA641A"
    },
    {
      "customs_office_reference": "ES003591",
      "eta": "2026-10-11T12:00:00",
      "first_european_port": "LAS PALMAS, ES (1st EU Port)",
      "imo": "9702077",
      "vessel_name": "MSC MELINE",
      "voyage_number": "MM638R"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-11T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9304435",
      "vessel_name": "MSC JOANNA",
      "voyage_number": "MA632R"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-10-15T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9927299",
      "vessel_name": "MSC KAYLEY",
      "voyage_number": "QX641E"
    },
    {
      "customs_office_reference": "NL000396",
      "eta": "2026-10-15T12:00:00",
      "first_european_port": "ROTTERDAM, NL (1st EU Port)",
      "imo": "9618305",
      "vessel_name": "MSC ATHENS",
      "voyage_number": "NI638A"
    },
    {
      "customs_office_reference": "BE101000",
      "eta": "2026-10-16T12:00:00",
      "first_european_port": "ANTWERP, BE (1st EU Port)",
      "imo": "9181663",
      "vessel_name": "MSC MATILDE V",
      "voyage_number": "10E40"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-16T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9695028",
      "vessel_name": "MSC SOFIA PAZ",
      "voyage_number": "NA637R"
    },
    {
      "customs_office_reference": "NL000396",
      "eta": "2026-10-16T12:00:00",
      "first_european_port": "ROTTERDAM, NL (1st EU Port)",
      "imo": "9290531",
      "vessel_name": "MSC PAMELA",
      "voyage_number": "MA642A"
    },
    {
      "customs_office_reference": "GB000051",
      "eta": "2026-10-17T12:00:00",
      "first_european_port": "FELIXSTOWE, GB (1st UK Port)",
      "imo": "9932907",
      "vessel_name": "MSC VICTORIA",
      "voyage_number": "FW635W"
    },
    {
      "customs_office_reference": "NL000396",
      "eta": "2026-10-17T12:00:00",
      "first_european_port": "ROTTERDAM, NL (1st EU Port)",
      "imo": "9695028",
      "vessel_name": "MSC SOFIA PAZ",
      "voyage_number": "NA642A"
    },
    {
      "customs_office_reference": "ES003591",
      "eta": "2026-10-18T12:00:00",
      "first_european_port": "LAS PALMAS, ES (1st EU Port)",
      "imo": "9619438",
      "vessel_name": "MSC ALBANY",
      "voyage_number": "MM639R"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-18T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9318046",
      "vessel_name": "MSC TOKYO",
      "voyage_number": "MA633R"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-10-18T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9932062",
      "vessel_name": "MSC FREYA",
      "voyage_number": "QX640E"
    },
    {
      "customs_office_reference": "NL000396",
      "eta": "2026-10-18T12:00:00",
      "first_european_port": "ROTTERDAM, NL (1st EU Port)",
      "imo": "9695028",
      "vessel_name": "MSC SOFIA PAZ",
      "voyage_number": "NA643A"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-19T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9290531",
      "vessel_name": "MSC PAMELA",
      "voyage_number": "MA632R"
    },
    {
      "customs_office_reference": "BE101000",
      "eta": "2026-10-20T12:00:00",
      "first_european_port": "ANTWERP, BE (1st EU Port)",
      "imo": "9932907",
      "vessel_name": "MSC VICTORIA",
      "voyage_number": "FW635W"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-10-20T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9309447",
      "vessel_name": "MSC RANIA VIII",
      "voyage_number": "FD637W"
    },
    {
      "customs_office_reference": "DE004851",
      "eta": "2026-10-21T12:00:00",
      "first_european_port": "HAMBURG, DE (1st EU Port)",
      "imo": "9290531",
      "vessel_name": "MSC PAMELA",
      "voyage_number": "MA642A"
    },
    {
      "customs_office_reference": "FR006420",
      "eta": "2026-10-21T12:00:00",
      "first_european_port": "POINTE DES GALETS, RE (1st EU Port)",
      "imo": "9293777",
      "vessel_name": "MSC NEW HAVEN VIII",
      "voyage_number": "MA638A"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-10-23T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9720471",
      "vessel_name": "MSC JEONGMIN",
      "voyage_number": "FD637W"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-23T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9702106",
      "vessel_name": "MSC BRUNELLA",
      "voyage_number": "NI638R"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-23T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9336048",
      "vessel_name": "MSC SINDY",
      "voyage_number": "MA634R"
    },
    {
      "customs_office_reference": "DE004851",
      "eta": "2026-10-24T12:00:00",
      "first_european_port": "HAMBURG, DE (1st EU Port)",
      "imo": "9290531",
      "vessel_name": "MSC PAMELA",
      "voyage_number": "MA643A"
    },
    {
      "customs_office_reference": "DE004851",
      "eta": "2026-10-24T12:00:00",
      "first_european_port": "HAMBURG, DE (1st EU Port)",
      "imo": "9318046",
      "vessel_name": "MSC TOKYO",
      "voyage_number": "MA643A"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-10-24T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9337444",
      "vessel_name": "MSC UBERTY VIII",
      "voyage_number": "FD637W"
    },
    {
      "customs_office_reference": "IT211101",
      "eta": "2026-10-24T12:00:00",
      "first_european_port": "GENOA, IT (1st EU Port)",
      "imo": "9337444",
      "vessel_name": "MSC UBERTY VIII",
      "voyage_number": "FD637W"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-10-24T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9465306",
      "vessel_name": "MSC RENEE XIII",
      "voyage_number": "QX642E"
    },
    {
      "customs_office_reference": "NL000396",
      "eta": "2026-10-24T12:00:00",
      "first_european_port": "ROTTERDAM, NL (1st EU Port)",
      "imo": "9404663",
      "vessel_name": "MSC SONIA",
      "voyage_number": "QB636W"
    },
    {
      "customs_office_reference": "BE101000",
      "eta": "2026-10-25T12:00:00",
      "first_european_port": "ANTWERP, BE (1st EU Port)",
      "imo": "9975583",
      "vessel_name": "MSC LE HAVRE",
      "voyage_number": "NN640R"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-10-25T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9198587",
      "vessel_name": "MSC CHIARA X",
      "voyage_number": "FD638W"
    },
    {
      "customs_office_reference": "GB000080",
      "eta": "2026-10-25T12:00:00",
      "first_european_port": "LIVERPOOL, GB (1st UK Port)",
      "imo": "9181663",
      "vessel_name": "MSC MATILDE V",
      "voyage_number": "11W42"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-25T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9248148",
      "vessel_name": "MSC PILAR VI",
      "voyage_number": "NI638R"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-25T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9336048",
      "vessel_name": "MSC SINDY",
      "voyage_number": "MA634R"
    },
    {
      "customs_office_reference": "NL000396",
      "eta": "2026-10-25T12:00:00",
      "first_european_port": "ROTTERDAM, NL (1st EU Port)",
      "imo": "9695028",
      "vessel_name": "MSC SOFIA PAZ",
      "voyage_number": "NZ644A"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-10-26T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9198587",
      "vessel_name": "MSC CHIARA X",
      "voyage_number": "FD638W"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-10-26T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9484467",
      "vessel_name": "MSC VANDYA",
      "voyage_number": "QX642E"
    },
    {
      "customs_office_reference": "DE004851",
      "eta": "2026-10-27T12:00:00",
      "first_european_port": "HAMBURG, DE (1st EU Port)",
      "imo": "9290531",
      "vessel_name": "MSC PAMELA",
      "voyage_number": "MA643A"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-10-27T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9198587",
      "vessel_name": "MSC CHIARA X",
      "voyage_number": "FD638W"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-10-27T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9720471",
      "vessel_name": "MSC JEONGMIN",
      "voyage_number": "FD638W"
    },
    {
      "customs_office_reference": "DE004851",
      "eta": "2026-10-28T12:00:00",
      "first_european_port": "HAMBURG, DE (1st EU Port)",
      "imo": "9336048",
      "vessel_name": "MSC SINDY",
      "voyage_number": "MA644A"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-28T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9290531",
      "vessel_name": "MSC PAMELA",
      "voyage_number": "MA632R"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-10-28T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9484467",
      "vessel_name": "MSC VANDYA",
      "voyage_number": "QX643E"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-10-29T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9465306",
      "vessel_name": "MSC RENEE XIII",
      "voyage_number": "QX642E"
    },
    {
      "customs_office_reference": "BE101000",
      "eta": "2026-10-30T12:00:00",
      "first_european_port": "ANTWERP, BE (1st EU Port)",
      "imo": "9351593",
      "vessel_name": "MSC ANGELA",
      "voyage_number": "12E42"
    },
    {
      "customs_office_reference": "IT211101",
      "eta": "2026-10-31T12:00:00",
      "first_european_port": "GENOA, IT (1st EU Port)",
      "imo": "9198587",
      "vessel_name": "MSC CHIARA X",
      "voyage_number": "FD638W"
    },
    {
      "customs_office_reference": "ES003591",
      "eta": "2026-11-01T12:00:00",
      "first_european_port": "LAS PALMAS, ES (1st EU Port)",
      "imo": "9605279",
      "vessel_name": "MSC AMALFI",
      "voyage_number": "MM641R"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-11-03T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "1031214",
      "vessel_name": "MSC CLELIA X",
      "voyage_number": "FD639W"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-11-03T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9393319",
      "vessel_name": "MSC RIKKU",
      "voyage_number": "FD639W"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-11-03T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9146467",
      "vessel_name": "MSC YUKTA X",
      "voyage_number": "FD639W"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-11-04T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9484467",
      "vessel_name": "MSC VANDYA",
      "voyage_number": "QX643E"
    },
    {
      "customs_office_reference": "DE004851",
      "eta": "2026-11-05T12:00:00",
      "first_european_port": "HAMBURG, DE (1st EU Port)",
      "imo": "9336048",
      "vessel_name": "MSC SINDY",
      "voyage_number": "MA645A"
    },
    {
      "customs_office_reference": "DE004851",
      "eta": "2026-11-05T12:00:00",
      "first_european_port": "HAMBURG, DE (1st EU Port)",
      "imo": "9318046",
      "vessel_name": "MSC TOKYO",
      "voyage_number": "MA644A"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-11-06T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9146467",
      "vessel_name": "MSC YUKTA X",
      "voyage_number": "FD639W"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-11-06T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9605231",
      "vessel_name": "MSC DAKAR X",
      "voyage_number": "NA640R"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-11-06T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9465253",
      "vessel_name": "MSC BENEDETTA XIII",
      "voyage_number": "QX644E"
    },
    {
      "customs_office_reference": "IT211101",
      "eta": "2026-11-07T12:00:00",
      "first_european_port": "GENOA, IT (1st EU Port)",
      "imo": "1031214",
      "vessel_name": "MSC CLELIA X",
      "voyage_number": "FD639W"
    },
    {
      "customs_office_reference": "NL000396",
      "eta": "2026-11-07T12:00:00",
      "first_european_port": "ROTTERDAM, NL (1st EU Port)",
      "imo": "9605231",
      "vessel_name": "MSC DAKAR X",
      "voyage_number": "NA645A"
    },
    {
      "customs_office_reference": "ES003591",
      "eta": "2026-11-08T12:00:00",
      "first_european_port": "LAS PALMAS, ES (1st EU Port)",
      "imo": "1031173",
      "vessel_name": "MSC MARIA MARILYN X",
      "voyage_number": "MM642R"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-11-08T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9619426",
      "vessel_name": "MSC ALTAMIRA",
      "voyage_number": "MA636R"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-11-09T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9305702",
      "vessel_name": "MSC MADELEINE",
      "voyage_number": "FD641W"
    },
    {
      "customs_office_reference": "DE004851",
      "eta": "2026-11-11T12:00:00",
      "first_european_port": "HAMBURG, DE (1st EU Port)",
      "imo": "9619426",
      "vessel_name": "MSC ALTAMIRA",
      "voyage_number": "MA646A"
    },
    {
      "customs_office_reference": "DE004851",
      "eta": "2026-11-11T12:00:00",
      "first_european_port": "HAMBURG, DE (1st EU Port)",
      "imo": "9619426",
      "vessel_name": "MSC ALTAMIRA",
      "voyage_number": "MA647A"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-11-11T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9540065",
      "vessel_name": "MSC AUDREY",
      "voyage_number": "QX645E"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-11-11T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9465253",
      "vessel_name": "MSC BENEDETTA XIII",
      "voyage_number": "QX645E"
    },
    {
      "customs_office_reference": "ES003591",
      "eta": "2026-11-13T12:00:00",
      "first_european_port": "LAS PALMAS, ES (1st EU Port)",
      "imo": "1031173",
      "vessel_name": "MSC MARIA MARILYN X",
      "voyage_number": "MM642R"
    },
    {
      "customs_office_reference": "IT211101",
      "eta": "2026-11-14T12:00:00",
      "first_european_port": "GENOA, IT (1st EU Port)",
      "imo": "9304411",
      "vessel_name": "MSC ESTHI",
      "voyage_number": "FD640W"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-11-15T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9695016",
      "vessel_name": "MSC ALINA",
      "voyage_number": "MA637R"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-11-17T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9214898",
      "vessel_name": "MSC NICOLE X",
      "voyage_number": "FD641W"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-11-17T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9318058",
      "vessel_name": "MSC TEXAS",
      "voyage_number": "FD641W"
    }
  ],
  "count": 90,
  "observed_at_ms": 1791131411385,
  "source_url": "https://www.msc.com/en/tools/vsa",
  "total_arrivals": 97,
  "vessel": "MSC"
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Eu first port arrivals

- Capability: `shipment-tracking/eu_first_port_arrivals`
- Description: MSC's VSA tool: upcoming vessel arrivals at their first EU port (vessel, IMO, voyage, port, ETA, customs office reference), optionally filtered by vessel name or IMO substring. One MSC response lists every vessel; the filter is applied client-side.
- Instructions: EU customs pre-arrival work: which MSC vessel/voyage enters the EU where and when, and the customs office code.
- Cost: 5 credits per call
- Capability file: [Eu first port arrivals](https://firecrawl.dev/alexandria/agents/providers/msc-com/shipment-tracking/eu_first_port_arrivals)

Accepted options:
- `vessel` (string): Case-insensitive substring matched against vessel name and IMO. Example: `<vessel>`

Response schema example:
```json
{
  "arrivals": [
    {
      "customs_office_reference": "DE004851",
      "eta": "2026-09-29T12:00:00",
      "first_european_port": "HAMBURG, DE (1st EU Port)",
      "imo": "9720500",
      "vessel_name": "MSC SASHA",
      "voyage_number": "MA640A"
    },
    {
      "customs_office_reference": "NL000396",
      "eta": "2026-09-29T12:00:00",
      "first_european_port": "ROTTERDAM, NL (1st EU Port)",
      "imo": "1031159",
      "vessel_name": "MSC MARIA LAURA",
      "voyage_number": "NA639A"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-09-30T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9540065",
      "vessel_name": "MSC AUDREY",
      "voyage_number": "QX639E"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-09-30T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9484429",
      "vessel_name": "MSC CLORINDA",
      "voyage_number": "QX639E"
    },
    {
      "customs_office_reference": "BE101000",
      "eta": "2026-10-01T12:00:00",
      "first_european_port": "ANTWERP, BE (1st EU Port)",
      "imo": "9409041",
      "vessel_name": "MSC WEST V",
      "voyage_number": "03E38"
    },
    {
      "customs_office_reference": "DE004851",
      "eta": "2026-10-01T12:00:00",
      "first_european_port": "HAMBURG, DE (1st EU Port)",
      "imo": "9720500",
      "vessel_name": "MSC SASHA",
      "voyage_number": "MA640A"
    },
    {
      "customs_office_reference": "ES004611",
      "eta": "2026-10-02T12:00:00",
      "first_european_port": "VALENCIA, ES (1st EU Port)",
      "imo": "9605243",
      "vessel_name": "MSC NAIROBI X",
      "voyage_number": "NI635R"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-02T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "1016692",
      "vessel_name": "MSC ADELE",
      "voyage_number": "NA635R"
    },
    {
      "customs_office_reference": "NL000396",
      "eta": "2026-10-03T12:00:00",
      "first_european_port": "ROTTERDAM, NL (1st EU Port)",
      "imo": "1016692",
      "vessel_name": "MSC ADELE",
      "voyage_number": "NA640A"
    },
    {
      "customs_office_reference": "ES003591",
      "eta": "2026-10-04T12:00:00",
      "first_european_port": "LAS PALMAS, ES (1st EU Port)",
      "imo": "9605267",
      "vessel_name": "MSC AJACCIO",
      "voyage_number": "MM637R"
    },
    {
      "customs_office_reference": "GB000080",
      "eta": "2026-10-04T12:00:00",
      "first_european_port": "LIVERPOOL, GB (1st UK Port)",
      "imo": "9351593",
      "vessel_name": "MSC ANGELA",
      "voyage_number": "12W39"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-04T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "1031159",
      "vessel_name": "MSC MARIA LAURA",
      "voyage_number": "NA639A"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-04T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9720500",
      "vessel_name": "MSC SASHA",
      "voyage_number": "MA630R"
    },
    {
      "customs_office_reference": "DE004851",
      "eta": "2026-10-06T12:00:00",
      "first_european_port": "HAMBURG, DE (1st EU Port)",
      "imo": "1031159",
      "vessel_name": "MSC MARIA LAURA",
      "voyage_number": "NA639A"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-10-07T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9932062",
      "vessel_name": "MSC FREYA",
      "voyage_number": "QX640E"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-08T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9605243",
      "vessel_name": "MSC NAIROBI X",
      "voyage_number": "NI635R"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-09T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9618305",
      "vessel_name": "MSC ATHENS",
      "voyage_number": "NA636R"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-09T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9304435",
      "vessel_name": "MSC JOANNA",
      "voyage_number": "MA632R"
    },
    {
      "customs_office_reference": "ES004611",
      "eta": "2026-10-10T12:00:00",
      "first_european_port": "VALENCIA, ES (1st EU Port)",
      "imo": "9842061",
      "vessel_name": "MSC JOSSELINE",
      "voyage_number": "QX638E"
    },
    {
      "customs_office_reference": "GB000080",
      "eta": "2026-10-10T12:00:00",
      "first_european_port": "LIVERPOOL, GB (1st UK Port)",
      "imo": "9409041",
      "vessel_name": "MSC WEST V",
      "voyage_number": "04W40"
    },
    {
      "customs_office_reference": "IT172100",
      "eta": "2026-10-10T12:00:00",
      "first_european_port": "GIOIA TAURO, IT (1st EU Port)",
      "imo": "9842061",
      "vessel_name": "MSC JOSSELINE",
      "voyage_number": "QX638E"
    },
    {
      "customs_office_reference": "NL000396",
      "eta": "2026-10-10T12:00:00",
      "first_european_port": "ROTTERDAM, NL (1st EU Port)",
      "imo": "9618305",
      "vessel_name": "MSC ATHENS",
      "voyage_number": "NA641A"
    },
    {
      "customs_office_reference": "ES003591",
      "eta": "2026-10-11T12:00:00",
      "first_european_port": "LAS PALMAS, ES (1st EU Port)",
      "imo": "9702077",
      "vessel_name": "MSC MELINE",
      "voyage_number": "MM638R"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-11T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9304435",
      "vessel_name": "MSC JOANNA",
      "voyage_number": "MA632R"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-10-15T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9927299",
      "vessel_name": "MSC KAYLEY",
      "voyage_number": "QX641E"
    },
    {
      "customs_office_reference": "NL000396",
      "eta": "2026-10-15T12:00:00",
      "first_european_port": "ROTTERDAM, NL (1st EU Port)",
      "imo": "9618305",
      "vessel_name": "MSC ATHENS",
      "voyage_number": "NI638A"
    },
    {
      "customs_office_reference": "BE101000",
      "eta": "2026-10-16T12:00:00",
      "first_european_port": "ANTWERP, BE (1st EU Port)",
      "imo": "9181663",
      "vessel_name": "MSC MATILDE V",
      "voyage_number": "10E40"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-16T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9695028",
      "vessel_name": "MSC SOFIA PAZ",
      "voyage_number": "NA637R"
    },
    {
      "customs_office_reference": "NL000396",
      "eta": "2026-10-16T12:00:00",
      "first_european_port": "ROTTERDAM, NL (1st EU Port)",
      "imo": "9290531",
      "vessel_name": "MSC PAMELA",
      "voyage_number": "MA642A"
    },
    {
      "customs_office_reference": "GB000051",
      "eta": "2026-10-17T12:00:00",
      "first_european_port": "FELIXSTOWE, GB (1st UK Port)",
      "imo": "9932907",
      "vessel_name": "MSC VICTORIA",
      "voyage_number": "FW635W"
    },
    {
      "customs_office_reference": "NL000396",
      "eta": "2026-10-17T12:00:00",
      "first_european_port": "ROTTERDAM, NL (1st EU Port)",
      "imo": "9695028",
      "vessel_name": "MSC SOFIA PAZ",
      "voyage_number": "NA642A"
    },
    {
      "customs_office_reference": "ES003591",
      "eta": "2026-10-18T12:00:00",
      "first_european_port": "LAS PALMAS, ES (1st EU Port)",
      "imo": "9619438",
      "vessel_name": "MSC ALBANY",
      "voyage_number": "MM639R"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-18T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9318046",
      "vessel_name": "MSC TOKYO",
      "voyage_number": "MA633R"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-10-18T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9932062",
      "vessel_name": "MSC FREYA",
      "voyage_number": "QX640E"
    },
    {
      "customs_office_reference": "NL000396",
      "eta": "2026-10-18T12:00:00",
      "first_european_port": "ROTTERDAM, NL (1st EU Port)",
      "imo": "9695028",
      "vessel_name": "MSC SOFIA PAZ",
      "voyage_number": "NA643A"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-19T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9290531",
      "vessel_name": "MSC PAMELA",
      "voyage_number": "MA632R"
    },
    {
      "customs_office_reference": "BE101000",
      "eta": "2026-10-20T12:00:00",
      "first_european_port": "ANTWERP, BE (1st EU Port)",
      "imo": "9932907",
      "vessel_name": "MSC VICTORIA",
      "voyage_number": "FW635W"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-10-20T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9309447",
      "vessel_name": "MSC RANIA VIII",
      "voyage_number": "FD637W"
    },
    {
      "customs_office_reference": "DE004851",
      "eta": "2026-10-21T12:00:00",
      "first_european_port": "HAMBURG, DE (1st EU Port)",
      "imo": "9290531",
      "vessel_name": "MSC PAMELA",
      "voyage_number": "MA642A"
    },
    {
      "customs_office_reference": "FR006420",
      "eta": "2026-10-21T12:00:00",
      "first_european_port": "POINTE DES GALETS, RE (1st EU Port)",
      "imo": "9293777",
      "vessel_name": "MSC NEW HAVEN VIII",
      "voyage_number": "MA638A"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-10-23T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9720471",
      "vessel_name": "MSC JEONGMIN",
      "voyage_number": "FD637W"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-23T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9702106",
      "vessel_name": "MSC BRUNELLA",
      "voyage_number": "NI638R"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-23T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9336048",
      "vessel_name": "MSC SINDY",
      "voyage_number": "MA634R"
    },
    {
      "customs_office_reference": "DE004851",
      "eta": "2026-10-24T12:00:00",
      "first_european_port": "HAMBURG, DE (1st EU Port)",
      "imo": "9290531",
      "vessel_name": "MSC PAMELA",
      "voyage_number": "MA643A"
    },
    {
      "customs_office_reference": "DE004851",
      "eta": "2026-10-24T12:00:00",
      "first_european_port": "HAMBURG, DE (1st EU Port)",
      "imo": "9318046",
      "vessel_name": "MSC TOKYO",
      "voyage_number": "MA643A"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-10-24T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9337444",
      "vessel_name": "MSC UBERTY VIII",
      "voyage_number": "FD637W"
    },
    {
      "customs_office_reference": "IT211101",
      "eta": "2026-10-24T12:00:00",
      "first_european_port": "GENOA, IT (1st EU Port)",
      "imo": "9337444",
      "vessel_name": "MSC UBERTY VIII",
      "voyage_number": "FD637W"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-10-24T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9465306",
      "vessel_name": "MSC RENEE XIII",
      "voyage_number": "QX642E"
    },
    {
      "customs_office_reference": "NL000396",
      "eta": "2026-10-24T12:00:00",
      "first_european_port": "ROTTERDAM, NL (1st EU Port)",
      "imo": "9404663",
      "vessel_name": "MSC SONIA",
      "voyage_number": "QB636W"
    },
    {
      "customs_office_reference": "BE101000",
      "eta": "2026-10-25T12:00:00",
      "first_european_port": "ANTWERP, BE (1st EU Port)",
      "imo": "9975583",
      "vessel_name": "MSC LE HAVRE",
      "voyage_number": "NN640R"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-10-25T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9198587",
      "vessel_name": "MSC CHIARA X",
      "voyage_number": "FD638W"
    },
    {
      "customs_office_reference": "GB000080",
      "eta": "2026-10-25T12:00:00",
      "first_european_port": "LIVERPOOL, GB (1st UK Port)",
      "imo": "9181663",
      "vessel_name": "MSC MATILDE V",
      "voyage_number": "11W42"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-25T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9248148",
      "vessel_name": "MSC PILAR VI",
      "voyage_number": "NI638R"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-25T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9336048",
      "vessel_name": "MSC SINDY",
      "voyage_number": "MA634R"
    },
    {
      "customs_office_reference": "NL000396",
      "eta": "2026-10-25T12:00:00",
      "first_european_port": "ROTTERDAM, NL (1st EU Port)",
      "imo": "9695028",
      "vessel_name": "MSC SOFIA PAZ",
      "voyage_number": "NZ644A"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-10-26T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9198587",
      "vessel_name": "MSC CHIARA X",
      "voyage_number": "FD638W"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-10-26T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9484467",
      "vessel_name": "MSC VANDYA",
      "voyage_number": "QX642E"
    },
    {
      "customs_office_reference": "DE004851",
      "eta": "2026-10-27T12:00:00",
      "first_european_port": "HAMBURG, DE (1st EU Port)",
      "imo": "9290531",
      "vessel_name": "MSC PAMELA",
      "voyage_number": "MA643A"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-10-27T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9198587",
      "vessel_name": "MSC CHIARA X",
      "voyage_number": "FD638W"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-10-27T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9720471",
      "vessel_name": "MSC JEONGMIN",
      "voyage_number": "FD638W"
    },
    {
      "customs_office_reference": "DE004851",
      "eta": "2026-10-28T12:00:00",
      "first_european_port": "HAMBURG, DE (1st EU Port)",
      "imo": "9336048",
      "vessel_name": "MSC SINDY",
      "voyage_number": "MA644A"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-10-28T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9290531",
      "vessel_name": "MSC PAMELA",
      "voyage_number": "MA632R"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-10-28T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9484467",
      "vessel_name": "MSC VANDYA",
      "voyage_number": "QX643E"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-10-29T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9465306",
      "vessel_name": "MSC RENEE XIII",
      "voyage_number": "QX642E"
    },
    {
      "customs_office_reference": "BE101000",
      "eta": "2026-10-30T12:00:00",
      "first_european_port": "ANTWERP, BE (1st EU Port)",
      "imo": "9351593",
      "vessel_name": "MSC ANGELA",
      "voyage_number": "12E42"
    },
    {
      "customs_office_reference": "IT211101",
      "eta": "2026-10-31T12:00:00",
      "first_european_port": "GENOA, IT (1st EU Port)",
      "imo": "9198587",
      "vessel_name": "MSC CHIARA X",
      "voyage_number": "FD638W"
    },
    {
      "customs_office_reference": "ES003591",
      "eta": "2026-11-01T12:00:00",
      "first_european_port": "LAS PALMAS, ES (1st EU Port)",
      "imo": "9605279",
      "vessel_name": "MSC AMALFI",
      "voyage_number": "MM641R"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-11-03T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "1031214",
      "vessel_name": "MSC CLELIA X",
      "voyage_number": "FD639W"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-11-03T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9393319",
      "vessel_name": "MSC RIKKU",
      "voyage_number": "FD639W"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-11-03T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9146467",
      "vessel_name": "MSC YUKTA X",
      "voyage_number": "FD639W"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-11-04T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9484467",
      "vessel_name": "MSC VANDYA",
      "voyage_number": "QX643E"
    },
    {
      "customs_office_reference": "DE004851",
      "eta": "2026-11-05T12:00:00",
      "first_european_port": "HAMBURG, DE (1st EU Port)",
      "imo": "9336048",
      "vessel_name": "MSC SINDY",
      "voyage_number": "MA645A"
    },
    {
      "customs_office_reference": "DE004851",
      "eta": "2026-11-05T12:00:00",
      "first_european_port": "HAMBURG, DE (1st EU Port)",
      "imo": "9318046",
      "vessel_name": "MSC TOKYO",
      "voyage_number": "MA644A"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-11-06T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9146467",
      "vessel_name": "MSC YUKTA X",
      "voyage_number": "FD639W"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-11-06T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9605231",
      "vessel_name": "MSC DAKAR X",
      "voyage_number": "NA640R"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-11-06T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9465253",
      "vessel_name": "MSC BENEDETTA XIII",
      "voyage_number": "QX644E"
    },
    {
      "customs_office_reference": "IT211101",
      "eta": "2026-11-07T12:00:00",
      "first_european_port": "GENOA, IT (1st EU Port)",
      "imo": "1031214",
      "vessel_name": "MSC CLELIA X",
      "voyage_number": "FD639W"
    },
    {
      "customs_office_reference": "NL000396",
      "eta": "2026-11-07T12:00:00",
      "first_european_port": "ROTTERDAM, NL (1st EU Port)",
      "imo": "9605231",
      "vessel_name": "MSC DAKAR X",
      "voyage_number": "NA645A"
    },
    {
      "customs_office_reference": "ES003591",
      "eta": "2026-11-08T12:00:00",
      "first_european_port": "LAS PALMAS, ES (1st EU Port)",
      "imo": "1031173",
      "vessel_name": "MSC MARIA MARILYN X",
      "voyage_number": "MM642R"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-11-08T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9619426",
      "vessel_name": "MSC ALTAMIRA",
      "voyage_number": "MA636R"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-11-09T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9305702",
      "vessel_name": "MSC MADELEINE",
      "voyage_number": "FD641W"
    },
    {
      "customs_office_reference": "DE004851",
      "eta": "2026-11-11T12:00:00",
      "first_european_port": "HAMBURG, DE (1st EU Port)",
      "imo": "9619426",
      "vessel_name": "MSC ALTAMIRA",
      "voyage_number": "MA646A"
    },
    {
      "customs_office_reference": "DE004851",
      "eta": "2026-11-11T12:00:00",
      "first_european_port": "HAMBURG, DE (1st EU Port)",
      "imo": "9619426",
      "vessel_name": "MSC ALTAMIRA",
      "voyage_number": "MA647A"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-11-11T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9540065",
      "vessel_name": "MSC AUDREY",
      "voyage_number": "QX645E"
    },
    {
      "customs_office_reference": "IT322102",
      "eta": "2026-11-11T12:00:00",
      "first_european_port": "TRIESTE, IT (1st EU Port)",
      "imo": "9465253",
      "vessel_name": "MSC BENEDETTA XIII",
      "voyage_number": "QX645E"
    },
    {
      "customs_office_reference": "ES003591",
      "eta": "2026-11-13T12:00:00",
      "first_european_port": "LAS PALMAS, ES (1st EU Port)",
      "imo": "1031173",
      "vessel_name": "MSC MARIA MARILYN X",
      "voyage_number": "MM642R"
    },
    {
      "customs_office_reference": "IT211101",
      "eta": "2026-11-14T12:00:00",
      "first_european_port": "GENOA, IT (1st EU Port)",
      "imo": "9304411",
      "vessel_name": "MSC ESTHI",
      "voyage_number": "FD640W"
    },
    {
      "customs_office_reference": "GB000170",
      "eta": "2026-11-15T12:00:00",
      "first_european_port": "LONDON GATEWAY PORT, GB (1st UK Port)",
      "imo": "9695016",
      "vessel_name": "MSC ALINA",
      "voyage_number": "MA637R"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-11-17T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9214898",
      "vessel_name": "MSC NICOLE X",
      "voyage_number": "FD641W"
    },
    {
      "customs_office_reference": "ES002911",
      "eta": "2026-11-17T12:00:00",
      "first_european_port": "MALAGA, ES (1st EU Port)",
      "imo": "9318058",
      "vessel_name": "MSC TEXAS",
      "voyage_number": "FD641W"
    }
  ],
  "count": 90,
  "observed_at_ms": 1791131411385,
  "source_url": "https://www.msc.com/en/tools/vsa",
  "total_arrivals": 97,
  "vessel": "MSC"
}
```

### List advisories

- Capability: `shipment-tracking/list_advisories`
- Description: MSC newsroom customer advisories and price announcements, newest first, with optional publication date range and 0-based pagination; each row has MSC's article id, title, absolute URL, date (ISO) and type, plus the facet counts MSC returns.
- Instructions: Surcharges, service changes, port congestion notices and rate announcements MSC has published; paginate with `page` while `next_page` is not null.
- Cost: 5 credits per call
- Capability file: [List advisories](https://firecrawl.dev/alexandria/agents/providers/msc-com/shipment-tracking/list_advisories)

Accepted options:
- `date_from` (string): Earliest publication date, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<date_from>`
- `date_to` (string): Latest publication date, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<date_to>`
- `page` (number): 0-based page. Example: `0`
- `page_size` (number): page_size Example: `8`

Response schema example:
```json
{
  "count": 5,
  "date_from": null,
  "date_to": null,
  "facets": [
    {
      "code": "price_communication_tags",
      "name": "Price Communications",
      "values": [
        {
          "name": "ECA - Emission Control Area Surcharge",
          "occurrences": 1,
          "selected": false
        }
      ]
    }
  ],
  "next_page": 1,
  "observed_at_ms": 1791131396051,
  "page": 0,
  "page_size": 5,
  "results": [
    {
      "date": "2026-09-30",
      "id": "bd670a6ce79a4a69a126f07db8af3593",
      "title": "Piracy Risk and Suez Canal Surcharges - Trade from Asia to Mediterranean (inc. West Med, East Med, Adriatic and North Africa)",
      "type": "Price Announcements",
      "url": "https://www.msc.com/en/newsroom/customer-advisories/2026/september/prs-and-scs-trade-from-asia-to-mediterranean"
    },
    {
      "date": "2026-09-30",
      "id": "ea1e0d80f32e45daa17456564e097b04",
      "title": "2026 Golden Week Sailing Programme - Trade Asia to USA",
      "type": "Customer Advisories",
      "url": "https://www.msc.com/en/newsroom/customer-advisories/2026/september/2026-golden-week-sailing-programme-trade-asia-to-usa"
    },
    {
      "date": "2026-09-28",
      "id": "c23811f4fea44f6b89efa9d73920fe40",
      "title": "Trade from Asia to NWC, Mediterranean (Inc. West Med, East Med, Adriatic and North Africa) and Black Sea",
      "type": "Price Announcements",
      "url": "https://www.msc.com/en/newsroom/customer-advisories/2026/september/pa-trade-asia-to-nwc-med-and-black-sea"
    },
    {
      "date": "2026-09-28",
      "id": "4e36110ddbdc44998685b222a12159e5",
      "title": "Regional Cost Recovery Surcharge - Trade from Europe to Middle East (UAE and Gulf)",
      "type": "Price Announcements",
      "url": "https://www.msc.com/en/newsroom/customer-advisories/2026/september/rcr-surcharge-trade-from-europe-to-middle-east"
    },
    {
      "date": "2026-09-14",
      "id": "42cbab3509354eeabe306ba2bfdd1f52",
      "title": "Golden Week Sailing Programme - Emerald Service",
      "type": "Customer Advisories",
      "url": "https://www.msc.com/en/newsroom/customer-advisories/2026/september/golden-week-sailing-programme---emerald-service"
    }
  ],
  "source_url": "https://www.msc.com/en/newsroom/customer-advisories",
  "total_results": 1457
}
```

### List ports

- Capability: `shipment-tracking/list_ports`
- Description: MSC's schedule-search reference list of ports (MSC port id, name, UN/LOCODE, country, coordinates) and countries, optionally filtered by a name/UN-LOCODE substring and/or ISO-2 country. Resolves a UN/LOCODE or port name to the MSC port id and UN/LOCODE the schedule functions take.
- Instructions: Before search_sailing_schedule or port_arrivals_departures when you have a port name and need its MSC port id or UN/LOCODE.
- Cost: 5 credits per call
- Capability file: [List ports](https://firecrawl.dev/alexandria/agents/providers/msc-com/shipment-tracking/list_ports)

Accepted options:
- `country` (string): ISO-2 country code filter, e.g. US. Pattern: ^[A-Za-z]{2}$. Example: `<country>`
- `query` (string): Case-insensitive substring matched against the port name and UN/LOCODE. Example: `<query>`

Response schema example:
```json
{
  "count": 1,
  "countries": [
    {
      "country_id": "7",
      "iso_code": "AL",
      "name": "ALBANIA"
    },
    {
      "country_id": "60",
      "iso_code": "DZ",
      "name": "ALGERIA"
    },
    {
      "country_id": "9",
      "iso_code": "AO",
      "name": "ANGOLA"
    },
    {
      "country_id": "11",
      "iso_code": "AR",
      "name": "ARGENTINA"
    },
    {
      "country_id": "14",
      "iso_code": "AU",
      "name": "AUSTRALIA"
    },
    {
      "country_id": "31",
      "iso_code": "BS",
      "name": "BAHAMAS"
    },
    {
      "country_id": "23",
      "iso_code": "BH",
      "name": "BAHRAIN"
    },
    {
      "country_id": "19",
      "iso_code": "BD",
      "name": "BANGLADESH"
    },
    {
      "country_id": "18",
      "iso_code": "BB",
      "name": "BARBADOS"
    },
    {
      "country_id": "20",
      "iso_code": "BE",
      "name": "BELGIUM"
    },
    {
      "country_id": "35",
      "iso_code": "BZ",
      "name": "BELIZE"
    },
    {
      "country_id": "25",
      "iso_code": "BJ",
      "name": "BENIN"
    },
    {
      "country_id": "30",
      "iso_code": "BR",
      "name": "BRAZIL"
    },
    {
      "country_id": "27",
      "iso_code": "BN",
      "name": "BRUNEI DARUSSALAM"
    },
    {
      "country_id": "22",
      "iso_code": "BG",
      "name": "BULGARIA"
    },
    {
      "country_id": "115",
      "iso_code": "KH",
      "name": "CAMBODIA"
    },
    {
      "country_id": "45",
      "iso_code": "CM",
      "name": "CAMEROON"
    },
    {
      "country_id": "36",
      "iso_code": "CA",
      "name": "CANADA"
    },
    {
      "country_id": "50",
      "iso_code": "CV",
      "name": "CAPE VERDE"
    },
    {
      "country_id": "44",
      "iso_code": "CL",
      "name": "CHILE"
    },
    {
      "country_id": "46",
      "iso_code": "CN",
      "name": "CHINA"
    },
    {
      "country_id": "47",
      "iso_code": "CO",
      "name": "COLOMBIA"
    },
    {
      "country_id": "117",
      "iso_code": "KM",
      "name": "COMOROS"
    },
    {
      "country_id": "40",
      "iso_code": "CG",
      "name": "CONGO"
    },
    {
      "country_id": "38",
      "iso_code": "CD",
      "name": "CONGO, THE DEMOCRATIC REPUBLIC OF THE"
    },
    {
      "country_id": "43",
      "iso_code": "CK",
      "name": "COOK ISLANDS"
    },
    {
      "country_id": "48",
      "iso_code": "CR",
      "name": "COSTA RICA"
    },
    {
      "country_id": "42",
      "iso_code": "CI",
      "name": "COTE D'IVOIRE"
    },
    {
      "country_id": "96",
      "iso_code": "HR",
      "name": "CROATIA"
    },
    {
      "country_id": "53",
      "iso_code": "CY",
      "name": "CYPRUS"
    },
    {
      "country_id": "57",
      "iso_code": "DK",
      "name": "DENMARK"
    },
    {
      "country_id": "56",
      "iso_code": "DJ",
      "name": "DJIBOUTI"
    },
    {
      "country_id": "58",
      "iso_code": "DM",
      "name": "DOMINICA"
    },
    {
      "country_id": "59",
      "iso_code": "DO",
      "name": "DOMINICAN REPUBLIC"
    },
    {
      "country_id": "61",
      "iso_code": "EC",
      "name": "ECUADOR"
    },
    {
      "country_id": "63",
      "iso_code": "EG",
      "name": "EGYPT"
    },
    {
      "country_id": "207",
      "iso_code": "SV",
      "name": "EL SALVADOR"
    },
    {
      "country_id": "62",
      "iso_code": "EE",
      "name": "ESTONIA"
    },
    {
      "country_id": "69",
      "iso_code": "FJ",
      "name": "FIJI"
    },
    {
      "country_id": "68",
      "iso_code": "FI",
      "name": "FINLAND"
    },
    {
      "country_id": "73",
      "iso_code": "FR",
      "name": "FRANCE"
    },
    {
      "country_id": "173",
      "iso_code": "PF",
      "name": "FRENCH POLYNESIA"
    },
    {
      "country_id": "74",
      "iso_code": "GA",
      "name": "GABON"
    },
    {
      "country_id": "83",
      "iso_code": "GM",
      "name": "GAMBIA"
    },
    {
      "country_id": "77",
      "iso_code": "GE",
      "name": "GEORGIA"
    },
    {
      "country_id": "55",
      "iso_code": "DE",
      "name": "GERMANY"
    },
    {
      "country_id": "80",
      "iso_code": "GH",
      "name": "GHANA"
    },
    {
      "country_id": "87",
      "iso_code": "GR",
      "name": "GREECE"
    },
    {
      "country_id": "76",
      "iso_code": "GD",
      "name": "GRENADA"
    },
    {
      "country_id": "89",
      "iso_code": "GT",
      "name": "GUATEMALA"
    },
    {
      "country_id": "84",
      "iso_code": "GN",
      "name": "GUINEA"
    },
    {
      "country_id": "91",
      "iso_code": "GW",
      "name": "GUINEA-BISSAU"
    },
    {
      "country_id": "92",
      "iso_code": "GY",
      "name": "GUYANA"
    },
    {
      "country_id": "97",
      "iso_code": "HT",
      "name": "HAITI"
    },
    {
      "country_id": "95",
      "iso_code": "HN",
      "name": "HONDURAS"
    },
    {
      "country_id": "93",
      "iso_code": "HK",
      "name": "HONG KONG"
    },
    {
      "country_id": "107",
      "iso_code": "IS",
      "name": "ICELAND"
    },
    {
      "country_id": "103",
      "iso_code": "IN",
      "name": "INDIA"
    },
    {
      "country_id": "99",
      "iso_code": "ID",
      "name": "INDONESIA"
    },
    {
      "country_id": "105",
      "iso_code": "IQ",
      "name": "IRAQ"
    },
    {
      "country_id": "100",
      "iso_code": "IE",
      "name": "IRELAND"
    },
    {
      "country_id": "101",
      "iso_code": "IL",
      "name": "ISRAEL"
    },
    {
      "country_id": "108",
      "iso_code": "IT",
      "name": "ITALY"
    },
    {
      "country_id": "110",
      "iso_code": "JM",
      "name": "JAMAICA"
    },
    {
      "country_id": "112",
      "iso_code": "JP",
      "name": "JAPAN"
    },
    {
      "country_id": "111",
      "iso_code": "JO",
      "name": "JORDAN"
    },
    {
      "country_id": "113",
      "iso_code": "KE",
      "name": "KENYA"
    },
    {
      "country_id": "120",
      "iso_code": "KR",
      "name": "KOREA, REPUBLIC OF"
    },
    {
      "country_id": "121",
      "iso_code": "KW",
      "name": "KUWAIT"
    },
    {
      "country_id": "133",
      "iso_code": "LV",
      "name": "LATVIA"
    },
    {
      "country_id": "125",
      "iso_code": "LB",
      "name": "LEBANON"
    },
    {
      "country_id": "129",
      "iso_code": "LR",
      "name": "LIBERIA"
    },
    {
      "country_id": "134",
      "iso_code": "LY",
      "name": "LIBYA"
    },
    {
      "country_id": "131",
      "iso_code": "LT",
      "name": "LITHUANIA"
    },
    {
      "country_id": "140",
      "iso_code": "MG",
      "name": "MADAGASCAR"
    },
    {
      "country_id": "156",
      "iso_code": "MY",
      "name": "MALAYSIA"
    },
    {
      "country_id": "153",
      "iso_code": "MV",
      "name": "MALDIVES"
    },
    {
      "country_id": "151",
      "iso_code": "MT",
      "name": "MALTA"
    },
    {
      "country_id": "149",
      "iso_code": "MR",
      "name": "MAURITANIA"
    },
    {
      "country_id": "152",
      "iso_code": "MU",
      "name": "MAURITIUS"
    },
    {
      "country_id": "245",
      "iso_code": "YT",
      "name": "MAYOTTE"
    },
    {
      "country_id": "155",
      "iso_code": "MX",
      "name": "MEXICO"
    },
    {
      "country_id": "138",
      "iso_code": "ME",
      "name": "MONTENEGRO"
    },
    {
      "country_id": "135",
      "iso_code": "MA",
      "name": "MOROCCO"
    },
    {
      "country_id": "157",
      "iso_code": "MZ",
      "name": "MOZAMBIQUE"
    },
    {
      "country_id": "144",
      "iso_code": "MM",
      "name": "MYANMAR"
    },
    {
      "country_id": "158",
      "iso_code": "NA",
      "name": "NAMIBIA"
    },
    {
      "country_id": "164",
      "iso_code": "NL",
      "name": "NETHERLANDS"
    },
    {
      "country_id": "159",
      "iso_code": "NC",
      "name": "NEW CALEDONIA"
    },
    {
      "country_id": "169",
      "iso_code": "NZ",
      "name": "NEW ZEALAND"
    },
    {
      "country_id": "163",
      "iso_code": "NI",
      "name": "NICARAGUA"
    },
    {
      "country_id": "162",
      "iso_code": "NG",
      "name": "NIGERIA"
    },
    {
      "country_id": "165",
      "iso_code": "NO",
      "name": "NORWAY"
    },
    {
      "country_id": "170",
      "iso_code": "OM",
      "name": "OMAN"
    },
    {
      "country_id": "176",
      "iso_code": "PK",
      "name": "PAKISTAN"
    },
    {
      "country_id": "171",
      "iso_code": "PA",
      "name": "PANAMA"
    },
    {
      "country_id": "183",
      "iso_code": "PY",
      "name": "PARAGUAY"
    },
    {
      "country_id": "172",
      "iso_code": "PE",
      "name": "PERU"
    },
    {
      "country_id": "175",
      "iso_code": "PH",
      "name": "PHILIPPINES"
    },
    {
      "country_id": "177",
      "iso_code": "PL",
      "name": "POLAND"
    },
    {
      "country_id": "181",
      "iso_code": "PT",
      "name": "PORTUGAL"
    },
    {
      "country_id": "180",
      "iso_code": "PR",
      "name": "PUERTO RICO"
    },
    {
      "country_id": "184",
      "iso_code": "QA",
      "name": "QATAR"
    },
    {
      "country_id": "185",
      "iso_code": "RE",
      "name": "REUNION"
    },
    {
      "country_id": "186",
      "iso_code": "RO",
      "name": "ROMANIA"
    },
    {
      "country_id": "188",
      "iso_code": "RU",
      "name": "RUSSIAN FEDERATION"
    },
    {
      "country_id": "126",
      "iso_code": "LC",
      "name": "SAINT LUCIA"
    },
    {
      "country_id": "234",
      "iso_code": "VC",
      "name": "SAINT VINCENT AND THE GRENADINES"
    },
    {
      "country_id": "190",
      "iso_code": "SA",
      "name": "SAUDI ARABIA"
    },
    {
      "country_id": "202",
      "iso_code": "SN",
      "name": "SENEGAL"
    },
    {
      "country_id": "200",
      "iso_code": "SL",
      "name": "SIERRA LEONE"
    },
    {
      "country_id": "195",
      "iso_code": "SG",
      "name": "SINGAPORE"
    },
    {
      "country_id": "208",
      "iso_code": "SX",
      "name": "SINT MAARTEN (DUTCH PART)"
    },
    {
      "country_id": "197",
      "iso_code": "SI",
      "name": "SLOVENIA"
    },
    {
      "country_id": "203",
      "iso_code": "SO",
      "name": "SOMALIA"
    },
    {
      "country_id": "246",
      "iso_code": "ZA",
      "name": "SOUTH AFRICA"
    },
    {
      "country_id": "66",
      "iso_code": "ES",
      "name": "SPAIN"
    },
    {
      "country_id": "128",
      "iso_code": "LK",
      "name": "SRI LANKA"
    },
    {
      "country_id": "193",
      "iso_code": "SD",
      "name": "SUDAN"
    },
    {
      "country_id": "204",
      "iso_code": "SR",
      "name": "SURINAME"
    },
    {
      "country_id": "194",
      "iso_code": "SE",
      "name": "SWEDEN"
    },
    {
      "country_id": "209",
      "iso_code": "SY",
      "name": "SYRIAN ARAB REPUBLIC"
    },
    {
      "country_id": "225",
      "iso_code": "TW",
      "name": "TAIWAN"
    },
    {
      "country_id": "226",
      "iso_code": "TZ",
      "name": "TANZANIA, UNITED REPUBLIC OF"
    },
    {
      "country_id": "215",
      "iso_code": "TH",
      "name": "THAILAND"
    },
    {
      "country_id": "218",
      "iso_code": "TL",
      "name": "TIMOR-LESTE"
    },
    {
      "country_id": "214",
      "iso_code": "TG",
      "name": "TOGO"
    },
    {
      "country_id": "223",
      "iso_code": "TT",
      "name": "TRINIDAD AND TOBAGO"
    },
    {
      "country_id": "220",
      "iso_code": "TN",
      "name": "TUNISIA"
    },
    {
      "country_id": "222",
      "iso_code": "TR",
      "name": "TURKIYE"
    },
    {
      "country_id": "211",
      "iso_code": "TC",
      "name": "TURKS AND CAICOS ISLANDS"
    },
    {
      "country_id": "227",
      "iso_code": "UA",
      "name": "UKRAINE"
    },
    {
      "country_id": "3",
      "iso_code": "AE",
      "name": "UNITED ARAB EMIRATES"
    },
    {
      "country_id": "75",
      "iso_code": "GB",
      "name": "UNITED KINGDOM"
    },
    {
      "country_id": "230",
      "iso_code": "US",
      "name": "UNITED STATES"
    },
    {
      "country_id": "231",
      "iso_code": "UY",
      "name": "URUGUAY"
    },
    {
      "country_id": "235",
      "iso_code": "VE",
      "name": "VENEZUELA"
    },
    {
      "country_id": "238",
      "iso_code": "VN",
      "name": "VIET NAM"
    },
    {
      "country_id": "244",
      "iso_code": "YE",
      "name": "YEMEN"
    }
  ],
  "country": null,
  "observed_at_ms": 1791131339897,
  "ports": [
    {
      "country_iso_code": "US",
      "country_name": "UNITED STATES",
      "latitude": 29.913554,
      "longitude": -90.106185,
      "name": "NEW ORLEANS",
      "port_id": 78,
      "un_locode": "USMSY"
    }
  ],
  "query": "new orleans",
  "source_url": "https://www.msc.com/en/search-a-schedule",
  "total_ports": 581
}
```

### List vessels

- Capability: `shipment-tracking/list_vessels`
- Description: MSC's vessel reference list (vessel name and IMO / Lloyd's number) used by the vessel-schedule search, optionally filtered by a name or IMO substring. Duplicate rows MSC publishes are collapsed.
- Instructions: Find the IMO number for vessel_schedule from a vessel name, or check that a vessel is in MSC's schedule system.
- Cost: 5 credits per call
- Capability file: [List vessels](https://firecrawl.dev/alexandria/agents/providers/msc-com/shipment-tracking/list_vessels)

Accepted options:
- `query` (string): Case-insensitive substring matched against the vessel name and IMO number. Example: `<query>`

Response schema example:
```json
{
  "count": 1,
  "observed_at_ms": 1791131353757,
  "query": "tianshan",
  "source_url": "https://www.msc.com/en/search-a-schedule",
  "total_vessels": 1451,
  "vessels": [
    {
      "imo": "9305477",
      "name": "MSC TIANSHAN"
    }
  ]
}
```

### Port arrivals departures

- Capability: `shipment-tracking/port_arrivals_departures`
- Description: Upcoming vessel arrivals and departures at one port (UN/LOCODE) from MSC's schedule tool, with voyage, service, vessel details and the departure cut-off rules. MSC answers 'no results' both for an unknown code and for a port without sailings; that is reported as not_found.
- Instructions: What MSC vessels are due at a port in the coming days; port codes come from list_ports or tracking events.
- Cost: 5 credits per call
- Capability file: [Port arrivals departures](https://firecrawl.dev/alexandria/agents/providers/msc-com/shipment-tracking/port_arrivals_departures)

Accepted options:
- `language` (string): Response language for labels (service names and messages stay as MSC publishes them). Example: `en`
- `port_code` (string, required): UN/LOCODE, e.g. USMSY. Pattern: ^[A-Za-z]{5}$. Example: `<port_code>`

Response schema example:
```json
{
  "arrival_count": 18,
  "arrivals": [
    {
      "arrival": "2026-10-01T04:06:00",
      "imo": "1013169",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "NWC - USA - SAWC",
      "vessel_flag": "LR",
      "vessel_name": "MSC SERENA",
      "vessel_year_built": 2025,
      "voyage_number": "NX636R"
    },
    {
      "arrival": "2026-10-01T10:24:00",
      "imo": "9315018",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "WEC - NWC TO SPAIN / PORTUGAL SERVICE II",
      "vessel_flag": "CY",
      "vessel_name": "WEC DE HOOGH",
      "vessel_year_built": 2005,
      "voyage_number": "EH636A"
    },
    {
      "arrival": "2026-10-01T11:06:00",
      "imo": "9964211",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "BRITANNIA",
      "vessel_flag": "LR",
      "vessel_name": "MSC ROME",
      "vessel_year_built": 2024,
      "voyage_number": "QB631W"
    },
    {
      "arrival": "2026-10-02T07:27:00",
      "imo": "1031159",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "NWC TO SAEC - STRING I",
      "vessel_flag": "LR",
      "vessel_name": "MSC MARIA LAURA",
      "vessel_year_built": 2026,
      "voyage_number": "NA634R"
    },
    {
      "arrival": "2026-10-03T21:00:00",
      "imo": "9964211",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "BRITANNIA",
      "vessel_flag": "LR",
      "vessel_name": "MSC ROME",
      "vessel_year_built": 2024,
      "voyage_number": "QB631W"
    },
    {
      "arrival": "2026-10-03T21:00:00",
      "imo": "9778090",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "NWC TO SOUTH AFRICA",
      "vessel_flag": "PT",
      "vessel_name": "MSC YASHI B",
      "vessel_year_built": 2018,
      "voyage_number": "NZ636R"
    },
    {
      "arrival": "2026-10-04T06:00:00",
      "imo": "9792694",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "GRIFFIN SERVICE",
      "vessel_flag": "LR",
      "vessel_name": "YM THRONE",
      "vessel_year_built": 2022,
      "voyage_number": "021E"
    },
    {
      "arrival": "2026-10-04T06:00:00",
      "imo": "9181675",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "NWC - MOROCCO - WAF SERVICE",
      "vessel_flag": "LR",
      "vessel_name": "MSC SARAH V",
      "vessel_year_built": 2000,
      "voyage_number": "WM640A"
    },
    {
      "arrival": "2026-10-05T01:00:00",
      "imo": "9939137",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "SILK SERVICE",
      "vessel_flag": "LR",
      "vessel_name": "ONE INNOVATION",
      "vessel_year_built": 2023,
      "voyage_number": "011W"
    },
    {
      "arrival": "2026-10-05T17:00:00",
      "imo": "9702089",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "LEVANTE EXPRESS",
      "vessel_flag": "PT",
      "vessel_name": "MSC VITA",
      "vessel_year_built": 2015,
      "voyage_number": "NL638A"
    },
    {
      "arrival": "2026-10-05T17:00:00",
      "imo": "9745653",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "NWC TO IPAK",
      "vessel_flag": "PT",
      "vessel_name": "MSC ROMANE",
      "vessel_year_built": 2017,
      "voyage_number": "IP640R"
    },
    {
      "arrival": "2026-10-06T12:00:00",
      "imo": "9242651",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "BALTIC LOOP 02",
      "vessel_flag": "PT",
      "vessel_name": "MSC AMY",
      "vessel_year_built": 2002,
      "voyage_number": "BB639B"
    },
    {
      "arrival": "2026-10-07T07:00:00",
      "imo": "9946740",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "BRITANNIA",
      "vessel_flag": "LR",
      "vessel_name": "MSC CLAIRE",
      "vessel_year_built": 2026,
      "voyage_number": "QB632W"
    },
    {
      "arrival": "2026-10-07T13:00:00",
      "imo": "9974553",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "MEXICO GULF EXPRESS",
      "vessel_flag": "LR",
      "vessel_name": "MSC NAMIBIA",
      "vessel_year_built": 2025,
      "voyage_number": "NH640A"
    },
    {
      "arrival": "2026-10-08T07:00:00",
      "imo": "9535204",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "NWC TO IPAK",
      "vessel_flag": "SG",
      "vessel_name": "HUBERT SCHULTE",
      "vessel_year_built": 2012,
      "voyage_number": "IP641R"
    },
    {
      "arrival": "2026-10-08T12:00:00",
      "imo": "9227285",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "NWC - MOROCCO - WAF SERVICE",
      "vessel_flag": "LR",
      "vessel_name": "MSC YANG R",
      "vessel_year_built": 2002,
      "voyage_number": "WM635R"
    },
    {
      "arrival": "2026-10-09T01:00:00",
      "imo": "9372494",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "NWC TO WAF SERVICE",
      "vessel_flag": "PA",
      "vessel_name": "MSC SORAYA",
      "vessel_year_built": 2008,
      "voyage_number": "NY637R"
    },
    {
      "arrival": "2026-10-09T01:00:00",
      "imo": "9315006",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "WEC - NWC TO SPAIN / PORTUGAL SERVICE II",
      "vessel_flag": "CY",
      "vessel_name": "WEC VAN RIJN",
      "vessel_year_built": 2005,
      "voyage_number": "EH637A"
    }
  ],
  "departure_count": 19,
  "departures": [
    {
      "cut_offs": [
        {
          "display": "Liaise with your local office",
          "type": "No Gate In Cut Off Found"
        },
        {
          "display": "Liaise with your local office",
          "type": "No SI Cut Off Found"
        },
        {
          "display": "48 Hours before Loading Start",
          "type": "Vgm Cut-off"
        }
      ],
      "departure": "2026-10-01T00:05:00",
      "imo": "9605152",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "LEVANTE EXPRESS",
      "vessel_flag": "PT",
      "vessel_name": "MSC LAGOS X",
      "vessel_year_built": 2013,
      "voyage_number": "NL637A"
    },
    {
      "cut_offs": [
        {
          "display": "Liaise with your local office",
          "type": "No Gate In Cut Off Found"
        },
        {
          "display": "Liaise with your local office",
          "type": "No SI Cut Off Found"
        },
        {
          "display": "48 Hours before Loading Start",
          "type": "Vgm Cut-off"
        }
      ],
      "departure": "2026-10-01T04:25:00",
      "imo": "9723241",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "NWC TO SAEC - STRING I",
      "vessel_flag": "LR",
      "vessel_name": "CZECH",
      "vessel_year_built": 2015,
      "voyage_number": "NA638A"
    },
    {
      "cut_offs": [
        {
          "display": "Liaise with your local office",
          "type": "No Gate In Cut Off Found"
        },
        {
          "display": "Liaise with your local office",
          "type": "No SI Cut Off Found"
        },
        {
          "display": "48 Hours before Loading Start",
          "type": "Vgm Cut-off"
        }
      ],
      "departure": "2026-10-01T15:42:00",
      "imo": "9315018",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "WEC - NWC TO SPAIN / PORTUGAL SERVICE II",
      "vessel_flag": "CY",
      "vessel_name": "WEC DE HOOGH",
      "vessel_year_built": 2005,
      "voyage_number": "EH636A"
    },
    {
      "cut_offs": [
        {
          "display": "Liaise with your local office",
          "type": "No Gate In Cut Off Found"
        },
        {
          "display": "Liaise with your local office",
          "type": "No SI Cut Off Found"
        },
        {
          "display": "48 Hours before Loading Start",
          "type": "Vgm Cut-off"
        }
      ],
      "departure": "2026-10-01T23:12:00",
      "imo": "1013169",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "NWC - USA - SAWC",
      "vessel_flag": "LR",
      "vessel_name": "MSC SERENA",
      "vessel_year_built": 2025,
      "voyage_number": "NX640A"
    },
    {
      "cut_offs": [
        {
          "display": "Liaise with your local office",
          "type": "No Gate In Cut Off Found"
        },
        {
          "display": "Liaise with your local office",
          "type": "No SI Cut Off Found"
        },
        {
          "display": "48 Hours before Loading Start",
          "type": "Vgm Cut-off"
        }
      ],
      "departure": "2026-10-03T08:00:00",
      "imo": "9933004",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "SILK SERVICE",
      "vessel_flag": "LR",
      "vessel_name": "ONE INFINITY",
      "vessel_year_built": 2023,
      "voyage_number": "010E"
    },
    {
      "cut_offs": [
        {
          "display": "Liaise with your local office",
          "type": "No Gate In Cut Off Found"
        },
        {
          "display": "Liaise with your local office",
          "type": "No SI Cut Off Found"
        },
        {
          "display": "48 Hours before Loading Start",
          "type": "Vgm Cut-off"
        }
      ],
      "departure": "2026-10-03T08:00:00",
      "imo": "1031159",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "NWC TO SAEC - STRING I",
      "vessel_flag": "LR",
      "vessel_name": "MSC MARIA LAURA",
      "vessel_year_built": 2026,
      "voyage_number": "NA639A"
    },
    {
      "cut_offs": [
        {
          "display": "Liaise with your local office",
          "type": "No Gate In Cut Off Found"
        },
        {
          "display": "Liaise with your local office",
          "type": "No SI Cut Off Found"
        },
        {
          "display": "48 Hours before Loading Start",
          "type": "Vgm Cut-off"
        }
      ],
      "departure": "2026-10-03T19:00:00",
      "imo": "9964211",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "BRITANNIA",
      "vessel_flag": "LR",
      "vessel_name": "MSC ROME",
      "vessel_year_built": 2024,
      "voyage_number": "QB631W"
    },
    {
      "cut_offs": [
        {
          "display": "Liaise with your local office",
          "type": "No Gate In Cut Off Found"
        },
        {
          "display": "Liaise with your local office",
          "type": "No SI Cut Off Found"
        },
        {
          "display": "48 Hours before Loading Start",
          "type": "Vgm Cut-off"
        }
      ],
      "departure": "2026-10-04T12:00:00",
      "imo": "9964211",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "BRITANNIA",
      "vessel_flag": "LR",
      "vessel_name": "MSC ROME",
      "vessel_year_built": 2024,
      "voyage_number": "QB631W"
    },
    {
      "cut_offs": [
        {
          "display": "Liaise with your local office",
          "type": "No Gate In Cut Off Found"
        },
        {
          "display": "Liaise with your local office",
          "type": "No SI Cut Off Found"
        },
        {
          "display": "48 Hours before Loading Start",
          "type": "Vgm Cut-off"
        }
      ],
      "departure": "2026-10-04T19:00:00",
      "imo": "9181675",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "NWC - MOROCCO - WAF SERVICE",
      "vessel_flag": "LR",
      "vessel_name": "MSC SARAH V",
      "vessel_year_built": 2000,
      "voyage_number": "WM640A"
    },
    {
      "cut_offs": [
        {
          "display": "Liaise with your local office",
          "type": "No Gate In Cut Off Found"
        },
        {
          "display": "Liaise with your local office",
          "type": "No SI Cut Off Found"
        },
        {
          "display": "48 Hours before Loading Start",
          "type": "Vgm Cut-off"
        }
      ],
      "departure": "2026-10-05T12:00:00",
      "imo": "9778090",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "NWC - USA - SAWC",
      "vessel_flag": "PT",
      "vessel_name": "MSC YASHI B",
      "vessel_year_built": 2018,
      "voyage_number": "NX639A"
    },
    {
      "cut_offs": [
        {
          "display": "Liaise with your local office",
          "type": "No Gate In Cut Off Found"
        },
        {
          "display": "Liaise with your local office",
          "type": "No SI Cut Off Found"
        },
        {
          "display": "48 Hours before Loading Start",
          "type": "Vgm Cut-off"
        }
      ],
      "departure": "2026-10-06T10:00:00",
      "imo": "9702089",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "LEVANTE EXPRESS",
      "vessel_flag": "PT",
      "vessel_name": "MSC VITA",
      "vessel_year_built": 2015,
      "voyage_number": "NL638A"
    },
    {
      "cut_offs": [
        {
          "display": "Liaise with your local office",
          "type": "No Gate In Cut Off Found"
        },
        {
          "display": "Liaise with your local office",
          "type": "No SI Cut Off Found"
        },
        {
          "display": "48 Hours before Loading Start",
          "type": "Vgm Cut-off"
        }
      ],
      "departure": "2026-10-06T13:00:00",
      "imo": "9745653",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "NWC TO IPAK",
      "vessel_flag": "PT",
      "vessel_name": "MSC ROMANE",
      "vessel_year_built": 2017,
      "voyage_number": "IP640R"
    },
    {
      "cut_offs": [
        {
          "display": "Liaise with your local office",
          "type": "No Gate In Cut Off Found"
        },
        {
          "display": "Liaise with your local office",
          "type": "No SI Cut Off Found"
        },
        {
          "display": "48 Hours before Loading Start",
          "type": "Vgm Cut-off"
        }
      ],
      "departure": "2026-10-06T19:00:00",
      "imo": "9792694",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "GRIFFIN SERVICE",
      "vessel_flag": "LR",
      "vessel_name": "YM THRONE",
      "vessel_year_built": 2022,
      "voyage_number": "021E"
    },
    {
      "cut_offs": [
        {
          "display": "Liaise with your local office",
          "type": "No Gate In Cut Off Found"
        },
        {
          "display": "Liaise with your local office",
          "type": "No SI Cut Off Found"
        },
        {
          "display": "48 Hours before Loading Start",
          "type": "Vgm Cut-off"
        }
      ],
      "departure": "2026-10-06T22:00:00",
      "imo": "9242651",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "BALTIC LOOP 02",
      "vessel_flag": "PT",
      "vessel_name": "MSC AMY",
      "vessel_year_built": 2002,
      "voyage_number": "BB639B"
    },
    {
      "cut_offs": [
        {
          "display": "Liaise with your local office",
          "type": "No Gate In Cut Off Found"
        },
        {
          "display": "Liaise with your local office",
          "type": "No SI Cut Off Found"
        },
        {
          "display": "48 Hours before Loading Start",
          "type": "Vgm Cut-off"
        }
      ],
      "departure": "2026-10-08T00:00:00",
      "imo": "9974553",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "MEXICO GULF EXPRESS",
      "vessel_flag": "LR",
      "vessel_name": "MSC NAMIBIA",
      "vessel_year_built": 2025,
      "voyage_number": "NH640A"
    },
    {
      "cut_offs": [
        {
          "display": "Liaise with your local office",
          "type": "No Gate In Cut Off Found"
        },
        {
          "display": "Liaise with your local office",
          "type": "No SI Cut Off Found"
        },
        {
          "display": "48 Hours before Loading Start",
          "type": "Vgm Cut-off"
        }
      ],
      "departure": "2026-10-08T07:00:00",
      "imo": "9535204",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "NWC TO SOUTH AFRICA",
      "vessel_flag": "SG",
      "vessel_name": "HUBERT SCHULTE",
      "vessel_year_built": 2012,
      "voyage_number": "NZ641A"
    },
    {
      "cut_offs": [
        {
          "display": "Liaise with your local office",
          "type": "No Gate In Cut Off Found"
        },
        {
          "display": "Liaise with your local office",
          "type": "No SI Cut Off Found"
        },
        {
          "display": "48 Hours before Loading Start",
          "type": "Vgm Cut-off"
        }
      ],
      "departure": "2026-10-09T04:00:00",
      "imo": "9227285",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "NWC - MOROCCO - WAF SERVICE",
      "vessel_flag": "LR",
      "vessel_name": "MSC YANG R",
      "vessel_year_built": 2002,
      "voyage_number": "WM641A"
    },
    {
      "cut_offs": [
        {
          "display": "Liaise with your local office",
          "type": "No Gate In Cut Off Found"
        },
        {
          "display": "Liaise with your local office",
          "type": "No SI Cut Off Found"
        },
        {
          "display": "48 Hours before Loading Start",
          "type": "Vgm Cut-off"
        }
      ],
      "departure": "2026-10-09T16:00:00",
      "imo": "9939137",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "SILK SERVICE",
      "vessel_flag": "LR",
      "vessel_name": "ONE INNOVATION",
      "vessel_year_built": 2023,
      "voyage_number": "011E"
    },
    {
      "cut_offs": [
        {
          "display": "Liaise with your local office",
          "type": "No Gate In Cut Off Found"
        },
        {
          "display": "Liaise with your local office",
          "type": "No SI Cut Off Found"
        },
        {
          "display": "48 Hours before Loading Start",
          "type": "Vgm Cut-off"
        }
      ],
      "departure": "2026-10-09T16:00:00",
      "imo": "9372494",
      "port_name": "ROTTERDAM",
      "port_un_locode": "NLRTM",
      "service_name": "NWC TO IPAK",
      "vessel_flag": "PA",
      "vessel_name": "MSC SORAYA",
      "vessel_year_built": 2008,
      "voyage_number": "IP641R"
    }
  ],
  "language": "en",
  "observed_at_ms": 1791131381524,
  "port_code": "NLRTM",
  "result_timestamp": "Search schedule results provided by MSC on 04.10.2026 at 18:29 Central Europe Standard Time",
  "source_url": "https://www.msc.com/en/search-a-schedule"
}
```

### Search sailing schedule

- Capability: `shipment-tracking/search_sailing_schedule`
- Description: Point-to-point sailing schedules from MSC's search-a-schedule tool: for an origin and destination port and an earliest departure date, every route (service, direct or transhipment, transit time, CO2 footprint) with its sailings (vessel, voyage, ETD/ETA, cut-offs, legs with vessels and ports). Ports are given as MSC port id or UN/LOCODE; UN/LOCODEs are resolved through MSC's port list.
- Instructions: Planning a shipment: which MSC sailings connect two ports from a date, how long they take and when cargo must be at the terminal.
- Cost: 5 credits per call
- Capability file: [Search sailing schedule](https://firecrawl.dev/alexandria/agents/providers/msc-com/shipment-tracking/search_sailing_schedule)

Accepted options:
- `from_date` (string): Earliest departure date, YYYY-MM-DD; defaults to today (UTC). MSC rejects past dates (invalid_input). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<from_date>`
- `from_port` (string, required): Origin port: MSC port id (digits, e.g. 78) or UN/LOCODE (5 letters, e.g. USMSY). Pattern: ^([0-9]{1,6}|[A-Za-z]{5})$. Example: `<from_port>`
- `include_port_calls` (boolean): Include every intermediate port call per leg (large). Example: `false`
- `language` (string): Response language for labels (service names and messages stay as MSC publishes them). Example: `en`
- `to_port` (string, required): Destination port: MSC port id or UN/LOCODE (e.g. GEPTI). Pattern: ^([0-9]{1,6}|[A-Za-z]{5})$. Example: `<to_port>`

Response schema example:
```json
{
  "from_date": "2026-10-04",
  "from_port": {
    "facility": null,
    "name": "NEW ORLEANS",
    "port_id": 78,
    "un_locode": "USMSY"
  },
  "language": "en",
  "observed_at_ms": 1791131361061,
  "result_timestamp": "Search schedule results provided by MSC on 04.10.2026 at 18:29 Central Europe Standard Time",
  "route_count": 1,
  "routes": [
    {
      "co2_footprint": "2.0308 Tons",
      "estimated_departure": "2026-10-07T23:00:00",
      "is_direct": false,
      "port_of_discharge": {
        "facility": null,
        "name": "POTI",
        "port_id": 13,
        "un_locode": "GEPTI"
      },
      "port_of_loading": {
        "facility": null,
        "name": "NEW ORLEANS",
        "port_id": 78,
        "un_locode": "USMSY"
      },
      "route_header_id": 9138506,
      "routing_type": "Transhipment",
      "sailings": [
        {
          "co2_footprint": "2.0308 Tons",
          "cut_offs": {
            "container_yard": "Mon 5th Oct 2026 16:00",
            "dangerous_cargo": "Fri 2nd Oct 2026 16:00",
            "reefer": "Mon 5th Oct 2026 16:00",
            "shipping_instructions": "Fri 2nd Oct 2026 16:00",
            "verified_gross_mass": "Mon 5th Oct 2026 12:00"
          },
          "estimated_arrival": "2026-11-08T18:15:00",
          "estimated_departure": "2026-10-07T23:00:00",
          "legs": [
            {
              "arrival_port": null,
              "co2_footprint": "0.8237 Tons",
              "departure_port": {
                "facility": "NAPOLEON AVENUE TERMINAL",
                "name": "NEW ORLEANS",
                "port_id": 78,
                "un_locode": "USMSY"
              },
              "estimated_arrival": null,
              "estimated_departure": "2026-10-07T23:00:00",
              "last_leg": false,
              "port_calls": [],
              "sequence": 1,
              "service_name": "MEDGULF SERVICE",
              "vessel": {
                "built_year": "1996",
                "flag": "LIBERIA",
                "flag_code": null,
                "imo": "9085534",
                "name": "KOTKA"
              },
              "voyage_number": "MG639E"
            },
            {
              "arrival_port": {
                "facility": "MEDCENTER CONTAINER TERMINAL",
                "name": "GIOIA TAURO",
                "port_id": 17,
                "un_locode": "ITGIT"
              },
              "co2_footprint": "1.0022 Tons",
              "departure_port": {
                "facility": "MEDCENTER CONTAINER TERMINAL",
                "name": "GIOIA TAURO",
                "port_id": 17,
                "un_locode": "ITGIT"
              },
              "estimated_arrival": "2026-10-25T02:15:00",
              "estimated_departure": "2026-10-29T01:00:00",
              "last_leg": false,
              "port_calls": [],
              "sequence": 2,
              "service_name": "TURKIYE TO NAF - BLACK SEA SERVICE",
              "vessel": {
                "built_year": "2006",
                "flag": "PANAMA",
                "flag_code": null,
                "imo": "9330264",
                "name": "MSC LEVANTE F"
              },
              "voyage_number": "YU642R"
            },
            {
              "arrival_port": {
                "facility": "ASYAPORT",
                "name": "TEKIRDAG (ASYAPORT)",
                "port_id": 1383,
                "un_locode": "TRTEK"
              },
              "co2_footprint": "0.2049 Tons",
              "departure_port": {
                "facility": "ASYAPORT",
                "name": "TEKIRDAG (ASYAPORT)",
                "port_id": 1383,
                "un_locode": "TRTEK"
              },
              "estimated_arrival": "2026-10-31T13:00:00",
              "estimated_departure": "2026-11-04T23:00:00",
              "last_leg": false,
              "port_calls": [],
              "sequence": 3,
              "service_name": "GEORGIA SERVICE STRING 4",
              "vessel": {
                "built_year": "1997",
                "flag": "TURKIYE",
                "flag_code": null,
                "imo": "9160920",
                "name": "MED URLA"
              },
              "voyage_number": "DC645A"
            },
            {
              "arrival_port": {
                "facility": "APM TERMINALS POTI",
                "name": "POTI",
                "port_id": 13,
                "un_locode": "GEPTI"
              },
              "co2_footprint": null,
              "departure_port": null,
              "estimated_arrival": "2026-11-08T18:15:00",
              "estimated_departure": null,
              "last_leg": true,
              "port_calls": [],
              "sequence": 4,
              "service_name": null,
              "vessel": null,
              "voyage_number": null
            }
          ],
          "total_transit_time": "32 days",
          "total_transit_time_hours": 768,
          "vessel_name": "KOTKA",
          "voyage_number": "MG639E"
        },
        {
          "co2_footprint": "2.0308 Tons",
          "cut_offs": {
            "container_yard": "Thu 8th Oct 2026 16:00",
            "dangerous_cargo": "Wed 7th Oct 2026 16:00",
            "reefer": "Thu 8th Oct 2026 16:00",
            "shipping_instructions": "Wed 7th Oct 2026 16:00",
            "verified_gross_mass": "Thu 8th Oct 2026 12:00"
          },
          "estimated_arrival": "2026-11-14T08:00:00",
          "estimated_departure": "2026-10-11T23:00:00",
          "legs": [
            {
              "arrival_port": null,
              "co2_footprint": "0.8237 Tons",
              "departure_port": {
                "facility": "NAPOLEON AVENUE TERMINAL",
                "name": "NEW ORLEANS",
                "port_id": 78,
                "un_locode": "USMSY"
              },
              "estimated_arrival": null,
              "estimated_departure": "2026-10-11T23:00:00",
              "last_leg": false,
              "port_calls": [],
              "sequence": 1,
              "service_name": "MEDGULF SERVICE",
              "vessel": {
                "built_year": "2012",
                "flag": "LIBERIA",
                "flag_code": null,
                "imo": "9619452",
                "name": "MSC ARICA"
              },
              "voyage_number": "MG640E"
            },
            {
              "arrival_port": {
                "facility": "MEDCENTER CONTAINER TERMINAL",
                "name": "GIOIA TAURO",
                "port_id": 17,
                "un_locode": "ITGIT"
              },
              "co2_footprint": "1.0022 Tons",
              "departure_port": {
                "facility": "MEDCENTER CONTAINER TERMINAL",
                "name": "GIOIA TAURO",
                "port_id": 17,
                "un_locode": "ITGIT"
              },
              "estimated_arrival": "2026-11-01T04:45:00",
              "estimated_departure": "2026-11-05T01:00:00",
              "last_leg": false,
              "port_calls": [],
              "sequence": 2,
              "service_name": "TURKIYE TO NAF - BLACK SEA SERVICE",
              "vessel": {
                "built_year": "2006",
                "flag": "PORTUGAL",
                "flag_code": null,
                "imo": "9319600",
                "name": "MSC AMANDA F"
              },
              "voyage_number": "YU643R"
            },
            {
              "arrival_port": {
                "facility": "ASYAPORT",
                "name": "TEKIRDAG (ASYAPORT)",
                "port_id": 1383,
                "un_locode": "TRTEK"
              },
              "co2_footprint": "0.2049 Tons",
              "departure_port": {
                "facility": "ASYAPORT",
                "name": "TEKIRDAG (ASYAPORT)",
                "port_id": 1383,
                "un_locode": "TRTEK"
              },
              "estimated_arrival": "2026-11-07T13:00:00",
              "estimated_departure": "2026-11-11T23:00:00",
              "last_leg": false,
              "port_calls": [],
              "sequence": 3,
              "service_name": "GEORGIA SERVICE STRING 4",
              "vessel": {
                "built_year": "2002",
                "flag": "TURKIYE",
                "flag_code": null,
                "imo": "9260536",
                "name": "BURAK BAYRAKTAR"
              },
              "voyage_number": "DC646A"
            },
            {
              "arrival_port": {
                "facility": "APM TERMINALS POTI",
                "name": "POTI",
                "port_id": 13,
                "un_locode": "GEPTI"
              },
              "co2_footprint": null,
              "departure_port": null,
              "estimated_arrival": "2026-11-14T08:00:00",
              "estimated_departure": null,
              "last_leg": true,
              "port_calls": [],
              "sequence": 4,
              "service_name": null,
              "vessel": null,
              "voyage_number": null
            }
          ],
          "total_transit_time": "34 days",
          "total_transit_time_hours": 816,
          "vessel_name": "MSC ARICA",
          "voyage_number": "MG640E"
        },
        {
          "co2_footprint": "2.0308 Tons",
          "cut_offs": {
            "container_yard": "Thu 15th Oct 2026 16:00",
            "dangerous_cargo": "Wed 14th Oct 2026 16:00",
            "reefer": "Thu 15th Oct 2026 16:00",
            "shipping_instructions": "Wed 14th Oct 2026 16:00",
            "verified_gross_mass": "Thu 15th Oct 2026 12:00"
          },
          "estimated_arrival": "2026-11-21T08:00:00",
          "estimated_departure": "2026-10-18T23:00:00",
          "legs": [
            {
              "arrival_port": null,
              "co2_footprint": "0.8237 Tons",
              "departure_port": {
                "facility": "NAPOLEON AVENUE TERMINAL",
                "name": "NEW ORLEANS",
                "port_id": 78,
                "un_locode": "USMSY"
              },
              "estimated_arrival": null,
              "estimated_departure": "2026-10-18T23:00:00",
              "last_leg": false,
              "port_calls": [],
              "sequence": 1,
              "service_name": "MEDGULF SERVICE",
              "vessel": {
                "built_year": "2002",
                "flag": "LIBERIA",
                "flag_code": null,
                "imo": "9231262",
                "name": "MSC SWEDEN VI"
              },
              "voyage_number": "MG641E"
            },
            {
              "arrival_port": {
                "facility": "MEDCENTER CONTAINER TERMINAL",
                "name": "GIOIA TAURO",
                "port_id": 17,
                "un_locode": "ITGIT"
              },
              "co2_footprint": "1.0022 Tons",
              "departure_port": {
                "facility": "MEDCENTER CONTAINER TERMINAL",
                "name": "GIOIA TAURO",
                "port_id": 17,
                "un_locode": "ITGIT"
              },
              "estimated_arrival": "2026-11-08T04:45:00",
              "estimated_departure": "2026-11-12T01:00:00",
              "last_leg": false,
              "port_calls": [],
              "sequence": 2,
              "service_name": "TURKIYE TO NAF - BLACK SEA SERVICE",
              "vessel": {
                "built_year": "2006",
                "flag": "ANTIGUA AND BARBUDA",
                "flag_code": null,
                "imo": "9306835",
                "name": "BILBAO TRADER"
              },
              "voyage_number": "YU644R"
            },
            {
              "arrival_port": {
                "facility": "ASYAPORT",
                "name": "TEKIRDAG (ASYAPORT)",
                "port_id": 1383,
                "un_locode": "TRTEK"
              },
              "co2_footprint": "0.2049 Tons",
              "departure_port": {
                "facility": "ASYAPORT",
                "name": "TEKIRDAG (ASYAPORT)",
                "port_id": 1383,
                "un_locode": "TRTEK"
              },
              "estimated_arrival": "2026-11-14T13:00:00",
              "estimated_departure": "2026-11-18T23:00:00",
              "last_leg": false,
              "port_calls": [],
              "sequence": 3,
              "service_name": "GEORGIA SERVICE STRING 4",
              "vessel": {
                "built_year": "2002",
                "flag": "TURKIYE",
                "flag_code": null,
                "imo": "9260536",
                "name": "BURAK BAYRAKTAR"
              },
              "voyage_number": "DC647A"
            },
            {
              "arrival_port": {
                "facility": "APM TERMINALS POTI",
                "name": "POTI",
                "port_id": 13,
                "un_locode": "GEPTI"
              },
              "co2_footprint": null,
              "departure_port": null,
              "estimated_arrival": "2026-11-21T08:00:00",
              "estimated_departure": null,
              "last_leg": true,
              "port_calls": [],
              "sequence": 4,
              "service_name": null,
              "vessel": null,
              "voyage_number": null
            }
          ],
          "total_transit_time": "34 days",
          "total_transit_time_hours": 816,
          "vessel_name": "MSC SWEDEN VI",
          "voyage_number": "MG641E"
        },
        {
          "co2_footprint": "2.0308 Tons",
          "cut_offs": {
            "container_yard": "Thu 22nd Oct 2026 16:00",
            "dangerous_cargo": "Wed 21st Oct 2026 16:00",
            "reefer": "Thu 22nd Oct 2026 16:00",
            "shipping_instructions": "Wed 21st Oct 2026 16:00",
            "verified_gross_mass": "Thu 22nd Oct 2026 12:00"
          },
          "estimated_arrival": "2026-11-28T09:00:00",
          "estimated_departure": "2026-10-25T23:00:00",
          "legs": [
            {
              "arrival_port": null,
              "co2_footprint": "0.8237 Tons",
              "departure_port": {
                "facility": "NAPOLEON AVENUE TERMINAL",
                "name": "NEW ORLEANS",
                "port_id": 78,
                "un_locode": "USMSY"
              },
              "estimated_arrival": null,
              "estimated_departure": "2026-10-25T23:00:00",
              "last_leg": false,
              "port_calls": [],
              "sequence": 1,
              "service_name": "MEDGULF SERVICE",
              "vessel": {
                "built_year": "2005",
                "flag": "LIBERIA",
                "flag_code": null,
                "imo": "9290488",
                "name": "MSC NIOVI VIII"
              },
              "voyage_number": "MG642E"
            },
            {
              "arrival_port": {
                "facility": "MEDCENTER CONTAINER TERMINAL",
                "name": "GIOIA TAURO",
                "port_id": 17,
                "un_locode": "ITGIT"
              },
              "co2_footprint": "1.0022 Tons",
              "departure_port": {
                "facility": "MEDCENTER CONTAINER TERMINAL",
                "name": "GIOIA TAURO",
                "port_id": 17,
                "un_locode": "ITGIT"
              },
              "estimated_arrival": "2026-11-14T17:45:00",
              "estimated_departure": "2026-11-19T01:00:00",
              "last_leg": false,
              "port_calls": [],
              "sequence": 2,
              "service_name": "TURKIYE TO NAF - BLACK SEA SERVICE",
              "vessel": {
                "built_year": "2006",
                "flag": "PORTUGAL",
                "flag_code": null,
                "imo": "9308625",
                "name": "MSC LUNA F"
              },
              "voyage_number": "YU645R"
            },
            {
              "arrival_port": {
                "facility": "ASYAPORT",
                "name": "TEKIRDAG (ASYAPORT)",
                "port_id": 1383,
                "un_locode": "TRTEK"
              },
              "co2_footprint": "0.2049 Tons",
              "departure_port": {
                "facility": "ASYAPORT",
                "name": "TEKIRDAG (ASYAPORT)",
                "port_id": 1383,
                "un_locode": "TRTEK"
              },
              "estimated_arrival": "2026-11-21T13:00:00",
              "estimated_departure": "2026-11-25T23:00:00",
              "last_leg": false,
              "port_calls": [],
              "sequence": 3,
              "service_name": "GEORGIA SERVICE STRING 4",
              "vessel": {
                "built_year": "2002",
                "flag": "TURKIYE",
                "flag_code": null,
                "imo": "9260536",
                "name": "BURAK BAYRAKTAR"
              },
              "voyage_number": "DC648A"
            },
            {
              "arrival_port": {
                "facility": "APM TERMINALS POTI",
                "name": "POTI",
                "port_id": 13,
                "un_locode": "GEPTI"
              },
              "co2_footprint": null,
              "departure_port": null,
              "estimated_arrival": "2026-11-28T09:00:00",
              "estimated_departure": null,
              "last_leg": true,
              "port_calls": [],
              "sequence": 4,
              "service_name": null,
              "vessel": null,
              "voyage_number": null
            }
          ],
          "total_transit_time": "34 days",
          "total_transit_time_hours": 816,
          "vessel_name": "MSC NIOVI VIII",
          "voyage_number": "MG642E"
        },
        {
          "co2_footprint": "2.0308 Tons",
          "cut_offs": {
            "container_yard": "Thu 29th Oct 2026 16:00",
            "dangerous_cargo": "Wed 28th Oct 2026 16:00",
            "reefer": "Thu 29th Oct 2026 16:00",
            "shipping_instructions": "Wed 28th Oct 2026 16:00",
            "verified_gross_mass": "Thu 29th Oct 2026 12:00"
          },
          "estimated_arrival": "2026-12-15T02:00:00",
          "estimated_departure": "2026-11-02T10:00:00",
          "legs": [
            {
              "arrival_port": null,
              "co2_footprint": "0.8237 Tons",
              "departure_port": {
                "facility": "NAPOLEON AVENUE TERMINAL",
                "name": "NEW ORLEANS",
                "port_id": 78,
                "un_locode": "USMSY"
              },
              "estimated_arrival": null,
              "estimated_departure": "2026-11-02T10:00:00",
              "last_leg": false,
              "port_calls": [],
              "sequence": 1,
              "service_name": "MEDGULF SERVICE",
              "vessel": {
                "built_year": "2013",
                "flag": "MALTA",
                "flag_code": null,
                "imo": "9628166",
                "name": "VALUE"
              },
              "voyage_number": "MG643E"
            },
            {
              "arrival_port": {
                "facility": "MEDCENTER CONTAINER TERMINAL",
                "name": "GIOIA TAURO",
                "port_id": 17,
                "un_locode": "ITGIT"
              },
              "co2_footprint": "1.0022 Tons",
              "departure_port": {
                "facility": "MEDCENTER CONTAINER TERMINAL",
                "name": "GIOIA TAURO",
                "port_id": 17,
                "un_locode": "ITGIT"
              },
              "estimated_arrival": "2026-11-22T04:45:00",
              "estimated_departure": "2026-11-26T01:00:00",
              "last_leg": false,
              "port_calls": [],
              "sequence": 2,
              "service_name": "TURKIYE TO NAF - BLACK SEA SERVICE",
              "vessel": {
                "built_year": null,
                "flag": null,
                "flag_code": null,
                "imo": null,
                "name": "TBN"
              },
              "voyage_number": "YU646R"
            },
            {
              "arrival_port": {
                "facility": "ASYAPORT",
                "name": "TEKIRDAG (ASYAPORT)",
                "port_id": 1383,
                "un_locode": "TRTEK"
              },
              "co2_footprint": "0.2049 Tons",
              "departure_port": {
                "facility": "ASYAPORT",
                "name": "TEKIRDAG (ASYAPORT)",
                "port_id": 1383,
                "un_locode": "TRTEK"
              },
              "estimated_arrival": "2026-12-08T07:00:00",
              "estimated_departure": "2026-12-12T17:00:00",
              "last_leg": false,
              "port_calls": [],
              "sequence": 3,
              "service_name": "GEORGIA SERVICE STRING 4",
              "vessel": {
                "built_year": null,
                "flag": null,
                "flag_code": null,
                "imo": null,
                "name": "TBN"
              },
              "voyage_number": "TBN"
            },
            {
              "arrival_port": {
                "facility": "APM TERMINALS POTI",
                "name": "POTI",
                "port_id": 13,
                "un_locode": "GEPTI"
              },
              "co2_footprint": null,
              "departure_port": null,
              "estimated_arrival": "2026-12-15T02:00:00",
              "estimated_departure": null,
              "last_leg": true,
              "port_calls": [],
              "sequence": 4,
              "service_name": null,
              "vessel": null,
              "voyage_number": null
            }
          ],
          "total_transit_time": "43 days",
          "total_transit_time_hours": 1032,
          "vessel_name": "VALUE",
          "voyage_number": "MG643E"
        },
        {
          "co2_footprint": "2.0308 Tons",
          "cut_offs": {
            "container_yard": "Thu 5th Nov 2026 16:00",
            "dangerous_cargo": "Wed 4th Nov 2026 16:00",
            "reefer": "Thu 5th Nov 2026 16:00",
            "shipping_instructions": "Wed 4th Nov 2026 16:00",
            "verified_gross_mass": "Thu 5th Nov 2026 12:00"
          },
          "estimated_arrival": "2026-12-12T08:00:00",
          "estimated_departure": "2026-11-09T10:00:00",
          "legs": [
            {
              "arrival_port": null,
              "co2_footprint": "0.8237 Tons",
              "departure_port": {
                "facility": "NAPOLEON AVENUE TERMINAL",
                "name": "NEW ORLEANS",
                "port_id": 78,
                "un_locode": "USMSY"
              },
              "estimated_arrival": null,
              "estimated_departure": "2026-11-09T10:00:00",
              "last_leg": false,
              "port_calls": [],
              "sequence": 1,
              "service_name": "MEDGULF SERVICE",
              "vessel": {
                "built_year": "2015",
                "flag": "LIBERIA",
                "flag_code": null,
                "imo": "9710244",
                "name": "ANTHEA Y"
              },
              "voyage_number": "MG644E"
            },
            {
              "arrival_port": {
                "facility": "MEDCENTER CONTAINER TERMINAL",
                "name": "GIOIA TAURO",
                "port_id": 17,
                "un_locode": "ITGIT"
              },
              "co2_footprint": "1.0022 Tons",
              "departure_port": {
                "facility": "MEDCENTER CONTAINER TERMINAL",
                "name": "GIOIA TAURO",
                "port_id": 17,
                "un_locode": "ITGIT"
              },
              "estimated_arrival": "2026-11-30T06:00:00",
              "estimated_departure": "2026-12-03T01:00:00",
              "last_leg": false,
              "port_calls": [],
              "sequence": 2,
              "service_name": "TURKIYE TO NAF - BLACK SEA SERVICE",
              "vessel": {
                "built_year": "2003",
                "flag": "LIBERIA",
                "flag_code": null,
                "imo": "9235610",
                "name": "MSC VERA F"
              },
              "voyage_number": "YU647R"
            },
            {
              "arrival_port": {
                "facility": "ASYAPORT",
                "name": "TEKIRDAG (ASYAPORT)",
                "port_id": 1383,
                "un_locode": "TRTEK"
              },
              "co2_footprint": "0.2049 Tons",
              "departure_port": {
                "facility": "ASYAPORT",
                "name": "TEKIRDAG (ASYAPORT)",
                "port_id": 1383,
                "un_locode": "TRTEK"
              },
              "estimated_arrival": "2026-12-05T13:00:00",
              "estimated_departure": "2026-12-09T23:00:00",
              "last_leg": false,
              "port_calls": [],
              "sequence": 3,
              "service_name": "GEORGIA SERVICE STRING 4",
              "vessel": {
                "built_year": null,
                "flag": null,
                "flag_code": null,
                "imo": null,
                "name": "TBN"
              },
              "voyage_number": "TBN"
            },
            {
              "arrival_port": {
                "facility": "APM TERMINALS POTI",
                "name": "POTI",
                "port_id": 13,
                "un_locode": "GEPTI"
              },
              "co2_footprint": null,
              "departure_port": null,
              "estimated_arrival": "2026-12-12T08:00:00",
              "estimated_departure": null,
              "last_leg": true,
              "port_calls": [],
              "sequence": 4,
              "service_name": null,
              "vessel": null,
              "voyage_number": null
            }
          ],
          "total_transit_time": "33 days",
          "total_transit_time_hours": 792,
          "vessel_name": "ANTHEA Y",
          "voyage_number": "MG644E"
        },
        {
          "co2_footprint": "2.0308 Tons",
          "cut_offs": {
            "container_yard": "Thu 12th Nov 2026 16:00",
            "dangerous_cargo": "Wed 11th Nov 2026 16:00",
            "reefer": "Thu 12th Nov 2026 16:00",
            "shipping_instructions": "Wed 11th Nov 2026 16:00",
            "verified_gross_mass": "Thu 12th Nov 2026 12:00"
          },
          "estimated_arrival": "2026-12-26T06:00:00",
          "estimated_departure": "2026-11-16T10:00:00",
          "legs": [
            {
              "arrival_port": null,
              "co2_footprint": "0.8237 Tons",
              "departure_port": {
                "facility": "NAPOLEON AVENUE TERMINAL",
                "name": "NEW ORLEANS",
                "port_id": 78,
                "un_locode": "USMSY"
              },
              "estimated_arrival": null,
              "estimated_departure": "2026-11-16T10:00:00",
              "last_leg": false,
              "port_calls": [],
              "sequence": 1,
              "service_name": "MEDGULF SERVICE",
              "vessel": {
                "built_year": "2013",
                "flag": "MALTA",
                "flag_code": null,
                "imo": "9618317",
                "name": "MSC ATHOS"
              },
              "voyage_number": "MG645E"
            },
            {
              "arrival_port": {
                "facility": "MEDCENTER CONTAINER TERMINAL",
                "name": "GIOIA TAURO",
                "port_id": 17,
                "un_locode": "ITGIT"
              },
              "co2_footprint": "1.0022 Tons",
              "departure_port": {
                "facility": "MEDCENTER CONTAINER TERMINAL",
                "name": "GIOIA TAURO",
                "port_id": 17,
                "un_locode": "ITGIT"
              },
              "estimated_arrival": "2026-12-09T19:00:00",
              "estimated_departure": "2026-12-17T01:00:00",
              "last_leg": false,
              "port_calls": [],
              "sequence": 2,
              "service_name": "TURKIYE TO NAF - BLACK SEA SERVICE",
              "vessel": {
                "built_year": null,
                "flag": null,
                "flag_code": null,
                "imo": null,
                "name": "TBN"
              },
              "voyage_number": "YU649R"
            },
            {
              "arrival_port": {
                "facility": "ASYAPORT",
                "name": "TEKIRDAG (ASYAPORT)",
                "port_id": 1383,
                "un_locode": "TRTEK"
              },
              "co2_footprint": "0.2049 Tons",
              "departure_port": {
                "facility": "ASYAPORT",
                "name": "TEKIRDAG (ASYAPORT)",
                "port_id": 1383,
                "un_locode": "TRTEK"
              },
              "estimated_arrival": "2026-12-19T11:00:00",
              "estimated_departure": "2026-12-23T21:00:00",
              "last_leg": false,
              "port_calls": [],
              "sequence": 3,
              "service_name": "GEORGIA SERVICE STRING 4",
              "vessel": {
                "built_year": null,
                "flag": null,
                "flag_code": null,
                "imo": null,
                "name": "TBN"
              },
              "voyage_number": "TBN"
            },
            {
              "arrival_port": {
                "facility": "APM TERMINALS POTI",
                "name": "POTI",
                "port_id": 13,
                "un_locode": "GEPTI"
              },
              "co2_footprint": null,
              "departure_port": null,
              "estimated_arrival": "2026-12-26T06:00:00",
              "estimated_departure": null,
              "last_leg": true,
              "port_calls": [],
              "sequence": 4,
              "service_name": null,
              "vessel": null,
              "voyage_number": null
            }
          ],
          "total_transit_time": "40 days",
          "total_transit_time_hours": 960,
          "vessel_name": "MSC ATHOS",
          "voyage_number": "MG645E"
        },
        {
          "co2_footprint": "2.0308 Tons",
          "cut_offs": {
            "container_yard": "Thu 19th Nov 2026 16:00",
            "dangerous_cargo": "Wed 18th Nov 2026 16:00",
            "reefer": "Thu 19th Nov 2026 16:00",
            "shipping_instructions": "Wed 18th Nov 2026 16:00",
            "verified_gross_mass": "Thu 19th Nov 2026 12:00"
          },
          "estimated_arrival": "2027-01-02T08:00:00",
          "estimated_departure": "2026-11-23T10:00:00",
          "legs": [
            {
              "arrival_port": null,
              "co2_footprint": "0.8237 Tons",
              "departure_port": {
                "facility": "NAPOLEON AVENUE TERMINAL",
                "name": "NEW ORLEANS",
                "port_id": 78,
                "un_locode": "USMSY"
              },
              "estimated_arrival": null,
              "estimated_departure": "2026-11-23T10:00:00",
              "last_leg": false,
              "port_calls": [],
              "sequence": 1,
              "service_name": "MEDGULF SERVICE",
              "vessel": {
                "built_year": "2009",
                "flag": "PORTUGAL",
                "flag_code": null,
                "imo": "9393307",
                "name": "MSC RIDA VIII"
              },
              "voyage_number": "MG646E"
            },
            {
              "arrival_port": {
                "facility": "MEDCENTER CONTAINER TERMINAL",
                "name": "GIOIA TAURO",
                "port_id": 17,
                "un_locode": "ITGIT"
              },
              "co2_footprint": "1.0022 Tons",
              "departure_port": {
                "facility": "MEDCENTER CONTAINER TERMINAL",
                "name": "GIOIA TAURO",
                "port_id": 17,
                "un_locode": "ITGIT"
              },
              "estimated_arrival": "2026-12-16T12:00:00",
              "estimated_departure": "2026-12-24T01:00:00",
              "last_leg": false,
              "port_calls": [],
              "sequence": 2,
              "service_name": "TURKIYE TO NAF - BLACK SEA SERVICE",
              "vessel": {
                "built_year": "2006",
                "flag": "ANTIGUA AND BARBUDA",
                "flag_code": null,
                "imo": "9306835",
                "name": "BILBAO TRADER"
              },
              "voyage_number": "YU650R"
            },
            {
              "arrival_port": {
                "facility": "ASYAPORT",
                "name": "TEKIRDAG (ASYAPORT)",
                "port_id": 1383,
                "un_locode": "TRTEK"
              },
              "co2_footprint": "0.2049 Tons",
              "departure_port": {
                "facility": "ASYAPORT",
                "name": "TEKIRDAG (ASYAPORT)",
                "port_id": 1383,
                "un_locode": "TRTEK"
              },
              "estimated_arrival": "2026-12-26T13:00:00",
              "estimated_departure": "2026-12-30T23:00:00",
              "last_leg": false,
              "port_calls": [],
              "sequence": 3,
              "service_name": "GEORGIA SERVICE STRING 4",
              "vessel": {
                "built_year": null,
                "flag": null,
                "flag_code": null,
                "imo": null,
                "name": "TBN"
              },
              "voyage_number": "TBN"
            },
            {
              "arrival_port": {
                "facility": "APM TERMINALS POTI",
                "name": "POTI",
                "port_id": 13,
                "un_locode": "GEPTI"
              },
              "co2_footprint": null,
              "departure_port": null,
              "estimated_arrival": "2027-01-02T08:00:00",
              "estimated_departure": null,
              "last_leg": true,
              "port_calls": [],
              "sequence": 4,
              "service_name": null,
              "vessel": null,
              "voyage_number": null
            }
          ],
          "total_transit_time": "40 days",
          "total_transit_time_hours": 960,
          "vessel_name": "MSC RIDA VIII",
          "voyage_number": "MG646E"
        }
      ],
      "service_name": "MEDGULF SERVICE",
      "transit_time": "32 days",
      "transit_time_hours": 768
    }
  ],
  "sailing_count": 8,
  "source_url": "https://www.msc.com/en/search-a-schedule",
  "to_port": {
    "facility": null,
    "name": "POTI",
    "port_id": 13,
    "un_locode": "GEPTI"
  }
}
```

### Track shipment

- Capability: `shipment-tracking/track_shipment`
- Description: Track an MSC shipment by container number, bill of lading number or booking number: route summary (shipped from/to, ports, transshipments), ETA at the port of discharge and every milestone event per container with vessel, voyage, terminal and intermediary port calls. Dates are local port dates normalised to ISO; MSC's own result label (Central Europe time) is kept verbatim.
- Instructions: Any 'where is my container / B/L' question. A container lookup returns its bill of lading number; look that up to get every sibling container on the same B/L.
- Cost: 5 credits per call
- Capability file: [Track shipment](https://firecrawl.dev/alexandria/agents/providers/msc-com/shipment-tracking/track_shipment)

Accepted options:
- `mode` (string): MSC's tracking mode: container_or_bl (trackingMode 0, default) or booking (trackingMode 1). Example: `container_or_bl`
- `tracking_number` (string, required): Container number (ISO 6346, e.g. MSCU5285725), bill of lading number (e.g. MEDUADB63037) or booking number. Case and whitespace are normalised. Pattern: ^[A-Za-z0-9 _-]+$. Example: `<tracking_number>`

Response schema example:
```json
{
  "bills_of_lading": [
    {
      "bill_of_lading_number": "MEDUADB63037",
      "containers": [
        {
          "container_number": "MSCU5285725",
          "container_type": "40' HIGH CUBE",
          "delivered": false,
          "events": [
            {
              "date": "2026-10-30",
              "description": "Estimated Time of Arrival",
              "detail": [
                "MSC VERA F",
                "YU641R"
              ],
              "facility": {
                "code": null,
                "code_type": null,
                "name": "APM TERMINALS POTI",
                "smdg": "APMT"
              },
              "intermediary_port_calls": [
                {
                  "country": "GE",
                  "eta": "2026-10-29T05:15",
                  "etd": "2026-10-30T12:15",
                  "location_name": "BATUMI"
                },
                {
                  "country": "BG",
                  "eta": "2026-10-26T02:15",
                  "etd": "2026-10-27T02:15",
                  "location_name": "BURGAS"
                }
              ],
              "location": "POTI, GE",
              "order": 5,
              "un_locode": "GEPTI",
              "vessel": {
                "built_year": "2003",
                "flag": "LIBERIA",
                "flag_code": "LR",
                "imo": "9235610",
                "name": "MSC VERA F"
              }
            },
            {
              "date": "2026-10-22",
              "description": "Full Intended Transshipment",
              "detail": [
                "MSC VERA F",
                "YU641R"
              ],
              "facility": {
                "code": null,
                "code_type": null,
                "name": "MEDCENTER CONTAINER TERMINAL",
                "smdg": "MCT"
              },
              "intermediary_port_calls": [],
              "location": "GIOIA TAURO, IT",
              "order": 4,
              "un_locode": "ITGIT",
              "vessel": {
                "built_year": "2003",
                "flag": "LIBERIA",
                "flag_code": "LR",
                "imo": "9235610",
                "name": "MSC VERA F"
              }
            },
            {
              "date": "2026-10-14",
              "description": "Estimated Time of Arrival",
              "detail": [
                "MSC TIANSHAN",
                "MG637E"
              ],
              "facility": {
                "code": null,
                "code_type": null,
                "name": "MEDCENTER CONTAINER TERMINAL",
                "smdg": "MCT"
              },
              "intermediary_port_calls": [
                {
                  "country": "ES",
                  "eta": "2026-10-11T19:00",
                  "etd": "2026-10-12T19:00",
                  "location_name": "BARCELONA"
                },
                {
                  "country": "BS",
                  "eta": "2026-09-29T19:30",
                  "etd": "2026-10-01T01:36",
                  "location_name": "FREEPORT, GRAND BAHAMA"
                }
              ],
              "location": "GIOIA TAURO, IT",
              "order": 3,
              "un_locode": "ITGIT",
              "vessel": {
                "built_year": "2006",
                "flag": "LIBERIA",
                "flag_code": "LR",
                "imo": "9305477",
                "name": "MSC TIANSHAN"
              }
            },
            {
              "date": "2026-09-20",
              "description": "Export Loaded on Vessel",
              "detail": [
                "MSC TIANSHAN",
                "MG637E"
              ],
              "facility": {
                "code": "Q795",
                "code_type": "FIRMS",
                "name": "NAPOLEON AVENUE TERMINAL",
                "smdg": "NOLA"
              },
              "intermediary_port_calls": [],
              "location": "NEW ORLEANS, US",
              "order": 2,
              "un_locode": "USMSY",
              "vessel": {
                "built_year": "2006",
                "flag": "LIBERIA",
                "flag_code": "LR",
                "imo": "9305477",
                "name": "MSC TIANSHAN"
              }
            },
            {
              "date": "2026-09-16",
              "description": "Export received at CY",
              "detail": [
                "LADEN"
              ],
              "facility": {
                "code": "Q795",
                "code_type": "FIRMS",
                "name": "NAPOLEON AVENUE TERMINAL",
                "smdg": "NOLA"
              },
              "intermediary_port_calls": [],
              "location": "NEW ORLEANS, US",
              "order": 1,
              "un_locode": "USMSY",
              "vessel": null
            },
            {
              "date": "2026-09-14",
              "description": "Empty to Shipper",
              "detail": [
                "EMPTY"
              ],
              "facility": {
                "code": "Q795",
                "code_type": "FIRMS",
                "name": "NAPOLEON AVENUE TERMINAL",
                "smdg": "NOLA"
              },
              "intermediary_port_calls": [],
              "location": "NEW ORLEANS, US",
              "order": 0,
              "un_locode": "USMSY",
              "vessel": null
            }
          ],
          "latest_move": "NEW ORLEANS, US",
          "pod_eta_date": "2026-10-30"
        }
      ],
      "delivered": false,
      "final_pod_eta_date": null,
      "number_of_containers": 1,
      "port_of_discharge": "POTI, GE",
      "port_of_load": "NEW ORLEANS, US",
      "price_calculation_date": "2026-09-16",
      "shipped_from": "NEW ORLEANS, US",
      "shipped_to": "POTI, GE",
      "transshipments": [
        "GIOIA TAURO, IT",
        "TEKIRDAG (ASYAPORT), TR"
      ]
    }
  ],
  "mode": "container_or_bl",
  "observed_at_ms": 1791131325192,
  "report_date": "2026-10-04",
  "results_label": "Tracking results provided by MSC on 04.10.2026 at 18:28 Central Europe Standard Time",
  "source_url": "https://www.msc.com/en/track-a-shipment",
  "tracking_number": "MSCU5285725",
  "tracking_type": "Container"
}
```

### Vessel schedule

- Capability: `shipment-tracking/vessel_schedule`
- Description: Live port-call schedule of one MSC-operated vessel by IMO number: each port with arrival and departure (ISO local, no zone), whether it is the current location, service and voyage number.
- Instructions: Where a vessel is and where it calls next; IMO numbers come from list_vessels, tracking events or sailing schedules.
- Cost: 5 credits per call
- Capability file: [Vessel schedule](https://firecrawl.dev/alexandria/agents/providers/msc-com/shipment-tracking/vessel_schedule)

Accepted options:
- `imo` (string, required): IMO number, 7 digits. Pattern: ^[0-9]{7}$. Example: `<imo>`
- `language` (string): Response language for labels (service names and messages stay as MSC publishes them). Example: `en`

Response schema example:
```json
{
  "count": 5,
  "imo": "9305477",
  "language": "en",
  "observed_at_ms": 1791131374156,
  "port_calls": [
    {
      "arrival": "2026-09-16T03:48:00",
      "departure": "2026-09-17T19:00:00",
      "is_current_location": false,
      "port_name": "HOUSTON",
      "service_name": "MEDGULF SERVICE",
      "un_locode": "USHOU",
      "voyage_number": "MG637E"
    },
    {
      "arrival": "2026-09-20T03:06:00",
      "departure": "2026-09-20T22:54:00",
      "is_current_location": false,
      "port_name": "NEW ORLEANS",
      "service_name": "MEDGULF SERVICE",
      "un_locode": "USMSY",
      "voyage_number": "MG637E"
    },
    {
      "arrival": "2026-09-29T14:30:00",
      "departure": "2026-09-30T20:36:00",
      "is_current_location": true,
      "port_name": "FREEPORT, GRAND BAHAMA",
      "service_name": "MEDGULF SERVICE",
      "un_locode": "BSFPO",
      "voyage_number": "MG637E"
    },
    {
      "arrival": "2026-10-11T20:00:00",
      "departure": "2026-10-12T20:00:00",
      "is_current_location": false,
      "port_name": "BARCELONA",
      "service_name": "MEDGULF SERVICE",
      "un_locode": "ESBCN",
      "voyage_number": "MG637E"
    },
    {
      "arrival": "2026-10-14T19:00:00",
      "departure": "2026-10-14T19:00:00",
      "is_current_location": false,
      "port_name": "GIOIA TAURO",
      "service_name": "MEDGULF SERVICE",
      "un_locode": "ITGIT",
      "voyage_number": "MG637E"
    }
  ],
  "result_timestamp": "Search schedule results provided by MSC on 04.10.2026 at 18:29 Central Europe Standard Time",
  "source_url": "https://www.msc.com/en/search-a-schedule",
  "vessel": {
    "built_year": "2006",
    "flag": "LIBERIA",
    "flag_code": null,
    "imo": "9305477",
    "name": "MSC TIANSHAN"
  }
}
```
