mcs_list_commodities
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_list_commodities for the schema, then POST the same URL with its arguments for the data.
Browse the ~85 nonfuel mineral commodities covered by the USGS Mineral Commodity Summaries (MCS) annual data release — lithium, copper, cobalt, rare earths, gold, aluminum, nickel, platinum-group metals, and dozens more, through industrial minerals like barite and feldspar. Each entry names its U.S. statistics columns (production, imports, exports, price, employment, net import reliance — varies by commodity) and whether a world production/reserves-by-country table is also available (mcs_country_comparison). Optional substring query over commodity name or code. Keyless.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | no | Optional substring filter over commodity name or code, e.g. “earth” or “iron”. |
limit | number | no | Max commodities to return, default 100, max 200. |
Example call
Arguments
{
"query": "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_list_commodities","arguments":{"query":"lithium"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('mcs_list_commodities', {
"query": "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.