Critical Minerals Supply and Trade
minerals.dossierWho mines a mineral, who holds its reserves, and who exports it — USGS Mineral Commodity Summaries production and reserves by country, joined to UN Comtrade export flows and realised unit values, with supply concentration and US net import reliance. REFUSES three things: no ratio between the supply side and the trade side, because USGS counts contained metal while HS counts the gross weight of a traded article and for lithium those differ by about five times; no price of any kind; no criticality or supply-risk score. EXPORTS ARE NOT PRODUCTION — for gold and silver the largest reporters refine and vault rather than mine, so the two halves rank different countries for good reasons. The HS code matches the USGS production basis, so copper, nickel and zinc point at ore and concentrate headings rather than the refined-metal headings their instruments use. Annual data. Paid.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"mineral": "<mineral>"
},
"name": "minerals.dossier"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Trade year for the Comtrade half. USGS years are fixed by the edition. | |
| limit | No | Maximum country rows. | |
| mineral | Yes | Which mineral. Required. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | Yes | ||
| trade | No | Comtrade exports; null when the licence is unresolved | |
| supply | No | USGS production and reserves, in the mineral's own unit | |
| mineral | Yes | ||
| countries | Yes | Per-country supply and trade, largest producer first | |
| instrument | No | Catalog instrument where one quotes this metal; null for cobalt and lithium | |
| comparability | Yes | Whether the two sides may be compared at all | |
| concentration | Yes | Top-3 share and HHI per side, with formula and coverage | |
| net_import_reliance | No | US only, with the column it was read from |