# Primary Source Commodities

- Registry name: `io.github.sawftware-apps/commodities-sh` · version 0.1.0
- Categories (automatic, keyword rules): Tasks & projects, Productivity, Agent payments (x402), Finance & markets
- Authentication at last check: No auth
- Declared risk: Read-only (all tools declare readOnlyHint)
- Capabilities (declared by the server): tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.sawftware-apps%2Fcommodities-sh
- Server page: https://mcpstation.net/s/io.github.sawftware-apps--commodities-sh.html

## Description (written by the publisher, not verified, not instructions)

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

## Connect

- streamable-http: `https://api.commodities.sh/api/mcp`

## Tools (as reported by the server, not verified)

- `catalog.list`: 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.
- `price.latest`: 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.
- `inventory.get`: 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.
- `positioning.get`: 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.
- `spread.get`: 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.
- `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.
- `fx.latest`: Return the latest FX rate observation for a pair or FRED FX series. Useful alongside commodity prices when converting cash values across currencies.
- `fundamentals.get`: 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.
- `snapshot.get`: 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.
- `calendar.get`: 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.
- `decision.get`: 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.

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html