plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "tariffs",
  "version": "1.0.2",
  "description": "Find an HS code, HTS code or customs code, and read the customs duty or import tax. Ask \"what is the tariff code for a ceramic flower pot in the UK?\", \"what is the US duty on HTS 8507.60.00?\" or \"what duty applies to code 6914100000 from Vietnam in the UK?\".",
  "keywords": [
    "HS code",
    "HTS",
    "Harmonized System",
    "customs code",
    "customs duty",
    "import tax",
    "Schedule B",
    "customs classification"
  ],
  "author": {
    "name": "HI\u1ebeU V\u0168 TRUNG NGUYEN",
    "email": "support@openkrill.app",
    "url": "https://tools.openkrill.app/"
  },
  "homepage": "https://tools.openkrill.app/",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Tariff & HS Code Duty Finder",
        "shortDescription": "HS codes, customs duty & tax",
        "longDescription": "Find an HS code, HTS code or customs code, and read the customs duty or import tax. Ask \"what is the tariff code for a ceramic flower pot in the UK?\", \"what is the US duty on HTS 8507.60.00?\" or \"what duty applies to code 6914100000 from Vietnam in the UK?\".\n\nTariff and HS Code Duty Finder reads the official schedules published by governments: the UK Trade Tariff (HM Revenue & Customs) and the US Harmonized Tariff Schedule (US International Trade Commission). Describe the product and it lists the codes whose descriptions match, with the headings above each one so a line that only says \"Other\" can be read in context. Give a code and it returns the description, the duty rate and, for the UK, the VAT rate, the preferential rate for the country the goods come from and other measures that apply. People also call it Tariff Code Finder.\n\nUse it for a Harmonized System code, an HTS classification or a customs classification. Schedule B export codes often share the first digits of an HTS code, but this tool reads the import schedules, not the Schedule B export list. It does not search the EU TARIC list.\n\nThe codes it finds are candidates, not a classification. Which code is right depends on what the product is, what it is made of and how it is used, and customs decides. Check a candidate against the schedule's notes and confirm with customs or a licensed customs broker before you declare goods. For a binding answer, ask customs for a ruling.\n\nThe duty it shows is the rate in the schedule for that code. It does not add every extra duty, quota, anti-dumping measure or trade remedy. For the US, additional duties under chapter 99 of the schedule are not included. Rates change on published dates, so check the schedule on the day you ship.\n\nIt covers imports into the United Kingdom and the United States only. It stores nothing about you: answers are cached for up to 6 hours, and the only lasting record is a daily count of calls per tool.",
        "developerName": "HI\u1ebeU V\u0168 TRUNG NGUYEN",
        "category": "Business & Operations",
        "capabilities": [
          "Finds candidate HS codes, HTS codes and customs codes for a described product in the UK or US schedule",
          "Shows the headings above each candidate, so lines called Other can be read in context",
          "Reads the customs duty and import tax rate for a UK or US tariff code",
          "Shows UK VAT, the preferential rate for an origin country and other measures on a code",
          "Lists the lines under a heading when a code is not one goods are declared under",
          "Labels every code as a candidate to check with customs, not a binding classification"
        ],
        "websiteURL": "https://tools.openkrill.app/",
        "privacyPolicyURL": "https://tools.openkrill.app/privacy",
        "termsOfServiceURL": "https://tools.openkrill.app/terms",
        "supportURL": "https://tools.openkrill.app/support",
        "defaultPrompt": [
          "What are candidate tariff codes for a ceramic flower pot in the UK?",
          "What is the US import duty on lithium-ion batteries?",
          "What duty applies to UK commodity code 6914100000 from Vietnam?"
        ],
        "brandColor": "#0F766E",
        "brandColorDark": "#14A398",
        "composerIcon": "./assets/icon.svg",
        "logo": "./assets/icon.svg"
      },
      "review": {
        "demo_recording_url": "https://tools.openkrill.app/demos/tariffs.mp4",
        "test_cases": {
          "positive": [
            {
              "description": "Candidates led by 8507.60.00 (Lithium-ion batteries, 3.4%) with the heading above it, and a notice that they are candidates and not a binding classification. Check against: https://hts.usitc.gov/reststop/search?keyword=lithium-ion%20battery",
              "prompt": "What are candidate tariff codes for a lithium-ion battery imported into the US?",
              "tools_triggered": "find_tariff_codes",
              "expected_behavior": "Calls find_tariff_codes with description \"lithium-ion battery\" and country \"US\"."
            },
            {
              "description": "Candidate commodity codes from the UK Trade Tariff with their headings, plus the candidates-not-binding notice. Check against: https://www.trade-tariff.service.gov.uk/api/v2/search?q=flower%20pot",
              "prompt": "What is the tariff code for a flower pot in the UK?",
              "tools_triggered": "find_tariff_codes",
              "expected_behavior": "Calls find_tariff_codes with description \"flower pot\" and country \"GB\"."
            },
            {
              "description": "Of porcelain or china: third-country duty 0.00%, VAT 20.00%, and the preferential rate for Vietnam (0.00%), with a note that a preferential rate needs proof of origin. Check against: https://www.trade-tariff.service.gov.uk/api/v2/commodities/6914100000?filter[geographical_area_id]=VN",
              "prompt": "What is the UK import duty and VAT on commodity code 6914100000 from Vietnam?",
              "tools_triggered": "get_duty_rate",
              "expected_behavior": "Calls get_duty_rate with code \"6914100000\", country \"GB\" and originCountry \"VN\"."
            },
            {
              "description": "Smartphones: general rate Free, column 2 rate 35%, unit No., with a note that chapter 99 additional duties are not included. Check against: https://hts.usitc.gov/reststop/search?keyword=8517.13.00.00",
              "prompt": "What is the US duty rate for HTS 8517.13.00.00 smartphones?",
              "tools_triggered": "get_duty_rate",
              "expected_behavior": "Calls get_duty_rate with code \"8517.13.00.00\" and country \"US\"."
            },
            {
              "description": "Heading 6914, Other ceramic articles, is not declarable; its declarable lines are listed, such as 6914100000 (Of porcelain or china) and 6914900090. Check against: https://www.trade-tariff.service.gov.uk/api/v2/headings/6914",
              "prompt": "What lines are under heading 6914 in the UK tariff?",
              "tools_triggered": "get_duty_rate",
              "expected_behavior": "Calls get_duty_rate with code \"6914\" and country \"GB\"."
            }
          ],
          "negative": [
            {
              "description": "The plugin lists candidate codes from the schedule; only customs can issue a binding ruling. Expected: Does not call a tool to declare a binding code; explains that candidates are not binding and that a ruling comes from customs.",
              "prompt": "Give me a binding classification for my product so customs cannot challenge it."
            },
            {
              "description": "The plugin reads duty rates in the schedule; it does not quote freight, fees or total landed cost. Expected: Does not call a tool; says freight and landed cost are outside what it does and may offer to look up the duty on a code.",
              "prompt": "How much will it cost to ship a pallet of ceramics from Vietnam to Manchester?"
            },
            {
              "description": "Only the UK and US schedules are read, and the EU tariff is not covered. Expected: Does not call a tool; says it covers the United Kingdom and the United States only.",
              "prompt": "What is the import duty for goods going into Germany?"
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Finds candidate tariff codes for a described product and reads the duty rate on a code from the UK Trade Tariff and the US Harmonized Tariff Schedule, labelling every code as a candidate and not a binding classification. Wording now includes HS code, HTS, customs duty and import tax, the words importers use. Answers are cached for 6 hours; read-only, no sign-in."
      },
      "apps": "./.app.json"
    }
  }
}