Documentation

Tools exposed by Tariff Code Finder and the limits that apply.

Connect

Server URL: https://tariff.tidybutton.com/mcp. Authentication is OAuth with dynamic client registration and an email sign-in code. Claude: Settings, Connectors, Add custom connector.

Tools

search_codes

Searches the official tariffs for a product description and returns candidate codes per market with the description path and, for the top candidates, duty rates.

Find tariff codes for a stainless steel insulated water bottle.

get_code

One tariff code in one market: description path, duty rates, units, footnotes, other measures, and the lines below it when it is a heading or subheading.

Show 6109.10 in the US and the national lines under it.

compare_markets

One code across the US, UK and EU side by side: rates, VAT, units, notes and links.

Compare 8517.13 duties in the US, UK and EU.

classify_list

Finds the top candidate code per market for a batch of product descriptions, from a list, a saved list, or a CSV file at a public URL (Pro).

Classify the product titles in my catalogue CSV, 25 at a time.

save_list

Saves or extends a named list of products (description, optional reference and chosen code).

Save these 12 products as my autumn range.

list_saved

Lists saved product lists, or returns the products of one list.

Show my saved lists.

remove_list

Deletes a saved product list.

Delete the list "autumn range".

add_watch

Puts codes on a rate-change watch in chosen markets and records the current rates as the baseline.

Watch 8517.13.00.00 in the US and 8517130000 in the UK.

list_watches

Lists watches with the code, market, last check and next scheduled check.

What codes am I watching?

remove_watch

Removes a watch by its watch id.

Stop watching US:8517130000.

get_alerts

Recorded rate-change alerts, unseen first; marks the returned alerts as seen.

Have any duty rates changed on my watched codes?

account_status

Shows the account email, plan, usage and limits.

Show my account status.

activate_license

Binds a licence key to the account.

Activate licence key XXXX-XXXX.

Plan limits

LimitFreePro
lookups303000
saved lists350
list_products25500
watches0100

Network behaviour

Outbound requests use the user agent TidyButtonBot/1.0 (+https://tariff.tidybutton.com/bot), time out after 8 seconds and are blocked from private, loopback and link-local addresses.