Skip to content
MCP server

Usgs Mineral Commodities

US mineral production, trade and reserves for 85 commodities from USGS summaries

Install
Pricing
Freemium
Platforms
API, CLI
Runs
Locally or Remotely
Version
0.2.1
Listing updated
2 days ago

About Usgs Mineral Commodities

Usgs Mineral Commodities is a freemium MCP server for analytics and data. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/usgs-mineral-commodities/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "usgs-mineral-commodities": {
      "url": "https://gateway.pipeworx.io/usgs-mineral-commodities/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $49 a month

Anonymous 50 calls/day, free account 200/day; paid from $49/month or pay as you go

Prices change. Check pipeworx.io before you buy.

Usgs Mineral Commodities 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 to Usgs Mineral Commodities

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data
  6. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media