MCP v1.2 — Stable

HeyMariner MCP Server

Model Context Protocol server — give Claude, GPT-4 or any MCP-compatible AI assistant access to live maritime data, regulations, vessel tracking and port intelligence.

Quick Install

# Add to Claude Desktop config (claude_desktop_config.json)

"mcpServers"

"heymariner": {

"command": "npx",

"args": ["@heymariner/mcp-server"],

"env": { "HEYMARINER_API_KEY": "YOUR_KEY" }

}

Available MCP Tools

Tool	Description	Input	Returns
`get_vessel`	Retrieve vessel details by IMO, MMSI or name — type, flag, dimensions, class society	imo \| mmsi \| name	VesselRecord
`get_vessel_position`	Real-time AIS position — lat, lon, speed, course, heading, destination, ETA	imo \| mmsi	AISPosition
`search_vessels`	Search vessels with filters: type, flag, status, DWT range, GT range, operator	SearchParams	VesselRecord[]
`get_port`	Port details — UNLOCODE, location, facilities, berth count, max draft, pilotage	unlocode \| name	PortRecord
`get_port_movements`	Expected and actual vessel arrivals and departures for a port	unlocode, hours?: number	PortMovement[]
`calculate_distance`	Calculate sea distance in nautical miles between two ports via orthodromic or loxodromic route	from_port, to_port	DistanceResult
`get_regulation`	Retrieve full text and summary of maritime regulations: SOLAS, MARPOL, STCW, ISM, ISPS etc.	regulation, chapter?, rule?	RegulationContent
`search_regulations`	Full-text search across all IMO, ILO and IHO regulations and circulars	query: string	RegulationResult[]
`get_weather`	Marine weather at coordinates — wind speed/direction, wave height, swell period, pressure	lat, lon	WeatherData
`get_navarea_warnings`	Active NAVTEX and NAVAREA navigation warnings for a region or coordinate area	navarea \| bbox	NavWarning[]

Voyage Planning Assistant

Ask your AI to plan a voyage — it retrieves port info, calculates distances, checks weather and pulls relevant regulations automatically.

Regulatory Q&A

Chat with regulations — ask natural language questions about SOLAS, MARPOL, STCW and get answers grounded in official IMO text.

Fleet Monitoring

Build a fleet monitoring agent that queries vessel positions, detects deviations, and drafts summary reports automatically.

Port State Control Prep

AI-assisted pre-inspection review: pull applicable regulations, cross-reference certificates, generate deficiency risk assessments.

REST API Reference Webhook Documentation