MFG Calcs Tariff API
The Tariff API from MFG Calcs — 1 operation(s) for tariff.
The Tariff API from MFG Calcs — 1 operation(s) for tariff.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/mfgcalcs-com:mfgcalcs-com-tariff-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: MFG Calcs Manufacturing Data and Calculation Tariff API
version: 1.0.0
description: 'The whole mfgcalcs.com platform over HTTP, keyless. 34 data endpoints serve live U.S. manufacturing intelligence: the effective calculated-duty index and estimate, per-family effective-rate gap and statutory duty-free line coverage, sourcing shifts and concentration, customs unit-value movers, the cost-pressure index and its diffusion, manufacturing PMI, state cost indices, the wage board, six-month forecasts with their own accuracy ledger, reshoring readiness and indexed break-even comparisons, and an exact linear-programming sourcing optimizer. Alongside them: 5,384 deterministic manufacturing calculators, one search across everything the site knows, and an answer endpoint that returns a scoped, source-dated answer or a structured clarification request for a natural-language question.
Everything is computed from committed public data (USITC, BLS, EIA, Census, BEA) rather than a model, so identical inputs always return identical output. The trust surfaces are part of the API, not a footnote: /api/vintages recovers what any series said on a past date, /api/revisions records every restatement, /api/provenance publishes artifact hashes, and /api/receipts carries Ed25519 signatures. Free with attribution (CC BY 4.0) and no key, ever. An MCP server exposing the same engines as tools for AI agents is at https://www.mfgcalcs.com/api/mcp.
VERSIONING: every path below is also served under /api/v1/ — e.g. https://www.mfgcalcs.com/api/v1/manufacturing-pmi. Prefer the /api/v1 form in code you intend to keep: v1''s response shapes are frozen (fields keep their name, type and meaning; new fields may be added, so ignore unknown ones), and any breaking change ships as /api/v2 instead of altering v1. The unversioned paths are permanent aliases and will not be removed. Responses carry an X-API-Version header. See https://www.mfgcalcs.com/developers and docs/methodology/API_VERSIONING.md.'
contact:
url: https://www.mfgcalcs.com/contact-us
servers:
- url: https://www.mfgcalcs.com
tags:
- name: Tariff
paths:
/api/tariff:
get:
operationId: lookupTariff
summary: Look up U.S. tariff rates by keyword, family, or HTS code
description: Statutory HTS General and Special rates, informational Chapter 99 references, and effective calculated-duty rates (USITC Calculated Duties / covered customs value), with top source countries, for 57 manufacturing families. From the USITC snapshot behind /tariffs. Reference data, not a customs ruling.
parameters:
- name: q
in: query
required: true
schema:
type: string
description: Keyword ('fasteners'), family key ('steel-fasteners'), or HTS code/prefix ('7318.15.20')
- name: limit
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 10
description: Max family matches, default 5
responses:
'200':
description: Family matches with statutory + effective rates; rate lines for HTS queries.
'400':
description: Missing or empty query.
'429':
description: Best-effort function-instance rate limit exceeded; Retry-After is returned.
tags:
- Tariff
post:
operationId: optimizeSupplierOrders
summary: Optimize integer supplier orders with packs, MOQ and fixed fees
description: POST is supported only with optimize=orders. Demand plus allowed overbuy must not exceed 10 million units; use one currency. Supplier share caps use requested demand. One activation fee applies per used supplier. HiGHS uses a 5-second/5,000-node native limit; feasible incumbents are independently checked. The adapter does not expose an achieved gap, so optimalityGap is null. Private/no-store; 64 KiB body cap. Existing GET LP requests are unchanged.
parameters:
- name: optimize
in: query
required: true
schema:
type: string
const: orders
requestBody:
required: true
content:
application/json:
schema:
type: object
additionalProperties: false
properties:
demand:
type: integer
minimum: 1
maximum: 10000000
maxOverbuy:
type: integer
minimum: 0
maximum: 10000000
maxSharePct:
type: number
minimum: 1.0e-06
maximum: 100
suppliers:
type: array
minItems: 1
maxItems: 20
items:
type: object
additionalProperties: false
properties:
name:
type: string
minLength: 1
maxLength: 100
unitCost:
type: number
minimum: 0
maximum: 10000000
tariffPct:
type: number
minimum: 0
maximum: 10000
freightPerUnit:
type: number
minimum: 0
maximum: 10000000
capacity:
type: integer
minimum: 0
maximum: 10000000
minimumOrderQty:
type: integer
minimum: 0
maximum: 10000000
packSize:
type: integer
minimum: 1
maximum: 10000000
fixedOrderCost:
type: number
minimum: 0
maximum: 10000000
required:
- name
- unitCost
required:
- demand
- suppliers
responses:
'200':
description: Solver result; inspect status before using allocation.
content:
application/json:
schema:
type: object
required:
- schemaVersion
- status
- allocation
- totalQuantity
- totalCost
- optimalityGap
properties:
schemaVersion:
const: mfgcalcs.sourcing-orders.v1
status:
enum:
- optimal
- feasible
- no_incumbent
- infeasible
- invalid
- failed
allocation:
type: array
items:
type: object
properties:
name:
type: string
quantity:
type: integer
minimum: 0
maximum: 10000000
packs:
type: integer
minimum: 0
maximum: 10000000
active:
type: boolean
landedUnitCost:
type: number
variableCost:
type: number
fixedCost:
type: number
totalCost:
type: number
totalQuantity:
type:
- integer
- 'null'
overbuy:
type:
- integer
- 'null'
totalCost:
type:
- number
- 'null'
optimalityGap:
type: 'null'
solverStatus:
type:
- string
- 'null'
solverLimits:
type: object
'400':
description: Invalid JSON, fields or numeric bounds.
'413':
description: Request body too large.
'422':
description: No feasible order allocation.
'429':
description: Rate or admission limit.
'500':
description: Solver failure or invalid incumbent.
'503':
description: Calculation journey or execution admission unavailable.
tags:
- Tariff
externalDocs:
url: https://www.mfgcalcs.com/developers
description: Human documentation and MCP setup
x-mfgcalcs-preview:
status: preview-not-published
notice: MCP 2.0 preview documentation. These tools require an explicitly enabled preview deployment; this inventory does not activate them or prove that a hosted endpoint supports them. Read that endpoint's discovery response before calling.
metadata: /mcp-preview.json
schemaReference: /openapi-mcp-preview.json
examples: /mcp-preview-examples.json