Shop Duty Desk in Cursor
Duty and customs data checks. The MCP server is https://shopduty.openkrill.app/mcp. No key. The steps below are only for Cursor. 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 Cursor
Cursor reads MCP servers from mcp.json. A project file at .cursor/mcp.json applies to that project. A user file at ~/.cursor/mcp.json applies everywhere. These steps were checked against the Cursor MCP docs on 2026-10-01. Streamable HTTP is the transport: a url, not a shell command.
Create or edit the file so it contains this server. Merge it with servers you already have. Do not replace the whole file if other servers are listed.
{
"mcpServers": {
"shop-duty": {
"url": "https://shopduty.openkrill.app/mcp"
}
}
}No headers and no auth block. Those are for servers that require a token or a pre-registered OAuth client. Shop Duty Desk answers without either. Saving the file is the install. Open Cursor Settings, then MCP, and confirm Shop Duty Desk is enabled. If it stays disconnected, reload the window. You should see eu_duty_estimate, customs_data_gap_check, bulk_hs_candidates, landed_cost_estimate.
In Agent chat, ask: What EU duty applies to these 6 order lines shipped under IOSS? Cursor calls the tool over streamable HTTP and shows the arguments before it runs them, depending on your run mode. Approve the call the first time and read the result. The server is public and read-only. It does not see your repository unless the model puts repository text into the arguments, so do not paste secrets into the question.
A one-click Marketplace install does not exist for this server. The JSON above is the whole setup. Team admins can distribute the same url through a team marketplace, but that is an admin step, not something this page can do for you. OAuth redirect URLs in the Cursor docs matter only for servers that require sign-in. Skip them here.
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.