insurance_recommendation
Recommend cost-effective marine cargo insurance by comparing ICC clauses (A, B, C) with coverage, exclusions, and premium calculated from cargo value, loss profile, mode, and route risk.
Instructions
Recommend cost-effective MARINE CARGO INSURANCE for a shipment — the cover an importer needs but often under-buys. It prices the three Institute Cargo Clauses side by side: ICC (A) ALL-RISK (covers everything bar named exclusions — for valuable/fragile/theft-prone cargo), ICC (B) named-perils-broad (adds water-ingress but NOT theft), and ICC (C) MINIMUM (only major vessel casualties — no water, no theft) — showing what each COVERS and EXCLUDES. The premium = INSURED VALUE (CIF + 10% customary markup, the freight pulled server-side so the base is real) × the cargo's LOSS PROFILE (electronics/batteries load the rate; robust steel discounts it) × the MODE risk (air has a structurally lower loss rate than ocean — links to compare_modes) × the ROUTE risk (a Red-Sea/Cape-diverted lane spikes the separate WAR-RISK additional premium — links to the disruptions engine) × the deductible. It recommends the cost-effective cover level for your cargo and clarifies the Incoterms tie: CIF obliges the seller to buy only ICC (C) minimum, CIP obliges ICC (A) all-risk, and a FOB/CFR/CPT buyer gets NO seller insurance at all (must self-arrange). Modeled market-typical bands — NOT a broker's quote (regla 7). PREMIUM: pay per call with x402 (USDC on Base) or set a prepaid key (FREIGHT_PULSE_KEY). Same UN/LOCODE port normalization as get_spot_rate.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| origin_port | Yes | Origin port (city, UN/LOCODE, or 'City, Country'). The route (incl. Red-Sea diversion) drives the war-risk premium. | |
| dest_port | Yes | Destination port (city, UN/LOCODE, or 'City, Country'). | |
| cargo_value | Yes | Merchandise value (USD) — REQUIRED. The insured value is CIF (cargo + freight) + 10%. | |
| container_type | No | Container size '20ft'/'40ft'/'40HC' (for the freight leg). Optional; defaults to '40ft'. | |
| product | No | Product description to classify the cargo loss profile (e.g. 'bluetooth earbuds', 'steel coils'). Optional but improves the rate. | |
| hs_code | No | Explicit HS code (alternative to product). Optional. | |
| mode | No | Transport mode for the loss profile: 'ocean' (default), 'air' (lower loss rate) or 'sea-air'. Optional. | |
| deductible_fraction | No | Policy deductible as a fraction of insured value (0 = nil, 0.005 = 0.5% typical, 0.01, 0.02). A higher excess lowers the premium. Optional. | |
| ship_date | No | Intended ship date (ISO). Optional; defaults to today. | |
| markup_pct | No | Insured-value markup over CIF (default 0.10 = the customary +10%). Optional. |