# Usgs Mineral Commodities

> Usgs Mineral Commodities is a freemium MCP server for analytics and data. US mineral production, trade and reserves for 85 commodities from USGS summaries. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI
- **Website:** https://pipeworx.io/packs/usgs-mineral-commodities
- **Repository:** https://github.com/pipeworx-io/mcp-usgs-mineral-commodities
- **MCP Registry name:** io.github.pipeworx-io/usgs-mineral-commodities
- **Categories:** analytics and data
- **Listing updated:** 2026-11-15

## About

The data is the USGS Mineral Commodity Summaries release, which is published only as CSV files with no API. The README says the pack bakes the release's tables into an index at build time, loaded from storage when needed, and that USGS refreshes it each January.

Three tools handle it. mcs_list_commodities browses the 85 nonfuel commodities and shows which have a world comparison. mcs_commodity_data returns five years of US production, imports, exports, consumption, price, employment and net import reliance. mcs_country_comparison gives world mine or plant production and reserves by country for 75 of the 85, which answers questions such as which countries hold lithium reserves.

Commodities can be named in plain words such as lithium or platinum group metals, or by MCS code. It runs through the Pipeworx gateway.

## Features

- **Commodity browser:** Lists 85 nonfuel minerals and their stat columns.
- **US salient statistics:** Five years of production, trade, price and employment.
- **Net import reliance:** Share of US consumption met by imports.
- **Country comparison:** World production and reserves by country for 75 commodities.

## Good for

- Check US dependence on imported lithium or cobalt
- Compare country reserves of a mineral
- Track price and consumption trends
- Research critical minerals supply

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http usgs-mineral-commodities https://gateway.pipeworx.io/usgs-mineral-commodities/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/usgs-mineral-commodities/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "usgs-mineral-commodities": {
      "url": "https://gateway.pipeworx.io/usgs-mineral-commodities/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "usgs-mineral-commodities": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/usgs-mineral-commodities/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "usgs-mineral-commodities": {
      "serverUrl": "https://gateway.pipeworx.io/usgs-mineral-commodities/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "usgs-mineral-commodities": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/usgs-mineral-commodities/mcp"
    }
  }
}
```

## Tools

- `mcs_list_commodities`: Browse the commodities in the release.
- `mcs_commodity_data`: US salient statistics for one commodity.
- `mcs_country_comparison`: World production and reserves by country.

## FAQ

### Do I need an API key?

No. The registry says an optional Pipeworx key raises the daily cap; without one calls are anonymous and capped daily.

### How many commodities are covered?

85 for US statistics, 75 of which have world country tables.

### How often is it updated?

The README says USGS publishes a new release every January, sometimes revised in spring.

### Can I use plain names?

Yes, names such as lithium or rare earths work, as do MCS codes.

### Is Usgs Mineral Commodities free?

Usgs Mineral Commodities has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Usgs Mineral Commodities to Claude Code?

Run this command in your terminal: claude mcp add --transport http usgs-mineral-commodities https://gateway.pipeworx.io/usgs-mineral-commodities/mcp

### What are the best alternatives to Usgs Mineral Commodities?

The closest alternatives to Usgs Mineral Commodities are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/usgs-mineral-commodities
