HarborLab | AI-Powered Port Cost & DA Management Platform

Search Ports

Search the HarborLab port registry by port name or UNLOCODE. Returns matching ports with their name, UNLOCODE, country code, and internal port ID. Use this to find the correct port when input is ambiguous, or to confirm which port to use before calling calculate_husbandry_costs.

List Expenses

List all available HCE expense groups and their line items. Shows unit types, parameters, default options, and all available choices for each expense. Use this to discover what services can be requested and what options are available before calling calculate_husbandry_costs.

Calculate Husbandry Costs

Calculate estimated husbandry costs for a vessel port call. Resolves all port names, group names, expense names, and option names internally — no internal IDs required. All returned monetary values are in USD. IMPORTANT RULES: 1. PORT IS MANDATORY. Never call without a confirmed port. Relay candidates to the user if resolution is ambiguous. 2. DEFAULT TO FULL GROUP ESTIMATES. Omit the 'expenses' field in each group to include all line items. Only specify expenses when the user requests a

List Model Vessels

Return all active model vessels available in the HarborLab platform. Use this to discover what vessel types and sizes are supported before calling estimation endpoints with vessel details.

Request Estimation By Imo

Submit an async port cost estimation request using a vessel's IMO number. Returns a key (UUID) you can pass to get_estimation_result once processing completes. Use this when you know the IMO number of the vessel.

Request Estimation By Details

Submit an async port cost estimation request using full vessel particulars. Returns a key (UUID) you can pass to get_estimation_result once processing completes. Use this when you do NOT have an IMO number but have the vessel's technical details. Call list_model_vessels first to find valid type/size combinations.

Get Estimation Result

Poll for the result of a previously submitted estimation request. Returns the full simulation response including a breakdown of port expenses and a total cost when the task has completed. If the task is still processing, the response will reflect that state.

Sync Estimate By Imo

Run a port cost estimation synchronously using a vessel's IMO number. Blocks until the simulation completes and returns the full expense breakdown. Prefer this over the async flow for single one-off queries.

Sync Estimate By Details

Run a port cost estimation synchronously using full vessel particulars. Blocks until the simulation completes and returns the full expense breakdown. Use this when you do NOT have an IMO number but have the vessel's technical details. Call list_model_vessels first to find valid type/size combinations.