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.