Tariff Resolver MCP Server

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). It runs locally over stdio via the published package.

People who work with customs, hts and import duty and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-07 · ★ 2 · #247 OF 945 MAINTAINED OTHER · VERIFIED 2026-09-18

MIT · TypeScript servers · how we verify → /methodology

01 · Install Tariff Resolver

Claude Code

claude mcp add opsloft-tariff-resolver -- npx -y tariff-resolver

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "opsloft-tariff-resolver": {
      "command": "npx",
      "args": [
        "-y",
        "tariff-resolver"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

repo age created 2026-08-19 - young repo, little track record yet

license MIT - declared in the repository

npm package tariff-resolver - unscoped; check the name against the project README before installing

registry namespace io.github.opsloft is GitHub-verified and matches the repo owner

03 · What Tariff Resolver can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

An agent gets 5 documented tools across read & search, calculate, watch, including search_hs_candidates, calculate_tariff_scenario, watch_tariff_changes, check_tariff_updates.

Capability map

Tools grouped from the project's README - what Tariff Resolver lets an agent do.

read & search

1 tool - e.g. Product description → top HTS candidates with rates + CBP CROSS ruling links

search_hs_candidates

Calculate

1 tool - e.g. HTS code + origin + value (+ weight) → structured JSON: base MFN/FTA rate, candidate Chapter 99 layers with per-layer match/confidence, sourced possibly_expired

calculate_tariff_scenario

Watch

1 tool - e.g. Register HTS codes to a local watchlist

watch_tariff_changes

Check

1 tool - e.g. Diff current vs previous HTS revision - see exactly which rates changed

check_tariff_updates

Dataset

1 tool - e.g. Data revision date, row counts, source, license

dataset_info

Latest releases

v1.1.1 · 2026-09-05

Fixed · Unrecognised country names now return ORIGIN_UNKNOWN instead of silently matching a partial needle (a typo like "Chnia" used to return an understated duty stack). Accepted inputs: ISO-3166 alpha-2 codes…

v1.1.0 · 2026-09-05

Added · Pure core (tariff-resolver/core): buildDataset, resolveDuty, normalizeOrigin, citedPrefixes, findOverride - no Node APIs, runs in edge runtimes. This is the layer behind the hosted REST endpoint. · Per-layer…

v1.0.3 · 2026-08-25

Fixed · Suspended provisions were treated as live. The dead-heading filter only matched "provision terminated" / "no longer in effect" / "provision has expired", so headings marked "provision suspended", "provision was…

04 · Who maintains Tariff Resolver

tariff-resolver is maintained by opsloft. It's the only MCP server we track from this author; the repo dates to Aug 2026.

05 · Facts

repository: github.com/opsloft/tariff-resolver
website: https://opsloft.dev/
category: other - ranked #247 of 945 actively-maintained other servers as of 2026-09-18.
release cadence: 5 releases in the last 90 days (latest 2026-09-05)
registry: io.github.opsloft/tariff-resolver (active, first published 2026-08-20 · 6 versions)
packages: npm:tariff-resolver

06 · Tariff Resolver FAQ

Is Tariff Resolver still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-07 and it shipped 5 releases in the last 90 days. We re-verify nightly.

What can Tariff Resolver do?

An agent gets 5 documented tools across read & search, calculate, watch, including search_hs_candidates, calculate_tariff_scenario, watch_tariff_changes, check_tariff_updates.

How do I install Tariff Resolver?

Run `npx -y tariff-resolver`. You can also paste the ready-made client config above.

Does Tariff Resolver run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Tariff Resolver

Alternatives to Tariff Resolver

Maintained other servers if Tariff Resolver isn't the fit.

More MCP servers to compare · Spot Advanced Swap Orders · Plonk · Aboard · Qweather MCP · Originalvoices

More TypeScript MCP servers · Optifeed Radar · Kanban AI · Omnicord · OPA MCP · Zoteus · see all