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.
openapi: 3.2.0
info:
title: MFG Calcs Manufacturing Data and Calculation Search 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: Search
paths:
/api/search:
get:
operationId: searchSite
summary: 'Search the whole platform: calculators, live data, tariffs, definitions'
description: 'One search over everything MFG Calcs answers about: 5,000+ calculators, live economic series, tariff families, state costs, glossary definitions, datasets, and hub pages. Returns ranked entity matches with titles, URLs, and hints — the same resolver behind MFGSearch and the search_site MCP tool.'
parameters:
- name: q
in: query
required: true
schema:
type: string
maxLength: 500
description: Free-text query, e.g. 'bearings tariff' or 'steel imports'
- name: limit
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 20
description: Max results, default 8
responses:
'200':
description: Ranked matches with type, title, url, and hint.
'400':
description: Missing or empty query.
'429':
description: Best-effort function-instance rate limit exceeded; Retry-After is returned.
tags:
- Search
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