Ermöglicht es KI-Assistenten, US-Importzölle zu recherchieren, HTS-Codes zu identifizieren und Landed Cost Komponenten mithilfe offizieller USITC-Daten zu berechnen.
Auch bekannt als opsloft/tariff-resolver
- Stars
- 3
- Tools
- 5
- Downloads, 30 Tage
- —
- Neueste Version
- 1.1.0
- Letzter Commit
- 7. Sept. 2026
- Lizenz
- MIT
Was ist tariff-resolver MCP?
Ermöglicht es KI-Assistenten, US-Importzölle zu recherchieren, HTS-Codes zu identifizieren und Landed Cost Komponenten mithilfe offizieller USITC-Daten zu berechnen. Er stellt 5 Tools bereit, etwa search_hs_candidates, calculate_tariff_scenario, watch_tariff_changes.
Zusammenfassung generiert aus dem README des Projekts
Über tariff-resolver MCP server
Dieser Server ermöglicht es dir, US-Importzölle und HTS-Codes direkt aus einem KI-Assistenten heraus zu recherchieren. Er bietet Zugriff auf über 35.000 Tarifpositionen aus offiziellen USITC-Daten, um Nutzern bei der Berechnung von Landed Cost Komponenten zu helfen – einschließlich Basis-MFN/FTA-Sätzen, zusätzlichen Chapter-99-Zöllen wie Section 301 oder 232 sowie MPF/HMF-Gebühren. Er wurde für Entwickler und Importeure entwickelt, die über einfache Suchen hinausgehen und komplexe Zoll-Szenarien modellieren müssen.
Der Server läuft lokal auf deiner Maschine via Node.js und sammelt keine Telemetrie- oder Nutzungsdaten. Du kannst ihn über eine One-Click-Installation zu Claude Desktop hinzufügen oder ihn in jedem MCP-Client via npx konfigurieren. Er nutzt einen gebündelten lokalen Datensatz, um Privatsphäre und Geschwindigkeit zu gewährleisten, und stellt während des Standardbetriebs keine Netzwerkzugriffe her.
Nutzer können spezifische Tools wie search_hs_candidates verwenden, um Produktübereinstimmungen inklusive CBP CROSS Ruling-Links zu finden, oder calculate_tariff_scenario, um strukturierte JSON-Schätzungen basierend auf Ursprung und Wert zu generieren. Zudem gibt es eine Watchlist-Funktion über watch_tariff_changes, um Tarifänderungen im Zeitverlauf zu verfolgen.
Was du damit machen kannst
- 1HTS-Codes aus Beschreibungen identifizierenFinde potenzielle Harmonized Tariff Schedule Codes und zugehörige rechtliche Entscheidungen, indem du einfach eine Produktbeschreibung in Textform angibst.
- 2Tarifsatzänderungen überwachenVerfolge spezifische HTS-Codes, um zu sehen, wie sich die Sätze zwischen verschiedenen offiziellen Tarifrevisionen unterscheiden.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du tariff-resolver MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügentariff-resolver MCP in Claude Code installieren
$ claude mcp add tariff-resolver -- npx -y tariff-resolvertariff-resolver MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"tariff-resolver": {
"command": "npx",
"args": [
"-y",
"tariff-resolver"
]
}
}
}tariff-resolver MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"tariff-resolver": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"tariff-resolver"
]
}
}
}tariff-resolver MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"tariff-resolver","type":"stdio","command":"npx","args":["-y","tariff-resolver"]}'tariff-resolver MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"tariff-resolver": {
"command": "npx",
"args": [
"-y",
"tariff-resolver"
]
}
}
}tariff-resolver MCP in Codex installieren
$ codex mcp add tariff-resolver -- npx -y tariff-resolvertariff-resolver MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.tariff-resolver] command = "npx" args = ["-y", "tariff-resolver"]
tariff-resolver MCP in Gemini CLI installieren
$ gemini mcp add -s user tariff-resolver npx -- -y tariff-resolvertariff-resolver MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"tariff-resolver": {
"command": "npx",
"args": [
"-y",
"tariff-resolver"
]
}
}
}tariff-resolver MCP tools 5
Erkannt aus dem READMEsearch_hs_candidatescalculate_tariff_scenariowatch_tariff_changescheck_tariff_updatesdataset_info
| search_hs_candidates | — | |
| calculate_tariff_scenario | — | |
| watch_tariff_changes | — | |
| check_tariff_updates | — | |
| dataset_info | — |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbaropsloft/tariff-resolver is public and reachablegithub.com/opsloft/tariff-resolver ↗Bestanden
- Paket nennt dieses Repository als Quelletariff-resolver names opsloft/tariff-resolver as sourcenpmjs.com/package/tariff-resolver ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)No build attestation published for this releaseNicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-09-07github.com/opsloft/tariff-resolver ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from tariff-resolverBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten99 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell5 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehentariff-resolver
An MCP server that turns your AI assistant into a US import duty research tool — built on official USITC Harmonized Tariff Schedule data (US Government public domain, 35,000+ tariff lines).
- 🔍 HTS code candidates from plain product descriptions, with CBP CROSS ruling links
- 🧮 Landed-cost components: MFN/FTA base rates + Chapter 99 additional duties (IEEPA / Section 301 / 232) + MPF/HMF fees
- 📡 Tariff change tracking: watchlist your HTS codes, diff rates between HTS revisions
- 🤖 AI-optimized, hallucination-resistant: returns the actual Chapter 99 rule text with parsed rates, so your LLM reasons over real exception chains instead of inventing 2024-era numbers

