Usgs Mineral Commodities MCP server

@pipeworx/usgs-mineral-commodities

USGS Mineral Commodity Summaries (MCS) — U.S. production, imports, exports, consumption, price, employment and net import reliance for 85 nonfuel mineral commodities (lithium, copper, cobalt, rare earths, gold, aluminum, nickel, platinum-group metals, and dozens of industrial minerals), plus world mine/plant production and reserves by country for 75 of them.

Part of Pipeworx — an MCP gateway connecting AI agents to 1784+ live data sources. This is an independent, unofficial integration — not affiliated with, endorsed by, or published by the upstream provider.

Tools

release covers; each entry names its own stat columns (every commodity's MCS chapter defines its own table) and whether a world comparison table (mcscountrycomparison) is available for it.

• mcslistcommodities(query?, limit?) — browse the 85 commodities this

the most recent 5 years of production, imports, exports, consumption, price, employment, and NET IMPORT RELIANCE — the share of U.S. consumption that comes from imports. Accepts a common name ("lithium", "rare earths", "platinum group metals") or the MCS code.

• mcscommoditydata(commodity) — one commodity's U.S. salient statistics:

production (prior-year actual + current-year estimate) and reserves, by country, for one commodity — "which countries hold lithium reserves", "China vs. Australia rare-earth production". Covers 75 of 85 commodities (see "Known gaps" below for the other 10).

• mcscountrycomparison(commodity, countries?, limit?) — world mine/plant

Auth

Keyless.

Data sources

USGS's National Minerals Information Center publishes MCS once a year as a file-only ScienceBase data release — verified live 2026-10-07: ScienceBase item 677eaf95d34e760b392c4970 ("U.S. Geological Survey Mineral Commodity Summaries 2025 Data Release, ver. 2.0, April 2025") carries two ZIPs of CSV tables and a revision-notes .txt — no JSON/REST endpoint of any kind:

mcs2025-_salient.csv per commodity (85 commodities), U.S. salient statistics for the most recent 5 years. Column names vary per commodity.

• SalientCommodityDataReleaseGroupedMCS2025.zip — one

mine/plant production (2023 actual + 2024 estimate in this release) and 2024 reserves, by country, for ~79 commodity groupings (coarser than the 85 salient codes).

• WorldDataReleaseMCS2025.zip — one MCS2025WorldData.csv, world

scripts/bake-index.mjs downloads both, parses every CSV, matches salient commodities to world-table rows by name (with a short hand-checked alias list for naming differences between the two publications — see the script's own comments, including one USGS typo: "Germanium" vs. the world table's "Gemanium"), and writes src/mcs-index-data.ts.

Why this bakes a table in rather than calling a live endpoint

The MCS data release is file-only — there is no API to proxy. Root CLAUDE.md's standing guidance covers exactly this shape (a source that only publishes bulk files), and US federal data (USGS) is public domain, so baking the release's own published numbers into this pack needs no reuse grant. Refresh path: USGS publishes a new MCS release every January (sometimes revised again in spring, as 2025's "ver. 2.0" was) — re-run node scripts/bake-index.mjs > src/mcs-index-data.ts against the new release's ScienceBase item id when one is published.

Why the baked table isn't a static import

Shortened. The full README is on GitHub.