omni_customs_import_duty_hts
Calculate US customs import duties, Section 301 China tariffs, MPF, and HMF fees from invoice value, HTS rate, and shipment mode to get total duties due.
Instructions
Customs Import Duty & Section 301 Tariff Calculator. Calculate US customs import duties, Section 301 China trade tariffs, Merchandise Processing Fees (MPF), and Harbor Maintenance Fees (HMF). Discipline: ECOMMERCE. Governing mathematical model / formula: Total Customs Duty = Base Duty + Section 301 Tariff + MPF Fee (0.3464%) + HMF Fee (0.125%).
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of total_customs_duties_due (Total Customs Duties & Fees), section_301_tariff_subtotal (Section 301 Tariff Portion), effective_customs_rate_pct (Effective Customs Tariff Rate), mpf_and_hmf_fees (Customs User Fees (MPF + HMF)) using commercial_invoice_value (Commercial Invoice Customs Value (FOB $) in $), base_hts_duty_rate_pct (Base HTS Tariff Duty Rate (%) in %), section_301_tariff_rate_pct (Section 301 China Tariff Rate (%) in %), is_ocean_freight_shipment (Ocean Freight Entry (Subject to HMF) in 1=Yes, 0=Air). 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 'Customs Import Duty & Section 301 Tariff 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-import-duty-hts"
category (string): "ecommerce"
name (string): "Customs Import Duty & Section 301 Tariff 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_duties_due (Total Customs Duties & Fees): Formatted display string (e.g. '$19,481.41')
metrics.section_301_tariff_subtotal (Section 301 Tariff Portion): Formatted display string (e.g. '$16,250.00')
metrics.effective_customs_rate_pct (Effective Customs Tariff Rate): Formatted display string (e.g. '29.97%')
metrics.mpf_and_hmf_fees (Customs User Fees (MPF + HMF)): Formatted display string (e.g. '$306.41 Fees')
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_import_duty_hts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| base_hts_duty_rate_pct | No | Base HTS Tariff Duty Rate (%) (%). Harmonized Tariff Schedule base duty rate for product code. Default: 4.5. Min: 0. Max: 40. | |
| commercial_invoice_value | No | Commercial Invoice Customs Value (FOB $) ($). Transaction value declared to US Customs & Border Protection. Default: 65000. Min: 1000. Max: 5000000. | |
| is_ocean_freight_shipment | No | Ocean Freight Entry (Subject to HMF) (1=Yes, 0=Air). Ocean entries incur 0.125% Harbor Maintenance Fee. Default: 1. Min: 0. Max: 1. | |
| section_301_tariff_rate_pct | No | Section 301 China Tariff Rate (%) (%). Section 301 punitive tariff (e.g. 7.5% or 25% for China origin). Default: 25. Min: 0. Max: 50. |