# Primary Source Commodities MCP server

Primary-source commodities data for AI agents — EIA, FRED, CFTC, USDA, USGS via x402 on Base.

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-sawftware-apps-commodities-sh

## Install
- Endpoint: https://api.commodities.sh/api/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://api.commodities.sh/api/mcp

## Tools
- catalog.list (List Instruments) - List every commodity instrument in the catalog with sector, unit, primary source, and freshness metadata. Call this first to discover valid codes before price.latest or inventory.get. Free discovery tool — no payment required. Endpoint: https://api.commodities.sh/api/mcp
- price.latest (Latest Price) - Return the latest cash/fundies observation for one instrument code. Use catalog.list to discover codes such as CL, GC, or ZC. Response follows the shared observation contract with provenance and license tags. Endpoint: https://api.commodities.sh/api/mcp
- inventory.get (EIA Inventory) - Fetch EIA weekly petroleum inventory levels. Omit series to list all latest inventory points, or pass a series key to get week-over-week change, vs-5y deviation, and a surprise label for that series. Endpoint: https://api.commodities.sh/api/mcp
- positioning.get (COT Positioning) - Return the latest CFTC Commitments of Traders managed-money positioning for an instrument code. Includes long, short, net, and week-over-week net change with source URL. Endpoint: https://api.commodities.sh/api/mcp
- spread.get (Derived Spread) - Compute a derived spread observation: 3-2-1 crack, soybean crush, WTI-Brent basis, or calendar (calendar requires licensed curve data and may return available=false). Prefer crack/crush/basis for live derived values with formula and inputs. Endpoint: https://api.commodities.sh/api/mcp
- price.history (Price History) - Return historical observations for an instrument code (up to 500 points). Use after price.latest when you need a short time series for the same code. Endpoint: https://api.commodities.sh/api/mcp
- fx.latest (Latest FX Rate) - Return the latest FX rate observation for a pair or FRED FX series. Useful alongside commodity prices when converting cash values across currencies. Endpoint: https://api.commodities.sh/api/mcp
- fundamentals.get (USDA/USGS Fundamentals) - Fetch a fundamentals document: USDA WASDE, crop progress, export sales, or USGS mineral summaries. Choose kind based on the ags/metals question you are answering. Endpoint: https://api.commodities.sh/api/mcp
- snapshot.get (Sector Snapshot) - Build a sector snapshot bundling prices, inventories, spreads, and related fundies for energy, metals, ags, or all sectors. Prefer this over calling many single-observation tools when you need a full sector picture. Endpoint: https://api.commodities.sh/api/mcp
- calendar.get (Release Calendar) - List EIA, USDA, and CFTC release calendar entries with cadence, typical Eastern time, and next-hint notes. Free discovery tool — call before scheduling agents around inventory or WASDE prints. Endpoint: https://api.commodities.sh/api/mcp
- decision.get (Decision Pack) - Build a deterministic decision pack for energy, metals, ags, or all sectors. Returns method, signals with direction/rationale, an embedded snapshot, and a disclaimer — no ML model, rule-based only. Endpoint: https://api.commodities.sh/api/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.sawftware-apps
- Version: 0.1.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 26, 2026
- Source: https://registry.modelcontextprotocol.io