Shop Duty Desk in Pi
Duty and customs data checks. The MCP server is https://shopduty.openkrill.app/mcp. No key. The steps below are only for Pi. A call to eu_duty_estimate was checked against that server on 2026-10-01.
What this server answers
Check the customs side of selling online across borders.
Ask "what EU duty applies to my 6 order lines shipped under IOSS?", "which products in my Shopify inventory export have no HS code or country of origin?", "find candidate tariff codes for these 15 products" or "what is the landed cost of this item shipped to the UK?".
Shop Duty Desk estimates the 3 euros per item EU customs duty on low-value consignments (Council Regulation (EU) 2026/382, with the item definition in Commission Delegated Regulation (EU) 2026/1022), and shows how many items a set of order lines counts as, with and without merging identical lines.
It checks a Shopify Inventory CSV (the file that holds HS code and country of origin) or product CSV for missing or malformed HS codes, origins, item identifiers and barcodes, and lists the rows to fix.
It suggests candidate tariff codes for product titles from the UK Trade Tariff and the US Harmonized Tariff Schedule, and estimates the landed cost of an item from a tariff line using those official duty rates and a small dated VAT table with a source for each rate.
Every HS code it returns is a candidate, not a binding classification; confirm it with customs or a customs broker.
It does not look up EU TARIC rates or Canadian rates, does not include US chapter 99 additional duties, and covers the 3 euros rule only for consignments up to 150 euros.
Order lines carry no customer data: lines with a name, address or other customer field are refused. Nothing you send is stored; there is no account and no IP address is kept, only a daily count of calls per tool.
What it can do
- Estimates the 3 euros per item EU customs duty for consignments up to 150, euros citing the regulations
- Counts items for the duty both as lines are given and with identical lines merged
- Checks a Shopify Inventory or product CSV for missing HS codes, origins, identifiers and invalid barcodes
- Suggests candidate UK and US tariff codes for up to 20 product titles, labelled not binding
- Estimates duty, VAT and landed cost of an item from a UK or US tariff line
Tools
eu_duty_estimate, Estimate EU duty on a low-value consignment. Estimate the EU customs duty on a consignment of up to 150 euros imported under IOSS or by post: 3 euros per item from 1 July 2026 until 1 July 2028 (Council Regulation (EU) 2026/382, Delegated Regulation (EU) 2026/1022). Use it for questions like "what duty applies to these order lines?", "how many items does this parcel count as?". Pass lines (description, origin, qty, unit_value_eur, optional hs_code) and channel (ioss or postal); optional consignment_value_eur and date. Lines must not carry customer fields. Returns the item count as given and with identical lines merged, the duty for each, the legal basis, and the assumptions. Consignments over 150 euros and dates outside the period return no duty and say why.customs_data_gap_check, Check a Shopify CSV for customs data gaps. Check the text of a Shopify Inventory CSV (it holds HS Code and COO, country of origin) or product CSV for missing or malformed HS codes, countries of origin, item identifiers (SKU or barcode) and invalid barcodes. Use it for "which products have no HS code?", "is my export ready for customs?". Pass the csv text exactly as exported, up to 2 MB. Returns counts (null where the file has no such column), up to 200 rows with the problem on each, and notes on columns the file lacks. Nothing is stored: the input is used for this answer and dropped.bulk_hs_candidates, Find candidate tariff codes for products. Suggest candidate tariff (HS) codes for up to 20 product titles from the UK Trade Tariff and, if asked, the US Harmonized Tariff Schedule. Use it for "what HS code could this product use?". Pass products (title, optional description) and optional markets (UK, US). Returns up to 3 candidates per product and market with code, description and source. Every code is a candidate, not binding; a large list may be cut short and says so per product.landed_cost_estimate, Estimate duty, VAT and landed cost. Estimate the duty, VAT and total landed cost of an item shipped to the UK, US or EU from a tariff line. Use it for "what will import duty and VAT be on this?". Pass hs_code (a full tariff line, a candidate, not binding), destination (UK, US, EU), goods_value and shipping in one currency; optional origin, and country (member state) for EU VAT. UK and US duty rates are read from the official tariffs; EU duty is not looked up. Returns duty, VAT and total with the rate, basis, sources and date. A rate that is not a plain percentage is returned as text with no amount. US chapter 99 additional duties are not included.
Add Shop Duty Desk 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 Shop Duty Desk, 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": {
"shop-duty": {
"url": "https://shopduty.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 EU duty applies to these 6 order lines shipped under IOSS? The adapter should offer eu_duty_estimate, customs_data_gap_check, bulk_hs_candidates, landed_cost_estimate.
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 shop-duty 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
Two identical low-value lines exercise the IOSS estimate. No customer fields are sent. The request below was posted to https://shopduty.openkrill.app/mcp as tools/call. HTTP 200. Source: the Shop Duty Desk server, read 2026-10-01.
{
"method": "tools/call",
"params": {
"name": "eu_duty_estimate",
"arguments": {
"channel": "ioss",
"lines": [
{
"description": "cotton t-shirt",
"origin": "CN",
"qty": 2,
"unit_value_eur": 12
}
]
}
}
}- legal basis. 2 returned
- consignments. 1 returned
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.