Tariff Code Finder in Pi
Tariff codes and duty rates. The MCP server is https://tariffs.openkrill.app/mcp. No key. The steps below are only for Pi. A call to get_duty_rate was checked against that server on 2026-10-01.
What this server answers
Find candidate customs tariff codes for a product and read the import duty on a code. 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?".
Tariff Code 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.
The 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.
The 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.
It 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.
What it can do
- Finds candidate tariff 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 import duty 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
Tools
find_tariff_codes, Find candidate tariff codes. Use this when the user asks for the tariff code, commodity code, customs code or HS code for a product, for example "what is the tariff code for a ceramic flower pot in the UK?", "HTS code for a lithium-ion battery" or "which heading covers cotton t-shirts for import into the US?". Pass a plain description of the product and country GB (United Kingdom) or US (United States). Returns candidate codes from the official schedule, each with its description, the headings above it and whether goods are declared under it, plus a notice that they are candidates and not a binding classification. Do not use it to classify goods with certainty, to give a binding customs ruling, to compute shipping or landed cost, or for countries other than GB and US.get_duty_rate, Get the duty rate for a tariff code. Use this when the user asks what import duty, tariff or VAT applies to a tariff code, for example "what is the US duty on HTS 8507.60.00?", "what duty applies to UK commodity code 6914100000 from Vietnam?" or "what is under heading 6914 in the UK tariff?". Pass the code (4 to 10 digits, dots allowed), country GB or US, and originCountry when the user names where the goods come from. For a code goods are declared under it returns the description and the rate: for the UK the third-country duty, VAT rates as a list, the preferential rate and any additional duty for the origin, and other measures; for the US the general, special and column 2 rates and units. For a code that is only a heading it returns the lines beneath it instead. Chapter 99 additional duties for the US and quotas or trade remedies are not included. Do not use it for a landed cost estimate, for excise or customs-broker fees, or for legal advice.
Add Tariff Code Finder in Pi
Pi does not speak MCP on its own. The pi-mcp-adapter extension (these steps match version 2.34.0) loads remote servers and keeps their schemas out of the prompt until you ask. Install it once, then restart Pi:
pi install npm:pi-mcp-adapterAdd the server to a shared MCP file. Use .mcp.json in the project if only that project needs Tariff Code Finder, or ~/.config/mcp/mcp.json if you want it in every project. Pi also reads ~/.agents/mcp.json. A Pi-only override lives in ~/.pi/agent/mcp.json or .pi/mcp.json and wins over the shared file.
{
"mcpServers": {
"tariffs": {
"url": "https://tariffs.openkrill.app/mcp"
}
}
}The url is enough. Do not set command: that field is for a local process. No API key header. After restart, run /mcp and confirm the server is listed. The first call connects lazily. Ask: What are candidate tariff codes for a ceramic flower pot in the UK? The adapter should offer find_tariff_codes, get_duty_rate.
Leave directTools off unless you want those schemas in every turn. With a handful of tools the cost is small. The default proxy is the better fit: search for the tool, then call it. /mcp disable tariffs writes a project override in .pi/mcp.json without editing the shared file. Run /reload after that change.
Pi will not find this server by scanning Cursor or Claude config unless you run /mcp setup and import it. Putting the url in .mcp.json is the direct path and the one this page tests against. The server is the same public endpoint the other clients use, with the same limits and the same privacy rules.
A call checked on 2026-10-01
HTS 8507.60.00 is the lithium-ion battery heading named in the plugin's starter prompts. The rate is a schedule reading, not a classification. The request below was posted to https://tariffs.openkrill.app/mcp as tools/call. HTTP 200. Source: the Tariff Code Finder server, read 2026-10-01.
{
"method": "tools/call",
"params": {
"name": "get_duty_rate",
"arguments": {
"code": "8507.60.00",
"country": "US"
}
}
}- source. Harmonized Tariff Schedule of the United States (hts.usitc.gov), published by the US International Trade Commission.
- country. US
- notice. These are candidate codes from the official tariff, not a binding classification. The right code depends on what the product is, what it is made of and how it is used; confirm with customs or a licensed customs broker be
Repeat the call yourself if you need a newer reading. Cached answers expire. A rate limit is not a result: wait and try again. Nothing in the call is a ranking, a filing, or advice.