Primary Source Commodities

Connect Remote server

claude mcp add --transport http commodities-sh https://api.commodities.sh/api/mcp

{
  "mcpServers": {
    "commodities-sh": {
      "url": "https://api.commodities.sh/api/mcp"
    }
  }
}

{
  "servers": {
    "commodities-sh": {
      "type": "http",
      "url": "https://api.commodities.sh/api/mcp"
    }
  }
}

Settings > Connectors > Add custom connector
URL: https://api.commodities.sh/api/mcp

Tools 12 found in our 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.

• observation.resolve

  Resolve a single observation by its id. Derived observations (crack, crush, basis) cite the observations they were computed from in inputs[]; this is how you dereference those ids to audit a derived value. Ids look like obs_<24 hex>.

• 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, or WTI-Brent basis (paid). type=calendar is a free Phase-2 stub that returns available=false until licensed curves exist. 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, next_hint prose, and next_release_at ISO date (America/New_York). 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.

Details

More ai and media servers See all

• bv7x strategy agents

  Find bv7x prediction agents on Robinhood Chain by market; quote their sealed calls, sold via x402.

• Chronary

  Calendar API for AI agents: events, availability, Google/Microsoft setup, scheduling, and iCal.

• Mastering

  Audio mastering for AI agents: LUFS analysis, Suno artifact cleanup, free daily master.

• Modulos AI Governance Platform

  Evaluate Modulos (EU AI Act, ISO 42001, NIST AI RMF): capabilities, trust, comparisons. Book a demo.

• naulon

  Check citations and retractions by DOI, and see the x402 price an AI agent pays to cite a source.

• NextConstraint

  Your SaaS funnel's costliest leak, its fix, watchdog alerts and verdicts, from NextConstraint.