Tariff MCP server

Live

Duty stacks, HTS lookups, measures, refunds and the change feed as tools for AI agents.

A Model Context Protocol server with the same tools as the REST API. Results carry citations and the dataset version, and the server tells agents that it calculates from codes the user supplies and never classifies goods.

Get a free key Read the docs

At a glance

Status: Live
Endpoint: POST /mcp
Cost: same units as REST
MCP tools: 11 tools
Data: Tariffs dataset 1.0.0, built 2026-10-10.

Connect a client

POST JSON-RPC 2.0 to /mcp with your key in X-API-Key; each tool has the input schema of its REST endpoint and the same units.

MCP client config

{
  "mcpServers": {
    "htscalculator": {
      "type": "http",
      "url": "https://api.htscalculator.com/mcp",
      "headers": { "X-API-Key": "YOUR_KEY" }
    }
  }
}

Tools

11 tools, the same as the REST endpoints
Tool	What it does
tariffs_duty_stack	Duty stack for an HTS code, origin and date
tariffs_duty_stack_batch	Duty stacks for many lines
tariffs_compare_origins	Compare origins for one HTS code
tariffs_hts_search	Search the tariff schedule's text
tariffs_hts_lookup	HTS line lookup
tariffs_hts_history	Revision history of an HTS line
tariffs_revisions	HTS revisions
tariffs_measure	A Chapter 99 measure
tariffs_measures_for_hts	Measures that reach an HTS code
tariffs_changes	Tariff change feed
tariffs_ieepa_refund	IEEPA refund calculation for entry lines

What is included

Streamable HTTP, JSON responses, one key for REST and MCP
Same input schemas and metering as the REST endpoints
Refund lines and citations included

How it differs

The full tool set, with citations an agent can quote.
Clear about what it does not do: no classification.
The dataset version on every result.

Plans

One key and one plan cover every HTS Calculator product, this one included. Free: 2,500 units a month. Developer $49 and Pro $249 a month. Caching inside your product is allowed, and so is use by AI agents. Plans and units.

Status: Live. All products.