Skip to main content
Glama

Calculate landed duty

calculate_duty

Access: API key, OAuth, or x402 payment when offered. Calculate supported US duty layers and fees for one import line. The response separates total import charges (duty + fees) from total landed cost (entered value + duty + fees) without estimating fact-dependent treatment. Set assessment_contract to full for the full charge assessment, including safeguards. With that contract, save_replay saves the original assessment for later replay (Pro or higher); the default calculation contract is unchanged.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "hts": "<hts>",
      "country": "<country>",
      "value": "<value>"
    },
    "name": "calculate_duty"
  }
}

Input Schema

NameRequiredDescriptionDefault
htsYesUS HTS code, dotted or undotted. Spaces, +, - and / between digit groups are stripped, and an eight-digit code whose only statistical line is .00 is answered as that line; both are disclosed in `normalized`. A code with several statistical lines, or an undecoded bytes literal, is refused with suggestions that are never applied.
modeNoocean
as_ofNoISO date in YYYY-MM-DD form
factsNoFacts the entry declares (for example usmca_qualifying, manufacture_year, us_content_share). Structured chapter98 declarations carry valuation, facts, components and evidence. Structured chapter99.exclusion declarations carry a source clause, individual product facts and reference-only documents for the governing 9903.88.69 (note 20(vvv)) or 9903.88.70 (note 20(www)) claim. The section_338_canada declaration carries importation_time and direct_to_consumption_container for the Proclamations 11061–11063 import exclusion (a listed Canadian line imported on or after 12:01 a.m. Eastern time on September 29, 2026 returns error import_prohibited with the determination and no duty total), and the U.S. note 51 facts personal_use_accompanied_baggage, us_content_approved and import_adjustment_offset. general_note_6_eligible decides the note 51(d) civil aircraft exemption from the Section 338 duty. A USMCA claim does not remove the Section 338 duty. The preference declaration (claimed, program, origin_qualified, evidence_on_file, quota_available) claims special tariff treatment on calculate_duty: the preferential rate applies only when all are declared, and the answer is marked as based on the importer's declaration. Unknown keys are rejected by the API. Documentary references are not verified approval.
valueYes
claimsNoChapter 98/99 headings the entry claims. Listed but unimplemented treatments return an explicit entry-claim review response, not a duty exemption or total.
countryYesCountry of origin: ISO-2 code (preferred). A country name, ISO-3 code or other casing is resolved to ISO-2 and disclosed in `normalized`.
chapter99No
quantitiesNo
quota_stateNo
save_replayNoWith assessment_contract full, retain the original assessment for replay. Requires Pro or higher and Tariff Assurance availability.
product_contentNo
assessment_contractNoOpt in to the full charge-assessment response. Omit for the unchanged legacy calculation response.
component_values_usdNo
alcohol_by_volume_percentNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • changedInput schema / properties / country / description
      Previous value: -"ISO-2 country code of origin"New value: +"Country of origin: ISO-2 code (preferred). A country name, ISO-3 code or other casing is resolved to ISO-2 and disclosed in `normalized`."
    • changedInput schema / properties / country / pattern
      Previous value: -"^[A-Za-z]{2}$"New value: +"^[A-Za-z][A-Za-z .,'\\u2019()-]{1,59}$"
    • changedInput schema / properties / hts / description
      Previous value: -"US HTS code, dotted or undotted"New value: +"US HTS code, dotted or undotted. Spaces, +, - and / between digit groups are stripped, and an eight-digit code whose only statistical line is .00 is answered as that line; both are disclosed in `normalized`. A code with several statistical lines, or an undecoded bytes literal, is refused with suggestions that are never applied."
    • changedInput schema / properties / hts / pattern
      Previous value: -"^[0-9.\\s-]{4,14}$"New value: +"^(?:[0-9.\\s+\\/-]{4,20}|b'(?:\\\\x[0-9a-fA-F]{2}|[0-9.])+')$"
  2. Changed3 schema fields changed
    • addedInput schema / properties / assessment_contract
      Added value: +{
      +  "const": "full",
      +  "description": "Opt in to the full charge-assessment response. Omit for the unchanged legacy calculation response.",
      +  "type": "string"
      +}
    • changedInput schema / properties / facts / additionalProperties / anyOf
      Previous value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "boolean"
      -  },
      -  {
      -    "type": "null"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "components": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "charge_made": {
      -              "type": [
      -                "boolean",
      -                "null"
      -              ]
      -            },
      -            "fabric_component": {
      -              "type": [
      -                "boolean",
      -                "null"
      -              ]
      -            },
      -            "fabricated": {
      -              "type": [
      -                "boolean",
      -                "null"
      -              ]
      -            },
      -            "foreign_operations_only_assembly_or_incidental": {
      -              "type": [
      -                "boolean",
      -                "null"
      -              ]
      -            },
      -            "id": {
      -              "pattern": "^[A-Za-z0-9_-]{1,64}$",
      -              "type": "string"
      -            },
      -            "last_purchase_cost_usd": {
      -              "anyOf": [
      -                {
      -                  "minimum": 0,
      -                  "type": "number"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ]
      -            },
      -            "physical_identity_preserved": {
      -              "type": [
      -                "boolean",
      -                "null"
      -              ]
      -            },
      -            "product_of_us": {
      -              "type": [
      -                "boolean",
      -                "null"
      -              ]
      -            },
      -            "ready_for_assembly_without_further_fabrication": {
      -              "type": [
      -                "boolean",
      -                "null"
      -              ]
      -            },
      -            "shipment_value_at_export_usd": {
      -              "anyOf": [
      -                {
      -                  "minimum": 0,
      -                  "type": "number"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ]
      -            },
      -            "value_usd": {
      -              "anyOf": [
      -                {
      -                  "minimum": 0,
      -                  "type": "number"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ]
      -            },
      -            "visible_lining_fabric": {
      -              "type": [
      -                "boolean",
      -                "null"
      -              ]
      -            },
      -            "wholly_formed_and_cut_in_us": {
      -              "type": [
      -                "boolean",
      -                "null"
      -              ]
      -            }
      -          },
      -          "required": [
      -            "id"
      -          ],
      -          "type": "object"
      -        },
      -        "maxItems": 100,
      -        "type": "array"
      -      },
      -      "evidence": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "kind": {
      -              "enum": [
      -                "exhibition_officer_declaration",
      -                "exhibition_form301_bond",
      -                "temporary_entry_security",
      -                "temporary_article_identity_records",
      -                "temporary_nonresident_status_records",
      -                "temporary_professional_status_records",
      -                "temporary_event_or_breeding_records",
      -                "accessibility_ita_information",
      -                "scientific_stamped_application",
      -                "scientific_final_determination",
      -                "scientific_order_proof",
      -                "institution_instrument_certification",
      -                "institution_artist_proof",
      -                "foreign_personnel_customs_instruction",
      -                "foreign_personnel_state_request",
      -                "foreign_personnel_reciprocity_determination",
      -                "foreign_personnel_status_instructions",
      -                "foreign_property_customs_instruction",
      -                "foreign_organization_designation",
      -                "government_bureau_head_request",
      -                "government_free_entry_certificate",
      -                "state_department_request",
      -                "government_property_certification",
      -                "government_waiver_agency_request",
      -                "government_orders",
      -                "government_effects_declaration",
      -                "owner_form_3299",
      -                "household_use_evidence",
      -                "passenger_declaration",
      -                "decedent_citizenship_statement",
      -                "estate_entry_documents",
      -                "conveyance_identification",
      -                "replacement_form_4455",
      -                "unaccompanied_form_255",
      -                "unaccompanied_purchase_records",
      -                "iit_designation",
      -                "container_import_intention",
      -                "container_bond",
      -                "plant_pest_admissibility",
      -                "container_reporting_program",
      -                "foreign_shipper_declaration",
      -                "importer_declaration",
      -                "repairer_declaration",
      -                "repair_process_records",
      -                "repair_identity_records",
      -                "processor_declaration",
      -                "assembler_declaration",
      -                "component_cost_records",
      -                "program_certificate_of_origin",
      -                "metal_processing_records",
      -                "metal_identity_records",
      -                "cbp_documentary_waiver",
      -                "cbp_additional_evidence_request",
      -                "drawback_tax_records",
      -                "internal_revenue_bond_return_records",
      -                "vessel_owner_master_certificate",
      -                "temporary_return_exporter_records",
      -                "temporary_return_use_records",
      -                "animal_border_return_records"
      -              ],
      -              "type": "string"
      -            },
      -            "reference": {
      -              "maxLength": 512,
      -              "minLength": 1,
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "kind",
      -            "reference"
      -          ],
      -          "type": "object"
      -        },
      -        "maxItems": 20,
      -        "type": "array"
      -      },
      -      "facts": {
      -        "additionalProperties": {
      -          "type": [
      -            "string",
      -            "number",
      -            "boolean",
      -            "null"
      -          ]
      -        },
      -        "type": "object"
      -      },
      -      "statistical_quantities": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "amount": {
      -              "exclusiveMinimum": 0,
      -              "type": "number"
      -            },
      -            "unit": {
      -              "maxLength": 64,
      -              "minLength": 1,
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "unit",
      -            "amount"
      -          ],
      -          "type": "object"
      -        },
      -        "maxItems": 3,
      -        "type": "array"
      -      },
      -      "valuation": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "articles_furnished_for_repair_value_usd": {
      -            "minimum": 0,
      -            "type": "number"
      -          },
      -          "articles_used_in_foreign_processing_value_usd": {
      -            "minimum": 0,
      -            "type": "number"
      -          },
      -          "foreign_change_value_usd": {
      -            "anyOf": [
      -              {
      -                "minimum": 0,
      -                "type": "number"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "foreign_processing_labor_and_operations_usd": {
      -            "minimum": 0,
      -            "type": "number"
      -          },
      -          "foreign_repair_labor_and_operations_usd": {
      -            "minimum": 0,
      -            "type": "number"
      -          },
      -          "us_incurred_engineering_plans_tools_usd": {
      -            "minimum": 0,
      -            "type": "number"
      -          },
      -          "us_incurred_processing_support_costs_usd": {
      -            "minimum": 0,
      -            "type": "number"
      -          },
      -          "vessel_foreign_cost_usd": {
      -            "minimum": 0,
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "agricultural_safeguard": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "cotton": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "carded_or_combed": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "harsh_or_rough": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "perished_staple_grabbots_or_pickings": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "product_form": {
      -                "anyOf": [
      -                  {
      -                    "enum": [
      -                      "raw_cotton",
      -                      "card_strips",
      -                      "lap_waste",
      -                      "sliver_waste",
      -                      "roving_waste",
      -                      "processed_fibers"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "spun": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "staple_length_mm": {
      -                "anyOf": [
      -                  {
      -                    "exclusiveMinimum": 0,
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "white_in_color": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "evidence": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "kind": {
      -                  "enum": [
      -                    "classification_support",
      -                    "product_specification",
      -                    "customs_valuation",
      -                    "quantity_measurement"
      -                  ],
      -                  "type": "string"
      -                },
      -                "reference": {
      -                  "maxLength": 512,
      -                  "minLength": 1,
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "kind",
      -                "reference"
      -              ],
      -              "type": "object"
      -            },
      -            "maxItems": 20,
      -            "type": "array"
      -          },
      -          "food": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "article": {
      -                "anyOf": [
      -                  {
      -                    "enum": [
      -                      "chocolate",
      -                      "low_fat_chocolate_crumb",
      -                      "infant_formula",
      -                      "peanut_butter",
      -                      "peanut_paste",
      -                      "ice_cream",
      -                      "animal_feed",
      -                      "beef",
      -                      "sheep_meat",
      -                      "peanuts",
      -                      "sugar",
      -                      "syrup",
      -                      "molasses",
      -                      "milk",
      -                      "cream",
      -                      "buttermilk",
      -                      "butter",
      -                      "whey",
      -                      "butter_substitute",
      -                      "cheese",
      -                      "cheese_substitute",
      -                      "malted_milk",
      -                      "white_chocolate",
      -                      "dairy_preparation"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "butter_added_emulsifiers": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "butter_dehydrated_or_ghee": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "butter_exclusively_from_milk": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "butter_other_added_ingredients": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "butterfat_weight_pct": {
      -                "anyOf": [
      -                  {
      -                    "maximum": 100,
      -                    "minimum": 0,
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "capable_further_processing_or_mixing": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "cheese_contains_cows_milk": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "cheese_eye_formation": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "cheese_fat_moisture_free_pct": {
      -                "anyOf": [
      -                  {
      -                    "maximum": 100,
      -                    "minimum": 0,
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "cheese_form": {
      -                "anyOf": [
      -                  {
      -                    "enum": [
      -                      "fresh_unripened",
      -                      "grated_or_powdered",
      -                      "processed_not_grated_or_powdered",
      -                      "other"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "cheese_from_cows_milk": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "cheese_interior_mold": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "cheese_moisture_nonfat_matter_pct": {
      -                "anyOf": [
      -                  {
      -                    "maximum": 100,
      -                    "minimum": 0,
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "cheese_multiple_varieties": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "cheese_original_loaves": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "cheese_protective_covering_deducted": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "cheese_relation": {
      -                "anyOf": [
      -                  {
      -                    "enum": [
      -                      "is_named_cheese",
      -                      "contains_named_cheese",
      -                      "processed_from_named_cheese"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "cheese_ripens_surface_inwards": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "cheese_stilton_produced_uk": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "cheese_surface_biological_crust": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "cheese_variety": {
      -                "anyOf": [
      -                  {
      -                    "enum": [
      -                      "blue_mold",
      -                      "stilton",
      -                      "cheddar",
      -                      "american_type_other_than_cheddar",
      -                      "edam",
      -                      "gouda",
      -                      "romano",
      -                      "reggiano",
      -                      "parmesan",
      -                      "provolone",
      -                      "provoletti",
      -                      "sbrinz",
      -                      "goya",
      -                      "swiss_or_emmentaler",
      -                      "gruyere_process",
      -                      "cottage",
      -                      "chongos",
      -                      "margarine_cheese",
      -                      "other"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "commercial_edible_ingredient": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "contains_milk_or_milk_derivatives": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "contains_oligosaccharides": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "dairy_added_sweetening": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "dairy_condition": {
      -                "anyOf": [
      -                  {
      -                    "enum": [
      -                      "fresh",
      -                      "sour",
      -                      "other"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "dairy_form": {
      -                "anyOf": [
      -                  {
      -                    "enum": [
      -                      "fluid",
      -                      "frozen",
      -                      "dried",
      -                      "condensed",
      -                      "evaporated",
      -                      "other"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "dairy_in_airtight_container": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "dried_dairy_ingredient_type": {
      -                "anyOf": [
      -                  {
      -                    "enum": [
      -                      "milk_040210",
      -                      "milk_040221",
      -                      "buttermilk_040390",
      -                      "whey_040410",
      -                      "other"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "inedible_dried_milk_powder": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "infrared_calibration_certificate_declared": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "intended_customer_type": {
      -                "anyOf": [
      -                  {
      -                    "enum": [
      -                      "individual_consumer",
      -                      "institution",
      -                      "food_service"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "meat_bone_state": {
      -                "anyOf": [
      -                  {
      -                    "enum": [
      -                      "bone_in",
      -                      "boneless"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "meat_in_airtight_container": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "meat_normal_components_deducted": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "meat_temperature": {
      -                "anyOf": [
      -                  {
      -                    "enum": [
      -                      "fresh_or_chilled",
      -                      "frozen"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "meat_weight_includes_entire_contents": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "milk_or_cream_article": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "milk_solids_not_fat_weight_pct": {
      -                "anyOf": [
      -                  {
      -                    "maximum": 100,
      -                    "minimum": 0,
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "milk_solids_weight_pct": {
      -                "anyOf": [
      -                  {
      -                    "maximum": 100,
      -                    "minimum": 0,
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "mixed_with_other_ingredients": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "peanuts_in_shell": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "processing_only_by_ultimate_consumer": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "retail_candy_or_confection": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "retail_identical_form_package": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "water_weight_pct": {
      -                "anyOf": [
      -                  {
      -                    "maximum": 100,
      -                    "minimum": 0,
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "sugar": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "blended_syrup": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "cake_decoration_or_similar_product": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "cane_beet_sugars_dry_weight_pct": {
      -                "anyOf": [
      -                  {
      -                    "maximum": 100,
      -                    "minimum": 0,
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "capable_further_processing_or_mixing": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "cocoa_powder": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "contains_cane_or_beet_sugars": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "dry_amorphous_form": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "ground_coconut_meat_or_juice_with_sugars": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "mix_or_dough": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "mixed_condiment_or_seasoning": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "no_processing_except_direct_pastry_application": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "principally_crystalline_structure": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "retail_identical_form_and_package": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "sauce_or_sauce_preparation": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "valuation": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "customs_unit_value_unit": {
      -                "enum": [
      -                  "kg",
      -                  "liter"
      -                ],
      -                "type": "string"
      -              },
      -              "customs_unit_value_usd": {
      -                "pattern": "^\\d{1,18}(?:\\.\\d{1,12})?$",
      -                "type": "string"
      -              },
      -              "customs_value_usd": {
      -                "$ref": "#/properties/facts/additionalProperties/anyOf/5/properties/agricultural_safeguard/properties/valuation/properties/customs_unit_value_usd"
      -              },
      -              "net_mass_kg": {
      -                "$ref": "#/properties/facts/additionalProperties/anyOf/5/properties/agricultural_safeguard/properties/valuation/properties/customs_unit_value_usd"
      -              },
      -              "total_sugars_kg": {
      -                "$ref": "#/properties/facts/additionalProperties/anyOf/5/properties/agricultural_safeguard/properties/valuation/properties/customs_unit_value_usd"
      -              },
      -              "volume_liters": {
      -                "$ref": "#/properties/facts/additionalProperties/anyOf/5/properties/agricultural_safeguard/properties/valuation/properties/customs_unit_value_usd"
      -              }
      -            },
      -            "type": "object"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "exclusion": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "clause": {
      -            "maxLength": 64,
      -            "minLength": 1,
      -            "type": "string"
      -          },
      -          "facts": {
      -            "additionalProperties": {
      -              "anyOf": [
      -                {
      -                  "type": "string"
      -                },
      -                {
      -                  "minimum": 0,
      -                  "type": "number"
      -                },
      -                {
      -                  "type": "boolean"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ]
      -            },
      -            "type": "object"
      -          },
      -          "references": {
      -            "items": {
      -              "maxLength": 512,
      -              "minLength": 1,
      -              "type": "string"
      -            },
      -            "maxItems": 20,
      -            "type": "array"
      -          }
      -        },
      -        "required": [
      -          "clause"
      -        ],
      -        "type": "object"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "admitted_to_ftz_privileged_foreign_status_before_suspension": {
      -        "description": "The goods were admitted into a U.S. foreign trade zone in privileged foreign status (19 CFR 146.41) before March 4, 2021 (United Kingdom) or March 11, 2021 (EU member States)",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "applied_rate_derived_from_covered_subheading": {
      -        "description": "The entry's applied rate of duty under the enumerated subheading is derived from another subheading subject to the Section 301 additional duties the note names",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "importer_purchase_certification": {
      -        "description": "A certification by the importer that the cotton was purchased not later than 90 days after the effective date of the Secretary of Agriculture's announcement of the quota",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "producing_country_certificate": {
      -        "description": "Accompanied by an original certificate of an official of a government agency of the country in which the cotton was produced attesting that it is a variety of Gossypium hirsutum cotton",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "psf_entered_under_tib": {
      -        "description": "Admitted temporarily free of duty under bond and entered under statistical reporting number 9813.00.0520",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "sts_crane_annex_d_certification_filed": {
      -        "description": "The importer completed the certification in Annex D to 89 FR 76581 and provided it with the electronic entry summary by uploading it to the ACE Document Imaging System when declaring heading 9903.91.09",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "sts_crane_china_components": {
      -        "description": "The cranes are manufactured, assembled or made using components, assemblies or subassemblies that are products of China, as U.S. note 31(l)(ii) specifies (the boom, trolley, spreader, cabin, legs, cable reel, power supply, bogie set and wheels, or information technology equipment used to operate or control the crane)",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "sts_crane_contract_before_2024_05_14": {
      -        "description": "The cranes are fulfilling in whole or in part an executed contract for sale dated prior to May 14, 2024",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "sts_crane_contract_before_2025_04_17": {
      -        "description": "The importer attests that the cranes are fulfilling in whole or in part an executed contract for sale dated prior to April 17, 2025",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "sts_crane_manufacturer_chinese_owned_or_controlled": {
      -        "description": "The cranes are manufactured by a company or other entity that is owned or controlled by a Chinese person or legal entity, as U.S. note 31(l)(v) defines it",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "sts_gantry_crane": {
      -        "description": "The cranes are ship-to-shore gantry cranes, configured as a high- or low-profile steel superstructure and designed to unload intermodal containers from vessels with coupling devices for containers, including spreaders or twist-locks",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "upland_cotton": {
      -        "description": "The cotton is upland cotton, a variety of Gossypium hirsutum, and not Extra Long Staple (ELS) cotton",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "within_announced_quantity": {
      -        "description": "Entered within the quantity the Secretary of Agriculture's announcement specifies",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "within_note_32_quantity": {
      -        "description": "Entered within the annual aggregate quantity U.S. note 32(a) specifies for the period",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "within_note_7_quantity": {
      -        "description": "Entered within the additional quantity and its quarterly (9903.54.01) or 30-day (9903.54.02) limit under U.S. note 7",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "direct_to_consumption_container": {
      -        "description": "The alcohol product is in bottles, cans, boxes, kegs or other similar direct-to-consumption containers.",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "import_adjustment_offset": {
      -        "description": "U.S. note 51(c)(3) and (6): a vehicle part subject to an import adjustment offset under Proclamation 10925 or 10984.",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "importation_time": {
      -        "anyOf": [
      -          {
      -            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})$",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Date and time of importation with a UTC offset, e.g. 2026-09-29T08:30:00-04:00. Must not be later than the entry date."
      -      },
      -      "personal_use_accompanied_baggage": {
      -        "description": "U.S. note 51(a): products for personal use in the accompanied baggage of a person arriving in the United States. True removes the Section 338 duty.",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "us_content_approved": {
      -        "description": "U.S. note 51(c)(2): a 9903.94.02 entry applies to Commerce-approved U.S. content of a passenger vehicle or light truck.",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "claimed": {
      -        "description": "The entry claims special tariff treatment. False alone calculates at the General rate.",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "evidence_on_file": {
      -        "description": "The certification or other evidence the claim requires is on file.",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "heading": {
      -        "anyOf": [
      -          {
      -            "pattern": "^(?:98(?:22|23)|99\\d{2})\\.?\\d{2}\\.?\\d{2}$",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Chapter 98 subchapter XXII or XXIII, or Chapter 99, subheading the entry is claimed under (e.g. 9823.01.02, 9919.04.51), when the Special subcolumn refers the program to subheadings with different rates."
      -      },
      -      "origin_qualified": {
      -        "description": "The goods qualify as originating under the program's rules of origin.",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "program": {
      -        "anyOf": [
      -          {
      -            "pattern": "^[A-Za-z]{1,2}[*+]?$",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Program symbol as the HTS Special subcolumn prints it, e.g. KR, S, S+, P, AU."
      -      },
      -      "quota_available": {
      -        "description": "Quota is available for the claim; required as true for a Chapter 98 or 99 subheading under a quantitative limitation.",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "wholly_obtained_from_canadian_sugar_beets": {
      -        "description": "For 9823.09.02, the goods are wholly obtained from sugar beets produced in Canada (U.S. note 9(b)(1)). This is an importer declaration, not verified origin.",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "type": "boolean"
      +  },
      +  {
      +    "type": "null"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "components": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "charge_made": {
      +              "type": [
      +                "boolean",
      +                "null"
      +              ]
      +            },
      +            "fabric_component": {
      +              "type": [
      +                "boolean",
      +                "null"
      +              ]
      +            },
      +            "fabricated": {
      +              "type": [
      +                "boolean",
      +                "null"
      +              ]
      +            },
      +            "foreign_operations_only_assembly_or_incidental": {
      +              "type": [
      +                "boolean",
      +                "null"
      +              ]
      +            },
      +            "id": {
      +              "pattern": "^[A-Za-z0-9_-]{1,64}$",
      +              "type": "string"
      +            },
      +            "last_purchase_cost_usd": {
      +              "anyOf": [
      +                {
      +                  "minimum": 0,
      +                  "type": "number"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            },
      +            "physical_identity_preserved": {
      +              "type": [
      +                "boolean",
      +                "null"
      +              ]
      +            },
      +            "product_of_us": {
      +              "type": [
      +                "boolean",
      +                "null"
      +              ]
      +            },
      +            "ready_for_assembly_without_further_fabrication": {
      +              "type": [
      +                "boolean",
      +                "null"
      +              ]
      +            },
      +            "shipment_value_at_export_usd": {
      +              "anyOf": [
      +                {
      +                  "minimum": 0,
      +                  "type": "number"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            },
      +            "value_usd": {
      +              "anyOf": [
      +                {
      +                  "minimum": 0,
      +                  "type": "number"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            },
      +            "visible_lining_fabric": {
      +              "type": [
      +                "boolean",
      +                "null"
      +              ]
      +            },
      +            "wholly_formed_and_cut_in_us": {
      +              "type": [
      +                "boolean",
      +                "null"
      +              ]
      +            }
      +          },
      +          "required": [
      +            "id"
      +          ],
      +          "type": "object"
      +        },
      +        "maxItems": 100,
      +        "type": "array"
      +      },
      +      "evidence": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "kind": {
      +              "enum": [
      +                "exhibition_officer_declaration",
      +                "exhibition_form301_bond",
      +                "temporary_entry_security",
      +                "temporary_article_identity_records",
      +                "temporary_nonresident_status_records",
      +                "temporary_professional_status_records",
      +                "temporary_event_or_breeding_records",
      +                "accessibility_ita_information",
      +                "scientific_stamped_application",
      +                "scientific_final_determination",
      +                "scientific_order_proof",
      +                "institution_instrument_certification",
      +                "institution_artist_proof",
      +                "foreign_personnel_customs_instruction",
      +                "foreign_personnel_state_request",
      +                "foreign_personnel_reciprocity_determination",
      +                "foreign_personnel_status_instructions",
      +                "foreign_property_customs_instruction",
      +                "foreign_organization_designation",
      +                "government_bureau_head_request",
      +                "government_free_entry_certificate",
      +                "state_department_request",
      +                "government_property_certification",
      +                "government_waiver_agency_request",
      +                "government_orders",
      +                "government_effects_declaration",
      +                "owner_form_3299",
      +                "household_use_evidence",
      +                "passenger_declaration",
      +                "decedent_citizenship_statement",
      +                "estate_entry_documents",
      +                "conveyance_identification",
      +                "replacement_form_4455",
      +                "unaccompanied_form_255",
      +                "unaccompanied_purchase_records",
      +                "iit_designation",
      +                "container_import_intention",
      +                "container_bond",
      +                "plant_pest_admissibility",
      +                "container_reporting_program",
      +                "foreign_shipper_declaration",
      +                "importer_declaration",
      +                "repairer_declaration",
      +                "repair_process_records",
      +                "repair_identity_records",
      +                "processor_declaration",
      +                "assembler_declaration",
      +                "component_cost_records",
      +                "program_certificate_of_origin",
      +                "metal_processing_records",
      +                "metal_identity_records",
      +                "cbp_documentary_waiver",
      +                "cbp_additional_evidence_request",
      +                "drawback_tax_records",
      +                "internal_revenue_bond_return_records",
      +                "vessel_owner_master_certificate",
      +                "temporary_return_exporter_records",
      +                "temporary_return_use_records",
      +                "animal_border_return_records"
      +              ],
      +              "type": "string"
      +            },
      +            "reference": {
      +              "maxLength": 512,
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "kind",
      +            "reference"
      +          ],
      +          "type": "object"
      +        },
      +        "maxItems": 20,
      +        "type": "array"
      +      },
      +      "facts": {
      +        "additionalProperties": {
      +          "type": [
      +            "string",
      +            "number",
      +            "boolean",
      +            "null"
      +          ]
      +        },
      +        "type": "object"
      +      },
      +      "statistical_quantities": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "amount": {
      +              "exclusiveMinimum": 0,
      +              "type": "number"
      +            },
      +            "unit": {
      +              "maxLength": 64,
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "unit",
      +            "amount"
      +          ],
      +          "type": "object"
      +        },
      +        "maxItems": 3,
      +        "type": "array"
      +      },
      +      "valuation": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "articles_furnished_for_repair_value_usd": {
      +            "minimum": 0,
      +            "type": "number"
      +          },
      +          "articles_used_in_foreign_processing_value_usd": {
      +            "minimum": 0,
      +            "type": "number"
      +          },
      +          "foreign_change_value_usd": {
      +            "anyOf": [
      +              {
      +                "minimum": 0,
      +                "type": "number"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "foreign_processing_labor_and_operations_usd": {
      +            "minimum": 0,
      +            "type": "number"
      +          },
      +          "foreign_repair_labor_and_operations_usd": {
      +            "minimum": 0,
      +            "type": "number"
      +          },
      +          "us_incurred_engineering_plans_tools_usd": {
      +            "minimum": 0,
      +            "type": "number"
      +          },
      +          "us_incurred_processing_support_costs_usd": {
      +            "minimum": 0,
      +            "type": "number"
      +          },
      +          "vessel_foreign_cost_usd": {
      +            "minimum": 0,
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "agricultural_safeguard": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "cotton": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "carded_or_combed": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "harsh_or_rough": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "perished_staple_grabbots_or_pickings": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "product_form": {
      +                "anyOf": [
      +                  {
      +                    "enum": [
      +                      "raw_cotton",
      +                      "card_strips",
      +                      "lap_waste",
      +                      "sliver_waste",
      +                      "roving_waste",
      +                      "processed_fibers"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "spun": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "staple_length_mm": {
      +                "anyOf": [
      +                  {
      +                    "exclusiveMinimum": 0,
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "white_in_color": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "evidence": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "kind": {
      +                  "enum": [
      +                    "classification_support",
      +                    "product_specification",
      +                    "customs_valuation",
      +                    "quantity_measurement"
      +                  ],
      +                  "type": "string"
      +                },
      +                "reference": {
      +                  "maxLength": 512,
      +                  "minLength": 1,
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "kind",
      +                "reference"
      +              ],
      +              "type": "object"
      +            },
      +            "maxItems": 20,
      +            "type": "array"
      +          },
      +          "food": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "article": {
      +                "anyOf": [
      +                  {
      +                    "enum": [
      +                      "chocolate",
      +                      "low_fat_chocolate_crumb",
      +                      "infant_formula",
      +                      "peanut_butter",
      +                      "peanut_paste",
      +                      "ice_cream",
      +                      "animal_feed",
      +                      "beef",
      +                      "sheep_meat",
      +                      "peanuts",
      +                      "sugar",
      +                      "syrup",
      +                      "molasses",
      +                      "milk",
      +                      "cream",
      +                      "buttermilk",
      +                      "butter",
      +                      "whey",
      +                      "butter_substitute",
      +                      "cheese",
      +                      "cheese_substitute",
      +                      "malted_milk",
      +                      "white_chocolate",
      +                      "dairy_preparation"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "butter_added_emulsifiers": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "butter_dehydrated_or_ghee": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "butter_exclusively_from_milk": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "butter_other_added_ingredients": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "butterfat_weight_pct": {
      +                "anyOf": [
      +                  {
      +                    "maximum": 100,
      +                    "minimum": 0,
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "capable_further_processing_or_mixing": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "cheese_contains_cows_milk": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "cheese_eye_formation": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "cheese_fat_moisture_free_pct": {
      +                "anyOf": [
      +                  {
      +                    "maximum": 100,
      +                    "minimum": 0,
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "cheese_form": {
      +                "anyOf": [
      +                  {
      +                    "enum": [
      +                      "fresh_unripened",
      +                      "grated_or_powdered",
      +                      "processed_not_grated_or_powdered",
      +                      "other"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "cheese_from_cows_milk": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "cheese_interior_mold": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "cheese_moisture_nonfat_matter_pct": {
      +                "anyOf": [
      +                  {
      +                    "maximum": 100,
      +                    "minimum": 0,
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "cheese_multiple_varieties": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "cheese_original_loaves": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "cheese_protective_covering_deducted": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "cheese_relation": {
      +                "anyOf": [
      +                  {
      +                    "enum": [
      +                      "is_named_cheese",
      +                      "contains_named_cheese",
      +                      "processed_from_named_cheese"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "cheese_ripens_surface_inwards": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "cheese_stilton_produced_uk": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "cheese_surface_biological_crust": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "cheese_variety": {
      +                "anyOf": [
      +                  {
      +                    "enum": [
      +                      "blue_mold",
      +                      "stilton",
      +                      "cheddar",
      +                      "american_type_other_than_cheddar",
      +                      "edam",
      +                      "gouda",
      +                      "romano",
      +                      "reggiano",
      +                      "parmesan",
      +                      "provolone",
      +                      "provoletti",
      +                      "sbrinz",
      +                      "goya",
      +                      "swiss_or_emmentaler",
      +                      "gruyere_process",
      +                      "cottage",
      +                      "chongos",
      +                      "margarine_cheese",
      +                      "other"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "commercial_edible_ingredient": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "contains_milk_or_milk_derivatives": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "contains_oligosaccharides": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "dairy_added_sweetening": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "dairy_condition": {
      +                "anyOf": [
      +                  {
      +                    "enum": [
      +                      "fresh",
      +                      "sour",
      +                      "other"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "dairy_form": {
      +                "anyOf": [
      +                  {
      +                    "enum": [
      +                      "fluid",
      +                      "frozen",
      +                      "dried",
      +                      "condensed",
      +                      "evaporated",
      +                      "other"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "dairy_in_airtight_container": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "dried_dairy_ingredient_type": {
      +                "anyOf": [
      +                  {
      +                    "enum": [
      +                      "milk_040210",
      +                      "milk_040221",
      +                      "buttermilk_040390",
      +                      "whey_040410",
      +                      "other"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "inedible_dried_milk_powder": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "infrared_calibration_certificate_declared": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "intended_customer_type": {
      +                "anyOf": [
      +                  {
      +                    "enum": [
      +                      "individual_consumer",
      +                      "institution",
      +                      "food_service"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "meat_bone_state": {
      +                "anyOf": [
      +                  {
      +                    "enum": [
      +                      "bone_in",
      +                      "boneless"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "meat_in_airtight_container": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "meat_normal_components_deducted": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "meat_temperature": {
      +                "anyOf": [
      +                  {
      +                    "enum": [
      +                      "fresh_or_chilled",
      +                      "frozen"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "meat_weight_includes_entire_contents": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "milk_or_cream_article": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "milk_solids_not_fat_weight_pct": {
      +                "anyOf": [
      +                  {
      +                    "maximum": 100,
      +                    "minimum": 0,
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "milk_solids_weight_pct": {
      +                "anyOf": [
      +                  {
      +                    "maximum": 100,
      +                    "minimum": 0,
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "mixed_with_other_ingredients": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "peanuts_in_shell": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "processing_only_by_ultimate_consumer": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "retail_candy_or_confection": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "retail_identical_form_package": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "water_weight_pct": {
      +                "anyOf": [
      +                  {
      +                    "maximum": 100,
      +                    "minimum": 0,
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "sugar": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "blended_syrup": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "cake_decoration_or_similar_product": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "cane_beet_sugars_dry_weight_pct": {
      +                "anyOf": [
      +                  {
      +                    "maximum": 100,
      +                    "minimum": 0,
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "capable_further_processing_or_mixing": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "cocoa_powder": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "contains_cane_or_beet_sugars": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "dry_amorphous_form": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "ground_coconut_meat_or_juice_with_sugars": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "mix_or_dough": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "mixed_condiment_or_seasoning": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "no_processing_except_direct_pastry_application": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "principally_crystalline_structure": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "retail_identical_form_and_package": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "sauce_or_sauce_preparation": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "valuation": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "customs_unit_value_unit": {
      +                "enum": [
      +                  "kg",
      +                  "liter"
      +                ],
      +                "type": "string"
      +              },
      +              "customs_unit_value_usd": {
      +                "pattern": "^\\d{1,18}(?:\\.\\d{1,12})?$",
      +                "type": "string"
      +              },
      +              "customs_value_usd": {
      +                "$ref": "#/properties/facts/additionalProperties/anyOf/5/properties/agricultural_safeguard/properties/valuation/properties/customs_unit_value_usd"
      +              },
      +              "net_mass_kg": {
      +                "$ref": "#/properties/facts/additionalProperties/anyOf/5/properties/agricultural_safeguard/properties/valuation/properties/customs_unit_value_usd"
      +              },
      +              "total_sugars_kg": {
      +                "$ref": "#/properties/facts/additionalProperties/anyOf/5/properties/agricultural_safeguard/properties/valuation/properties/customs_unit_value_usd"
      +              },
      +              "volume_liters": {
      +                "$ref": "#/properties/facts/additionalProperties/anyOf/5/properties/agricultural_safeguard/properties/valuation/properties/customs_unit_value_usd"
      +              }
      +            },
      +            "type": "object"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "exclusion": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "clause": {
      +            "maxLength": 64,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "facts": {
      +            "additionalProperties": {
      +              "anyOf": [
      +                {
      +                  "type": "string"
      +                },
      +                {
      +                  "minimum": 0,
      +                  "type": "number"
      +                },
      +                {
      +                  "type": "boolean"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            },
      +            "type": "object"
      +          },
      +          "references": {
      +            "items": {
      +              "maxLength": 512,
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "maxItems": 20,
      +            "type": "array"
      +          }
      +        },
      +        "required": [
      +          "clause"
      +        ],
      +        "type": "object"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "admitted_to_ftz_privileged_foreign_status_before_suspension": {
      +        "description": "The goods were admitted into a U.S. foreign trade zone in privileged foreign status (19 CFR 146.41) before March 4, 2021 (United Kingdom) or March 11, 2021 (EU member States)",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "applied_rate_derived_from_covered_subheading": {
      +        "description": "The entry's applied rate of duty under the enumerated subheading is derived from another subheading subject to the Section 301 additional duties the note names",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "importer_purchase_certification": {
      +        "description": "A certification by the importer that the cotton was purchased not later than 90 days after the effective date of the Secretary of Agriculture's announcement of the quota",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "producing_country_certificate": {
      +        "description": "Accompanied by an original certificate of an official of a government agency of the country in which the cotton was produced attesting that it is a variety of Gossypium hirsutum cotton",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "psf_entered_under_tib": {
      +        "description": "Admitted temporarily free of duty under bond and entered under statistical reporting number 9813.00.0520",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "sts_crane_annex_d_certification_filed": {
      +        "description": "The importer completed the certification in Annex D to 89 FR 76581 and provided it with the electronic entry summary by uploading it to the ACE Document Imaging System when declaring heading 9903.91.09",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "sts_crane_china_components": {
      +        "description": "The cranes are manufactured, assembled or made using components, assemblies or subassemblies that are products of China, as U.S. note 31(l)(ii) specifies (the boom, trolley, spreader, cabin, legs, cable reel, power supply, bogie set and wheels, or information technology equipment used to operate or control the crane)",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "sts_crane_contract_before_2024_05_14": {
      +        "description": "The cranes are fulfilling in whole or in part an executed contract for sale dated prior to May 14, 2024",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "sts_crane_contract_before_2025_04_17": {
      +        "description": "The importer attests that the cranes are fulfilling in whole or in part an executed contract for sale dated prior to April 17, 2025",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "sts_crane_manufacturer_chinese_owned_or_controlled": {
      +        "description": "The cranes are manufactured by a company or other entity that is owned or controlled by a Chinese person or legal entity, as U.S. note 31(l)(v) defines it",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "sts_gantry_crane": {
      +        "description": "The cranes are ship-to-shore gantry cranes, configured as a high- or low-profile steel superstructure and designed to unload intermodal containers from vessels with coupling devices for containers, including spreaders or twist-locks",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "upland_cotton": {
      +        "description": "The cotton is upland cotton, a variety of Gossypium hirsutum, and not Extra Long Staple (ELS) cotton",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "within_announced_quantity": {
      +        "description": "Entered within the quantity the Secretary of Agriculture's announcement specifies",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "within_note_32_quantity": {
      +        "description": "Entered within the annual aggregate quantity U.S. note 32(a) specifies for the period",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "within_note_7_quantity": {
      +        "description": "Entered within the additional quantity and its quarterly (9903.54.01) or 30-day (9903.54.02) limit under U.S. note 7",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "direct_to_consumption_container": {
      +        "description": "The alcohol product is in bottles, cans, boxes, kegs or other similar direct-to-consumption containers.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "import_adjustment_offset": {
      +        "description": "U.S. note 51(c)(3) and (6): a vehicle part subject to an import adjustment offset under Proclamation 10925 or 10984.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "importation_time": {
      +        "anyOf": [
      +          {
      +            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})$",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Date and time of importation with a UTC offset, e.g. 2026-09-29T08:30:00-04:00. Must not be later than the entry date."
      +      },
      +      "personal_use_accompanied_baggage": {
      +        "description": "U.S. note 51(a): products for personal use in the accompanied baggage of a person arriving in the United States. True removes the Section 338 duty.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "us_content_approved": {
      +        "description": "U.S. note 51(c)(2): a 9903.94.02 entry applies to Commerce-approved U.S. content of a passenger vehicle or light truck.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "claimed": {
      +        "description": "The entry claims special tariff treatment. False alone calculates at the General rate.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "evidence_on_file": {
      +        "description": "The certification or other evidence the claim requires is on file.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "heading": {
      +        "anyOf": [
      +          {
      +            "pattern": "^(?:98(?:22|23)|99\\d{2})\\.?\\d{2}\\.?\\d{2}$",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Chapter 98 subchapter XXII or XXIII, or Chapter 99, subheading the entry is claimed under (e.g. 9823.01.02, 9919.04.51), when the Special subcolumn refers the program to subheadings with different rates."
      +      },
      +      "origin_qualified": {
      +        "description": "The goods qualify as originating under the program's rules of origin.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "program": {
      +        "anyOf": [
      +          {
      +            "pattern": "^[A-Za-z]{1,2}[*+]?$",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Program symbol as the HTS Special subcolumn prints it, e.g. KR, S, S+, P, AU."
      +      },
      +      "quota_available": {
      +        "description": "Quota is available for the claim; required as true for a Chapter 98 or 99 subheading under a quantitative limitation.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "wholly_obtained_from_canadian_sugar_beets": {
      +        "description": "For 9823.09.02, the goods are wholly obtained from sugar beets produced in Canada (U.S. note 9(b)(1)). This is an importer declaration, not verified origin.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "description": "Reference-only article statements. Only unanimously negative statements bound to the exact source quote, classification and date can rule out supported described-article scope. Positive, stale and conflicting statements never grant relief. References are not verified.",
      +    "items": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "as_of": {
      +          "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      +          "type": "string"
      +        },
      +        "description": {
      +          "maxLength": 2000,
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "hts_code": {
      +          "pattern": "^(?:0[1-9]|[1-8][0-9]|9[0-7])[0-9]{8}$",
      +          "type": "string"
      +        },
      +        "matches_description": {
      +          "type": "boolean"
      +        },
      +        "reference": {
      +          "maxLength": 512,
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "source_sha256": {
      +          "pattern": "^[a-f0-9]{64}$",
      +          "type": "string"
      +        },
      +        "source_url": {
      +          "maxLength": 2048,
      +          "pattern": "^https:\\/\\/[^\\s]+$",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "source_url",
      +        "source_sha256",
      +        "description",
      +        "hts_code",
      +        "as_of",
      +        "matches_description",
      +        "reference"
      +      ],
      +      "type": "object"
      +    },
      +    "maxItems": 20,
      +    "minItems": 1,
      +    "type": "array"
      +  }
      +]
    • addedInput schema / properties / save_replay
      Added value: +{
      +  "description": "With assessment_contract full, retain the original assessment for replay. Requires Pro or higher and Tariff Assurance availability.",
      +  "type": "boolean"
      +}
  3. First observed

TDQS

A3.6/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Goes beyond the annotations by disclosing authentication modes (API key, OAuth, x402), the returned cost decomposition, the fact that fact-dependent treatment is not estimated, and that save_replay requires Pro or higher with Tariff Assurance availability. No contradiction with readOnlyHint=false, since retaining a replay is a write side effect; that link is implied rather than stated explicitly.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loads access requirements, then purpose, then the response split, then the opt-in flag — a sensible order with no filler. The opening 'Access:' sentence is useful but slightly crowds out the core purpose, which could have led.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 15-parameter tool with nested objects and no output schema, describing the response decomposition is valuable and the contract/save_replay interaction is covered. However, error behavior (refusals, unimplemented claim review responses) and the bulk of the required/optional parameter semantics are only in the schema, leaving the description thin relative to tool complexity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 47% across 15 parameters, so the description must compensate. It adds real meaning for only two of them (assessment_contract and save_replay, including their interaction), and says nothing about hts, country, value, claims, quantities, or quota_state, which the schema documents in detail.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Uses a specific verb+resource ('Calculate supported US duty layers and fees for one import line') and names the output distinction between total import charges and total landed cost. It implicitly separates itself from a plain lookup or full entry assessment, but never names a sibling tool, so cross-tool disambiguation is left to inference.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Implies scope ('one import line') and states a concrete conditional ('Set assessment_contract to full for the full charge assessment, including safeguards'), plus the Pro-or-higher gate for save_replay. It never states when to choose this over assess_import_entry, audit_entry, or replay_tariff, nor when not to use it.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources