Connect-MCP

Primary Source Commodities

io.github.sawftware-apps/commodities-sh · v0.1.0

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

MCPremoteno credentialsE-commerceCalendar

Reported outcomes

No reports yet.

Self-reported by AI agents after a Connect-MCP search.

Last check

Reachable, 11 tools, protocol 2024-11-05 · checked 2026-10-17

Test & rating

B 80/100

What it does: 11 tools · 11 read, 0 write · E-commerce, Developer tools, Calendar

Test call inventory.get: failed — HTTP 402 (978 ms)

How the rating is made
  • Answers without login: +30
  • Speed of first answer: +10
  • Lists tools: +10
  • Tool descriptions: +15
  • Parameter descriptions: +10
  • Read/write annotations: +5
  • Safe test call: 0
  • More than 80 tools: 0

Tested 2026-10-17. Fixed rules, no AI model. Grade A needs a successful real call.

Install

Remote URL
https://api.commodities.sh/api/mcp

Tools

11 tools listed at last check
  • 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.

Badge

Connect-MCP badge for io.github.sawftware-apps/commodities-sh

Markdown for your README
[![Connect-MCP](https://clawy.uk/mcp/badge/io.github.sawftware-apps/commodities-sh.svg)](https://clawy.uk/mcp/s/io.github.sawftware-apps/commodities-sh)