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

NameTypeRequiredDescription
querystringnoOptional substring filter over commodity name or code, e.g. “earth” or “iron”.
limitnumbernoMax 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.

Regenerated from source · build October 7, 2026