Maritime Data API

# In your Claude Code terminal:
> Give me a full profile of the EVER GIVEN — position, port history,
> emissions, and any safety inspections

# Claude chains multiple MCP tools automatically:
# 1. search_vessels → finds MMSI 353136000 / IMO 9811000
# 2. get_vessel_position → current location and speed
# 3. get_port_events_by_vessel → recent port calls
# 4. get_vessel_emissions → CO2 and fuel data
# 5. get_vessel_inspections → PSC inspection history
#
# Then synthesizes a comprehensive vessel report.

> What ships arrived at Rotterdam (NLRTM) in the last 24 hours?

# Claude calls get_port_events with unlocode NLRTM and summarizes
# all arrivals with vessel names, types, and timestamps.

import { VesselAPI } from "vesselapi";

const client = new VesselAPI({ apiKey: "YOUR_API_KEY" });

// Build a complete vessel profile from multiple data sources
const mmsi = 353136000;
const [position, eta, emissions] = await Promise.all([
  client.vessels.position(mmsi, "mmsi"),
  client.vessels.eta(mmsi, "mmsi"),
  client.emissions.byVessel(9811000, "imo"),
]);

console.log(`${position.vesselName} @ ${position.latitude}, ${position.longitude}`);
console.log(`ETA: ${eta.destination} at ${eta.eta}`);
console.log(`CO2: ${emissions.data[0]?.co2EmissionsTotal}t`);

// Get port events at Rotterdam
const events = await client.portEvents.byPort("NLRTM");
for (const event of events.data) {
  console.log(`${event.vesselName} ${event.event} at ${event.timestamp}`);
}

from vesselapi import VesselClient

client = VesselClient(api_key="YOUR_API_KEY")

# Cross-reference vessel data across categories
vessel = client.vessels.get(353136000, "mmsi")
position = client.vessels.position(353136000, "mmsi")
port_history = client.port_events.by_vessel(353136000, "mmsi")

print(f"{vessel.name} ({vessel.vessel_type})")
print(f"Position: {position.latitude}, {position.longitude}")
print(f"Recent ports: {[e.port_name for e in port_history.data[:5]]}")

# Search ports by country
for port in client.search.ports(country="NL", type="Seaport"):
    print(f"{port.name} ({port.unlo_code})")