Maritime Data API

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

# 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
#
# 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 { VesselClient } from "vesselapi";

const client = new VesselClient("YOUR_API_KEY");

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

console.log(`${pos.vesselPosition.vessel_name} @ ${pos.vesselPosition.latitude}, ${pos.vesselPosition.longitude}`);
console.log(`ETA: ${eta.vesselEta.destination} at ${eta.vesselEta.eta}`);
console.log(`CO2: ${emis.emissions[0]?.co2_emissions_total}t`);

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

from vessel_api_python import VesselClient

client = VesselClient(api_key="YOUR_API_KEY")

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

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

# Search ports by country (auto-pagination)
for port in client.search.all_ports(filter_country="NL", filter_port_type="Seaport"):
    print(f"{port.name} ({port.unlo_code})")