# tariff-resolver MCP server

> Enables AI assistants to research US import duties, identify HTS codes, and calculate landed cost components using official USITC data.

- Repository: https://github.com/opsloft/tariff-resolver
- Page: https://hostedmcp.org/servers/opsloft/tariff-resolver
- Transport: stdio
- Stars: 3
- License: MIT
- Latest version: 1.1.0

## Install

### Claude Code

```sh
claude mcp add tariff-resolver -- npx -y tariff-resolver
```

### Cursor (`~/.cursor/mcp.json`)

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

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "tariff-resolver": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "tariff-resolver"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"tariff-resolver","type":"stdio","command":"npx","args":["-y","tariff-resolver"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

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

### Codex

```sh
codex mcp add tariff-resolver -- npx -y tariff-resolver
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.tariff-resolver]
command = "npx"
args = ["-y", "tariff-resolver"]
```

### Gemini CLI

```sh
gemini mcp add -s user tariff-resolver npx -- -y tariff-resolver
```

### Gemini settings.json (`~/.gemini/settings.json`)

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

## Tools (5)

- `search_hs_candidates`
- `calculate_tariff_scenario`
- `watch_tariff_changes`
- `check_tariff_updates`
- `dataset_info`

## FAQ

### Is this tool providing legal or tax advice?

No, the outputs are candidates and estimates for pre-broker screening and do not constitute customs, legal, or tax advice.

### Does the tool include AD/CVD duties in its calculations?

No, the estimates provided by the tool exclude AD/CVD duties.

### How does the server handle privacy and data collection?

The server runs entirely on your machine and does not collect any queries, telemetry, analytics, or usage data.

### Can I track changes to specific HTS codes?

Yes, you can register HTS codes to a local watchlist and check for differences between HTS revisions.
