Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

omni_customs_duty_tariff

Calculate total U.S. import customs duties, Section 301 tariffs, MPF, and HMF from declared value and duty rates to determine total customs owed and effective tariff rate.

Instructions

Import Customs Duty, Ad Valorem Tariff & De Minimis Calculator. Calculate commercial import customs duties, Section 301 tariffs, Merchandise Processing Fee (MPF), and harbor maintenance fees (HMF). Discipline: LOGISTICS. Governing mathematical model / formula: Total Landed Duty = (Commercial Value × Base Duty Rate) + (Value × Section 301 Tariff) + MPF + HMF.

USAGE GUIDELINES:

  • WHEN TO USE: Invoke for deterministic calculation of total_customs_owed (Total U.S. Customs Fees & Duties), effective_tariff_rate (Effective All-In Tariff Rate), mpf_processing_fee (Merchandise Processing Fee (MPF)), hmf_harbor_fee (Harbor Maintenance Fee (HMF)) using customs_declared_value (Customs Declared Value FOB ($)), base_duty_pct (Harmonized Tariff Schedule (HTS) Duty (%) in %), punitive_tariff_pct (Section 301 / Trade Remedy Tariff (%) in %), ocean_shipment (Arrives via Ocean Port (Subject to 0.125% HMF)). Guarantees exact machine floating-point precision, eliminating LLM arithmetic mistakes and formula hallucinations.

  • WHEN NOT TO USE: Do not use for qualitative evaluations or unquantified reasoning. All input parameters must be valid numerical values.

DISAMBIGUATION & BOUNDARIES:

  • Use this dedicated specialist tool for 'Import Customs Duty, Ad Valorem Tariff & De Minimis Calculator' rather than generic dispatchers like omni_universal_query.

  • For multi-calculation chained jobs, use 'omni_batch_calculate'.

  • To inspect schema fields, see 'omni_describe_solver'.

BEHAVIOR & SAFETY:

  • Pure deterministic computation with machine floating-point precision.

  • Read-only, idempotent, and stateless. Zero side effects or persistent state mutations.

  • Input validation: All arguments are validated against physical and domain bounds. Out-of-bounds inputs return a safe diagnostic error status without throwing runtime exceptions.

RETURNS:

  • Structured JSON object containing:

    • status (string): "success" on valid execution or "error" if validation fails

    • calculator (string): "customs-duty-tariff"

    • category (string): "logistics"

    • name (string): "Import Customs Duty, Ad Valorem Tariff & De Minimis Calculator"

    • formula (string): Governing mathematical formula string

    • inputs (object): Echoed input parameter dictionary with applied defaults

    • metrics (object): Dictionary of computed outputs:

      • metrics.total_customs_owed (Total U.S. Customs Fees & Duties): Formatted display string (e.g. '$10,741.00')

      • metrics.effective_tariff_rate (Effective All-In Tariff Rate): Formatted display string (e.g. '30.7%')

      • metrics.mpf_processing_fee (Merchandise Processing Fee (MPF)): Formatted display string (e.g. '$385.00 (0.3464%)')

      • metrics.hmf_harbor_fee (Harbor Maintenance Fee (HMF)): Formatted display string (e.g. '$43.75 (0.125%)')

    • execution_time_ms (number): Latency in milliseconds.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "omni_customs_duty_tariff"
  }
}

Input Schema

NameRequiredDescriptionDefault
base_duty_pctNoHarmonized Tariff Schedule (HTS) Duty (%) (%). Standard Column 1 General MFN tariff rate. Default: 4.5. Min: 0. Max: 50.
ocean_shipmentNoArrives via Ocean Port (Subject to 0.125% HMF). 1 for Ocean freight, 0 for Air/Truck. Default: 1. Min: 0. Max: 1.
punitive_tariff_pctNoSection 301 / Trade Remedy Tariff (%) (%). Additional trade remedies (e.g. 25% China tariffs). Default: 25. Min: 0. Max: 100.
customs_declared_valueNoCustoms Declared Value FOB ($). Entered transaction value excluding international freight. Default: 35000. Min: 100. Max: 1000000.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools