TaricHive
Multi-country customs tariff database. It imports published tariff data from taric-opendata into SQL Server and serves it through a Blazor web front-end and an MCP server.
Last reviewed: 2026-08-10.
Solution structure
| Project | Purpose |
|---|---|
TaricHive.Core |
EF Core 10 models, DbContext, and the services — search, measure lookup and classification, duty calculation, exchange rates, the Meursing grid |
TaricHive.Importer |
CLI that downloads and bulk-loads each jurisdiction, with a post-import verification suite and atomic staged reloads |
TaricHive.Web |
Blazor Server front-end: search, browse, tariff detail, legislation, the Meursing tool, admin sync |
TaricHive.Mcp |
MCP server at mcp.opentaric.eu — an OAuth 2.1 resource server exposing 9 tariff tools |
TaricHive.Tests |
xunit — duty engine, measure selection, importer parsers checked against the publishers' real archives |
There is no REST API. TaricHive.Api was removed in August 2026: nothing consumed it, CI never
built it, and it had no authentication. MCP is the programmatic surface.
Sources
Eleven jurisdictions and three datasets, each with its own importer because no two publishers agree on a format.
| Code | Jurisdiction | What the publisher ships |
|---|---|---|
eu |
European Union | TARIC from DG TAXUD CIRCABC (XLSX), import and export duty sheets |
be |
Belgium | TARIC Plus / eurodyn XML |
nl |
Netherlands | Arctic Group Tariff XML (attribute-based DTV export) |
fr |
France | RITA XML — France's own additions to TARIC, not a replica; its pages are composed with the EU's |
gb |
United Kingdom | UK Global Tariff CSVs from data.api.trade.gov.uk |
se |
Sweden | Tulltaxan XML from Tullverket |
pl |
Poland | ISZTAR4 ZIP |
no |
Norway | Tolletaten XML/JSON — duties, VAT, excise, restrictions |
ch |
Switzerland | BAZG XML — duties, permits, statistical keys, additional taxes, VAT |
tr |
Türkiye | TGTC nomenclature plus the Import Regime Decree's applied duties |
us |
United States | USITC Harmonized Tariff Schedule JSON |
ebti |
EU rulings | Binding Tariff Information (DDS2 EBTI) |
atar |
UK rulings | Advance Tariff Rulings |
eurlex |
EU legislation | CELEX manifest, CN legal Section/Chapter notes, CNEN |
EU member states take their nomenclature from the EU import, which is authoritative for it. A canonical adapter layer normalises the rest.
What the front-end offers
- Search and browse — by code or description, across sources, with the nomenclature tree.
- Tariff detail at
/tariff/{source}/{code}/{movement}— measures grouped into duty, restriction, quota and reference-price panels, with conditions, footnotes, excluded origins, legal notes and linked legislation. Point-in-time: any date, not just today. - Duty calculation and declaration validation, including origin and preference selection.
- Rulings — EU BTI and UK ATaR for the code in view.
- Meursing at
/meursing— the four-axis composition grid that agricultural components are keyed on. It is a tool of its own rather than a tariff-page panel because TARIC files those measures with no commodity code at all: they are identified by the grid cell, so there is no commodity page they belong to.
Reference
| Page | |
|---|---|
| MCP setup | Connecting to mcp.opentaric.eu — Authentik providers, scopes, interactive and machine-to-machine tokens |
| Multi-country gap analysis | Where each publisher's data falls short of a complete tariff, and what we do about it |
| EU delta replay | How the Commission's daily TARIC deltas are applied on top of a monthly snapshot |
Data
Every source is public data republished by its customs authority. The licence position for each, and what redistribution each authority permits, is in taric-opendata's data licences.