Why now: since the de minimis exemption ended (Aug 29, 2025), every US-bound shipment needs an HTS code and duty payment — and 2025–26 rates keep changing by executive order.
Not affiliated with any government agency. Outputs are candidates/estimates for pre-broker screening — not customs, legal, or tax advice. Estimates exclude AD/CVD duties.
Install
Requires Node.js ≥ 18.
claude mcp add tariff-resolver -- npx -y tariff-resolver
Or in any MCP client config:
{ "mcpServers": { "tariff-resolver": { "command": "npx", "args": ["-y", "tariff-resolver"] } } }
Claude Desktop (one-click): download tariff-resolver-<version>.mcpb from Releases and double-click it — no terminal needed.
💡 Try these prompts
- Basic search: "Find the HTS code for a men's 100% cotton t-shirt."
- Full scenario: "Calculate the tariff scenario for HTS 6109.10.00, origin China, customs value $5,000, ocean freight."
- Sourcing decision: "I'm importing $10k of stainless steel vacuum flasks. Compare landed cost if I source from China vs Vietnam."
- Stay current: "Watch tariff changes for my catalog: 6109.10.00, 8507.60.00, 9617.00.10."
Tools
| Tool | What it does |
|---|---|
search_hs_candidates |
Product description → top HTS candidates with rates + CBP CROSS ruling links |
calculate_tariff_scenario |
HTS code + origin + value (+ weight) → structured JSON: base MFN/FTA rate, candidate Chapter 99 layers with per-layer match/confidence, sourced possibly_expired bucket, MPF/HMF |
watch_tariff_changes |
Register HTS codes to a local watchlist |
check_tariff_updates |
Diff current vs previous HTS revision — see exactly which rates changed |
dataset_info |
Data revision date, row counts, source, license |
Design
The server does the retrieval; your LLM does the reasoning. Chapter 99 rules are returned verbatim (with parsed adder_pct where applicable) so the model reads the actual exception chains instead of trusting a black-box calculation. Rates for 10-digit statistical suffixes inherit from their parent rate line. Headings the schedule marks as dead — terminated, suspended, expired — are filtered out and counted, and the USITC's own compiler_note rides along with any rule that carries one.
Status overrides. data/status_overrides.json is a short, sourced list of Chapter 99 headings whose collection has stopped, expired, or been suspended even though the schedule still prints them. A layer matching an entry is returned under possibly_expired with the entry's status, reason, source URL and as_of date instead of in layers. Every entry carries a CBP, Federal Register or USITC source; pull requests adding entries must include one.
What the data cannot tell you. The published schedule is wrong in both directions at any given moment, so every result carries a stacking_warning and the snapshot date. Provisions whose collection has already stopped keep printing with no end date — IEEPA and Section 122 headings are the recurring case — and newly proclaimed actions appear in the schedule days after they take effect. Totalling every layer the schedule prints yields a rate nobody is charged. Treat the layers as candidates, and verify collection status against CBP CSMS messages before relying on a stack.
One core, two front doors. All duty logic lives in tariff-resolver/core (pure TypeScript, no filesystem or network): resolveDuty(dataset, { hts, origin, value_usd?, ocean? }) — origin takes an ISO-3166 alpha-2 code or an English country name — returns the base line, separate MPF/HMF, every candidate Chapter 99 layer with match and confidence, a sourced possibly_expired bucket, and the snapshot date. The MCP tool calls it; so can any Node or edge runtime. A country name that is not recognised returns the ORIGIN_UNKNOWN error rather than a partial match, so a misspelled origin can never quietly resolve to a thinner stack of layers.
Data
Ships with a full HTS snapshot, fetched from USITC's official JSON API (US Government public domain). Refresh anytime:
python3 scripts/fetch_hts.py # ~2 min, fails hard rather than write a partial dataset
dataset_info reports the revision date your queries run against.
Privacy Policy
tariff-resolver runs entirely on your machine and collects nothing:
- Data collection: none. No queries, telemetry, analytics, or usage data are collected or transmitted.
- Usage and storage: your watchlist is stored in a local JSON file on your machine; all lookups run against the bundled local dataset.
- Third-party sharing: none. The server makes no network requests at runtime. (The optional
scripts/fetch_hts.pyrefresh script contacts only the official USITC API.) - Data retention: nothing to retain — delete the local watchlist file at any time.
- Contact: tom@opsloft.dev
Full policy: https://opsloft.dev/privacy
License
MIT. Tariff data is a work of the US Government (public domain).
tariff-resolver MCP Fragen
Wie füge ich tariff-resolver MCP zu Claude Code hinzu?
Führe claude mcp add tariff-resolver -- npx -y tariff-resolver in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich tariff-resolver MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet tariff-resolver MCP?
Er stellt 5 Tools bereit, darunter search_hs_candidates, calculate_tariff_scenario, watch_tariff_changes, check_tariff_updates, dataset_info.
Bietet dieses Tool Rechts- oder Steuerberatung an?
Nein, die Ausgaben sind lediglich Vorschläge und Schätzungen zur Vorprüfung durch Makler und stellen keine Zoll-, Rechts- oder Steuerberatung dar.
Enthalten die Berechnungen des Tools AD/CVD-Zölle?
Nein, die vom Tool bereitgestellten Schätzungen schließen AD/CVD-Zölle aus.
Wie geht der Server mit Datenschutz und Datenerhebung um?
Der Server läuft vollständig auf deiner Maschine und sammelt keine Anfragen, Telemetrie, Analysen oder Nutzungsdaten.
Kann ich Änderungen an spezifischen HTS-Codes verfolgen?
Ja, du kannst HTS-Codes in einer lokalen Watchlist registrieren und auf Unterschiede zwischen HTS-Revisionen prüfen.