# Maersk Shipping AI Agent Connect

> Maersk container shipping APIs as an MCP: shipment tracking by container/waybill, waybill document lookup, ocean products, locations, vessel schedules, port calls and deadlines — api.maersk.com with Basic/Bearer integration auth.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_btVopx9k2t1dPxSsLSMTTSZOTv0BTdSdi2L5Bw76/ai-agent-connect
- **Tags:** maersk, container-shipping, shipment-tracking, ocean-freight, supply-chain, logistics-api

## Description

**Maersk — the world's largest container line** — and its official Integration Hub APIs as a single MCP server.

### What you can do
- **Track shipments** — live milestones (gate-in, loaded, discharged, gate-out), current positions and ETAs by container number, bill of lading or your own reference
- **Waybill lookup** — the classic document lookup by carrier SCAC (MAEU) + waybill number: parties, ports, containers
- **Ocean products** — bookable sailings between two locations with vessels, transit times and schedules
- **Vessels & port calls** — vessel metadata, IMONumber schedules, arrival/departure records per port
- **Deadlines** — documentation, VGM, gate-in, demurrage and detention cut-offs per shipment

### Authentication (from the Maersk Integration Hub)
1. Create an account at **developer.maersk.com** (the 'Maersk Integration Hub')
2. Create an **app/integration** and subscribe it to the products you need (Shipment Tracking, Shipping Documents, Ocean Products, Vessel Schedules, Port Calls, Deadlines)
3. Copy the issued **Consumer Key + Consumer Secret** (and optionally a pre-minted Bearer token and your customer code) into this MCP's credentials

The gateway (api.maersk.com) accepts HTTP **Basic** (consumer key:secret) or **Bearer** tokens; every unauthenticated call returns a structured 401 with a `correlationIdentifier` for Maersk support.

### Who is this for?
Shippers and freight forwarders, supply-chain dashboards, logistics developers, e-commerce ops and AI agents that need authoritative Maersk ocean-freight data.

## Tools

### find_waybill
json?carrierSCAC=MAEU&waybillNumber=... — returns the waybill metadata for MAEU (Maersk) bills: parties, ports, containers. carrierSCAC is the standard carrier code (MAEU for Maersk Line).

Look up a shipment by Bill of Lading (waybill) number — the classic Maersk document lookup

### search_locations
Search Maersk location master data: cities, ports, terminals (geo IDs)

### get_deadlines
Filter by waybillNumber or containerNumber. Requires the Deadlines subscription.

Get shipment deadlines: documentation, VGM, demurrage/detention cut-offs

### track_shipments
Query by containerNumber (e.g. MAEU1234567), waybillNumber or your reference. Requires the Shipment Tracking subscription.

Track shipments by container number, waybill number or your own reference (live milestones)

### get_ocean_products
), numberOfTwentyEq / numberOfFortyEq. Returns sailings with vessels, transit times and deadlines. Requires the Ocean Products subscription.

Search bookable ocean products (sailings) between two locations with prices

### get_vessel_schedules
— vessel metadata and sailing schedules. Use IMONumber (7 digits) from prior calls; omit filters to list vessels within your subscription scope.

Get vessel schedules and routes for Maersk vessels (IMONumber)

### get_port_calls
Filter by vesselIMONumber (7 digits) and optionally port UN/LOCODE. Requires the Port Calls subscription.

Get port call records for a vessel (arrivals, departures, terminals)

## Prompt Examples

**Prompt:** 
```
Where is container MAEU1234567 right now?
```

**Response:** 
```
🚢 **Tracking MAEU1234567**

Current: discharged at Rotterdam, final destination Copenhagen
Milestones: gate-in Shenzhen 2026-08-02 → loaded 08-05 → discharged RTM 09-04 → gate-out pending
ETA Copenhagen: 2026-09-10

Want the full milestone list or the waybill document?
```

**Prompt:** 
```
Find the waybill MAEU123456789 and its parties
```

**Response:** 
```
📄 **Waybill MAEU123456789 (SCAC MAEU)**

Shipper: Nordic Exports AB · Consignee: BR Comércio Ltda
Port of loading: Gteborg (SEGOT) → Discharge: Santos (BRSSZ)
Containers: 2× 40HC

Full parties, ports and container list pulled from /v1/waybills/find.json.
```

**Prompt:** 
```
Ocean products from Rotterdam to Santos departing next week
```

**Response:** 
```
⛵ **Ocean products RTM→SSZ**

GeoIDs resolved via search_locations. Next sailings:
- Maersk Sentosa, dep 2026-09-12, transit 18d, direct
- Maersk Yellowstone, dep 2026-09-14, transit 21d, 1 transhipment

Deadlines per sailing (doc/VGM cut-offs) included. Want spot prices for a specific departure?
```

## Frequently Asked Questions

**How do I get the Consumer Key/Secret?**
Create an account at developer.maersk.com (Maersk Integration Hub), create an app/integration in the catalogue, and subscribe it to the products you need (Shipment Tracking, Shipping Documents, Ocean Products, Vessel Schedules, Port Calls, Deadlines). The portal issues a Consumer Key + Consumer Secret pair per app.

**I get a 401 with a correlationIdentifier — what now?**
The gateway returns a structured 401 (with httpMethod, requestUri and correlationIdentifier) whenever auth is missing/invalid — first check the consumer key/secret. Maersk support can trace any request by that correlation identifier.