HS Code Lookup

Suggest HS commodity codes for a product description, with alternatives and confidence. A suggestion, not an official customs classification.

Pay by wallet (x402) AI-generated hs-code-lookup

Example

Input

{
  "product": "cotton t-shirt"
}

Answer

{
  "notes": "Knitted cotton T-shirts classify under 6109.10. Blended-fabric shirts may fall under 6109.90 depending on fibre composition. Verify with binding tariff information for customs filings.",
  "query": "cotton t-shirt",
  "chapter": "61",
  "section": "Section XI — Textiles and textile articles",
  "confidence": "high",
  "primary_hs_code": "6109.10",
  "alternative_codes": [
    {
      "hs_code": "6109.90",
      "confidence": "medium",
      "description": "T-shirts of other textile materials (if not pure cotton)"
    }
  ],
  "chapter_description": "Articles of apparel and clothing accessories, knitted or crocheted",
  "primary_description": "T-shirts, singlets and other vests, knitted or crocheted, of cotton"
}

Inputs

Field	Type	Required	What it is
`product`	string	Yes	Product description to classify

Output fields

How reliably each field appears in a successful answer.

Field	Type	Appears
`chapter`	string	Always (present in every successful answer)
`confidence`	string	Always (present in every successful answer)
`primary_hs_code`	string	Always (present in every successful answer)
`alternative_codes`	array	Always (present in every successful answer)
`primary_description`	string	Always (present in every successful answer)

How to call it

The same tool through each route. MCP clients reach it through Strale’s server at https://api.strale.io/mcp; the call below is what the agent sends.

# Needs an API key. max_price_cents caps what this call may cost.
curl -X POST https://api.strale.io/v1/do \
  -H "Authorization: Bearer $STRALE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "capability_slug": "hs-code-lookup",
    "inputs": {
      "product": "cotton t-shirt"
    },
    "max_price_cents": 3
  }'

{
  "tool": "strale_execute",
  "arguments": {
    "slug": "hs-code-lookup",
    "inputs": {
      "product": "cotton t-shirt"
    },
    "max_price_cents": 3
  }
}

import { Strale } from "straleio";

const strale = new Strale({ apiKey: process.env.STRALE_API_KEY! });
const result = await strale.do({
  capability_slug: "hs-code-lookup",
  inputs: {
    "product": "cotton t-shirt"
  },
  max_price_cents: 3,
});

import os
from straleio import Strale, DoRequest

strale = Strale(api_key=os.environ["STRALE_API_KEY"])
result = strale.do(DoRequest(
    capability_slug="hs-code-lookup",
    inputs={
        "product": "cotton t-shirt",
    },
    max_price_cents=3,
))

# No account. The first request answers 402 with the price in USDC;
# an x402 client pays it from your wallet and repeats the request.
curl -i 'https://api.strale.io/x402/v2/hs-code-lookup?product=cotton+t-shirt'

Limitations

HS code suggestions require official confirmation
AI-based HS code suggestion — official classification requires customs authority review and binding tariff information
What to do instead: Use the suggested HS code as a starting point and verify with your customs broker or national tariff database
HS edition changes may not be reflected
Classifications come from the model's knowledge of HS nomenclature, which is pinned to its training cutoff. Codes changed in the most recent HS revision (HS2022 → HS2028 cycle) may be suggested in their older form.
What to do instead: Cross-check the suggested code against your national tariff database's current edition