# GroundTruth — 2026 US Tariff & Landed-Cost API

> Source-linked 2026 US import duty rates, MPF/HMF fees and total landed cost by product and origin country. Updated 2026-10-01.

## What is GroundTruth
GroundTruth is a source-linked API and MCP server for 2026 US customs duty and landed-cost data. It covers 13 product categories across 5 origin countries (CN, VN, IN, MX, US), with stacked duty layers (MFN, Section 301, Section 232, forced-labor), MPF, HMF and total landed cost.

## Key endpoints
- GET /v1/categories — List all product categories, origin layers and fees (no key required)
- GET /try?product_description=&origin_code=CN&declared_value=1000 — Free trial, no signup, no key (200/day/IP)
- POST /mcp — MCP Streamable HTTP endpoint (anonymous rate-limited, or x-api-key for paid)
- GET /openapi.json — OpenAPI 3.1 spec
- GET /health — Liveness check with data date
- GET /account — Self-service account lookup by API key

## Data site
- https://contentforge-press.github.io/us-tariff-data/ — 1,000+ pages of real tariff data by product and origin
- /llms-full.txt — Complete product rate table for AI ingestion

## Install the MCP
- Cursor: https://dytsk9wrfv.page.coze.site/install-tariff.html
- Claude Desktop / VS Code / Windsurf: copy config from install page
- Endpoint: https://winter-river-47fc.contentforge-press.workers.dev/mcp

## Pricing
Free with attribution. Paid plans: Pro $240/yr, Business $790/yr, Enterprise $3,000+/yr.