MFG Calcs Tariff API

The Tariff API from MFG Calcs — 1 operation(s) for tariff.

GitHub OpenAPI

Operations 2

GET /api/tariff Look up U.S. tariff rates by keyword, family, or HTS code #
POST /api/tariff Optimize integer supplier orders with packs, MOQ and fixed fees #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/mfgcalcs-com:mfgcalcs-com-tariff-api"
All apis
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.

Get an API 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 Specification

mfgcalcs-com-tariff-api-openapi.yml Raw ↑
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