mcs_commodity_data
Pack: usgs-mineral-commodities · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/mcs_commodity_data for the schema, then POST the same URL with its arguments for the data.
U.S. salient statistics for one mineral commodity from the USGS Mineral Commodity Summaries — the most recent 5 years of production, imports, exports, consumption, price, employment, and NET IMPORT RELIANCE (the “import reliance” figure — what share of U.S. consumption comes from imports). Accepts a common name (“lithium”, “copper”, “rare earths”, “platinum group metals”) or the MCS code. Raw USGS footnote codes (W=withheld, E=estimated, NA=not available, “>50” on import reliance) are preserved verbatim, never silently coerced to a number. Keyless.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
commodity | string | yes | Commodity name or code, e.g. “lithium”, “cobalt”, “rare earths”, “gold”. |
Example call
Arguments
{
"commodity": "lithium"
}
curl
curl -X POST https://gateway.pipeworx.io/usgs-mineral-commodities/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"mcs_commodity_data","arguments":{"commodity":"lithium"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('mcs_commodity_data', {
"commodity": "lithium"
});
Connect
Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:
{
"mcpServers": {
"pipeworx": {
"url": "https://pipeworx.io/mcp"
}
}
}
Connect to just the usgs-mineral-commodities pack
{
"mcpServers": {
"usgs-mineral-commodities": {
"url": "https://gateway.pipeworx.io/usgs-mineral-commodities/mcp"
}
}
}
See Getting Started for client-specific install steps.