{
  "name": "mfgcalcs",
  "version": "1.0.0",
  "description": "Live U.S. manufacturing data as MCP tools: 5,000+ calculators, tariff intelligence, economic series, landed cost and reshoring scores — deterministic engines over committed public data, every answer with a citable url.",
  "protocol": "Model Context Protocol (MCP)",
  "protocolVersions": [
    "2025-03-26"
  ],
  "transport": "streamable-http (stateless; POST JSON-RPC 2.0 to this endpoint)",
  "endpoint": "https://www.mfgcalcs.com/api/mcp",
  "toolCount": 17,
  "indexCount": 27,
  "totalCount": 42,
  "tools": [
    {
      "name": "search_calculators",
      "summary": "Search MFG Calcs' library of 5,000+ manufacturing calculators (machining, molding, welding, OEE, cost estimating, energy, quality, maintenance, and more).",
      "try": {
        "name": "search_calculators",
        "arguments": {
          "query": "OEE"
        }
      }
    },
    {
      "name": "get_calculator",
      "summary": "Get a calculator's inputs (labels, units, defaults, min/max) and formula before running it.",
      "try": {
        "name": "get_calculator",
        "arguments": {
          "tool": "oee"
        }
      }
    },
    {
      "name": "run_calculator",
      "summary": "Run a manufacturing calculation.",
      "try": {
        "name": "run_calculator",
        "arguments": {
          "tool": "oee"
        }
      }
    },
    {
      "name": "lookup_tariff",
      "summary": "Look up U.S. manufacturing import tariffs: HTS General/Special fields, informational Chapter 99 references, observed effective calculated-duty rate, eligible families' aggregate customs unit value, source shares, and named-source HHI floor…",
      "try": {
        "name": "lookup_tariff",
        "arguments": {
          "query": "steel"
        }
      }
    },
    {
      "name": "get_index",
      "summary": "Fetch a published MFG Calcs index, board, ledger, forecast, vintage, revision record, seasonal series, or HS-NAICS map.",
      "try": {
        "name": "get_index",
        "arguments": {
          "index": "get_cost_pressure_index"
        }
      }
    },
    {
      "name": "get_provenance",
      "summary": "Get the MFG Calcs Provenance Manifest: the verifiable record for every branded index and ledger on the site.",
      "try": {
        "name": "get_provenance",
        "arguments": {}
      }
    },
    {
      "name": "search_site",
      "summary": "Search everything on mfgcalcs.com beyond calculators: 64 live economic data series (imports, prices, wages, energy), 57 tariff families, state cost data, calculator categories, and datasets.",
      "try": {
        "name": "search_site",
        "arguments": {
          "query": "industrial electricity price"
        }
      }
    },
    {
      "name": "get_whats_new",
      "summary": "Get the daily what-changed digest for the newest data day, in one call with links deeper: every agency series that published a new reading, every agency value restated (derived signals that recomputed are listed separately by name), every…",
      "try": {
        "name": "get_whats_new",
        "arguments": {}
      }
    },
    {
      "name": "get_receipts",
      "summary": "Get the append-only archive of Ed25519-signed data receipts: every value signed for a series within the rolling window (current + previous signing year), revisions retained, each entry carrying its claim, claimHash, signature, and keyId.",
      "try": {
        "name": "get_receipts",
        "arguments": {}
      }
    },
    {
      "name": "get_freshness",
      "summary": "Get the freshness contract for MFG Calcs' live data: every series with its measured publishing cadence, latest period, age in days, and an honest state (current | due | stale | unknown).",
      "try": {
        "name": "get_freshness",
        "arguments": {}
      }
    },
    {
      "name": "get_change_events",
      "summary": "Get every published or revised observation in order with a cursor.",
      "try": {
        "name": "get_change_events",
        "arguments": {}
      }
    },
    {
      "name": "get_citation",
      "summary": "Get a ready-to-paste citation for an MFG Calcs dataset — including, for vintage-tracked datasets, the ?asOf= URL that returns the numbers exactly as they read on the access date, so the citation stays checkable after revisions instead of…",
      "try": {
        "name": "get_citation",
        "arguments": {}
      }
    },
    {
      "name": "get_vintages",
      "summary": "Get the MFG Calcs Vintage Archive: reproduce what a series said on a past date, before later revisions.",
      "try": {
        "name": "get_vintages",
        "arguments": {}
      }
    },
    {
      "name": "get_revisions",
      "summary": "Get every restatement of a published figure with its old value, new value, and first-known date.",
      "try": {
        "name": "get_revisions",
        "arguments": {}
      }
    },
    {
      "name": "optimize_sourcing",
      "summary": "Solve the cheapest legal supplier mix as a real linear program: given candidate suppliers with unit costs, tariff rates, freight and capacities, return the exact cost-minimizing allocation under a demand requirement, per-supplier capacity…",
      "try": {
        "name": "optimize_sourcing",
        "arguments": {
          "suppliers": "[{\"name\":\"domestic\",\"unitCost\":12.5,\"freightPerUnit\":0.4,\"capacity\":700},{\"name\":\"vietnam\",\"unitCost\":9.8,\"tariffPct\":8,\"freightPerUnit\":1.1},{\"name\":\"mexico\",\"unitCost\":11.2,\"tariffPct\":0,\"freightPerUnit\":0.6,\"capacity\":400}]",
          "demand": "1000",
          "maxSharePct": "60"
        }
      }
    },
    {
      "name": "ask",
      "summary": "Answer manufacturing questions from committed data; deterministic, no LLM.",
      "try": {
        "name": "ask",
        "arguments": {
          "query": "current manufacturing hourly earnings",
          "detail": "evidence"
        }
      }
    },
    {
      "name": "brief",
      "summary": "Describe a SITUATION rather than a question and get every fact bearing on it, each answered and cited.",
      "try": {
        "name": "brief",
        "arguments": {
          "situation": "sourcing bearings from china"
        }
      }
    }
  ],
  "quickstart": {
    "initialize": "curl -s -X POST https://www.mfgcalcs.com/api/mcp -H 'Content-Type: application/json' -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2025-03-26\",\"capabilities\":{},\"clientInfo\":{\"name\":\"quickstart\",\"version\":\"1.0\"}}}'",
    "listTools": "curl -s -X POST https://www.mfgcalcs.com/api/mcp -H 'Content-Type: application/json' -d '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/list\"}'"
  },
  "links": {
    "documentation": "https://www.mfgcalcs.com/developers",
    "openapi": "https://www.mfgcalcs.com/openapi.json",
    "llms": "https://www.mfgcalcs.com/llms.txt",
    "site": "https://www.mfgcalcs.com"
  },
  "usage": "Free for commercial and non-commercial use with attribution: link to each answer's cited url (CC BY 4.0). No API key, no signup.",
  "policy": {
    "keyless": true,
    "pledge": "No keys, walls, meters, or signups — as policy, not as a phase. Identity here is proven (published-IP verification), never demanded. Trust surfaces — signed receipts, verification, freshness, vintages — are free public goods permanently.",
    "agents": "https://www.mfgcalcs.com/agents"
  },
  "verification": {
    "description": "Series answers carry a `receipt` field: an Ed25519-signed claim over the series' latest reading (series, period, value, source), pre-signed at refresh time, with per-answer status signed | pending | unavailable stated honestly. For vintage-tracked datasets, ?asOf= URLs reproduce readings point-in-time. The source repository is public, so every data commit is timestamped history.",
    "publicKey": "https://www.mfgcalcs.com/.well-known/mfgcalcs-signing-key.json",
    "manifestSignature": "https://www.mfgcalcs.com/.well-known/provenance.sig.json",
    "verify": "https://www.mfgcalcs.com/verify",
    "sourceRepository": "https://github.com/CDM172/mfg-calcs-smart-manufacturing-tools"
  }
}