Primary Source Commodities MCP server
Primary-source commodities data for AI agents — EIA, FRED, CFTC, USDA, USGS via x402 on Base.
Little public usage data yet
Reviews
Write oneNobody has reviewed Primary Source Commodities yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Primary Source Commodities tools (11)
write = sends, deletes, buys or postscalendar.getFreeList 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.
catalog.listFreeList 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.
decision.getFreeBuild 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.
fundamentals.getFreeFetch a fundamentals document: USDA WASDE, crop progress, export sales, or USGS mineral summaries. Choose kind based on the ags/metals question you are answering.
fx.latestFreeReturn the latest FX rate observation for a pair or FRED FX series. Useful alongside commodity prices when converting cash values across currencies.
inventory.getFreeFetch 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.getFreeReturn 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.
price.historyFreeReturn 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.
price.latestFreeReturn 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.
snapshot.getFreeBuild 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.
spread.getFreeCompute 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.
Public scan report
scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it
- –Code scanremote-only server, no package to scann/a
- Live reliabilityremote reachable in 594ms20/20
- Tool poisoning11 tool descriptions checked15/15
- Auth qualityopen endpoint, read-only tools10/15
- Maintenanceno repository listed3/15
- Maintainer identityno repository or website to verify2/10
Findings (1)
- lowNo source repository listed
maint.no-repo
Install directly
claude mcp add --transport http commodities-sh https://api.commodities.sh/api/mcp
Primary Source Commodities: common questions
- Is Primary Source Commodities MCP server safe?
- With care: it is graded C, so read the findings first (67/100). Read the Primary Source Commodities safety report
- How do I install Primary Source Commodities?
- It runs remotely at api.commodities.sh. Add it to Claude Code, Claude Desktop or Cursor with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Primary Source Commodities need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Primary Source Commodities maintained?
- The latest release is v0.1.0.
- Is Primary Source Commodities up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.