List your agent

Primary Source Commodities

MCP server● Hosted · onlinev0.2.0

Primary-source commodities for agents — EIA, USDA, CFTC, IMF, USGS, FAOSTAT, Comtrade. 30 tools

Reviews

No review yet. Used Primary Source Commodities? Be the first to help others choose.

What it does

Primary Source Commodities is an MCP server, a connector that lets an AI assistant use it as a tool. It is hosted: an assistant connects to it over the internet, nothing to install.

No capability identified yet from its description.

Facts come from the Official MCP Registry, as declared by the publisher. Capabilities are matched automatically (low confidence). None of this is a test of the tool.

At a glance

Hosted (remote)YES
Local installNO
Version0.2.0
PriceNot in the registry
First seen26 Sept 2026
Last checked3h ago

How to connect

As declared in the Official MCP Registry · hosted endpoint tested by Electra Index 20h ago (live check)

Hosted endpoint

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

In Claude Code: claude mcp add --transport http primary-source-commodities https://api.commodities.sh/api/mcp

MCP settings (Claude Desktop, Cursor and other MCP clients)

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

Live check

Electra Index connected to the hosted endpoint 20h ago

ONLINE Primary Source Commodities answered an MCP connection on 15 Nov 2026 and introduced itself as commodities.sh 0.1.0 (MCP protocol 2024-11-05).

30 tools offered to AI assistants

  • catalog.list · FREE. 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.
  • catalog.search · FREE. Resolve a human commodity name to an instrument code — 'cocoa' to CC, 'copper' to HG, 'palm oil' to PO. Use this instead of catalog.list when you already know the commodity by name and need the code to call price.latest or trade.flow.
  • 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.
  • price.stats · Realized volatility, change over window, and range for an instrument, computed over its stored history. Use this for 'how volatile is X' and 'how has X moved over the last year' — it answers both in one call, so prefer it over fetching pric
  • trade.calculate · Deterministic trade arithmetic over numbers you supply: landed cost, trade margin, break-even price, or the effect of a USD move. Nothing is sourced — there is no free source for duty rates, freight or insurance, so an input you omit is exc
  • trade.flow · Import or export volume and value between two countries for one commodity and year, from UN Comtrade. Use for 'how much X did A sell to B'. Pass countries as ISO alpha-3 (IND, GHA) and partner=WLD for the world total. Call trade.codes-equiv
  • sourcing.compare · For one commodity and year, compare countries as a source: what the grower was paid (FAOSTAT farm gate) against what it left the country for (UN Comtrade export unit value), plus the share reaching the grower. Ranked cheapest first on a nam
  • producer.prices · Farm-gate producer prices by country for one commodity and year, from FAOSTAT. Use for 'where is this cheap at source' and for comparing what growers are actually paid across countries. THIS IS NOT A BENCHMARK: a producer price is what the
  • trade.partners · Every country one reporter traded a commodity with in a year, ranked by value, each with the implied unit value it paid or received. Use for 'where does Ghana sell its cocoa and at what price to each buyer' and for comparing prices across m
  • trade.ranking · Largest exporting or importing countries for a commodity in a year, ranked by value, each with the implied unit value it realised. Use for 'who are the biggest cocoa exporters' and 'which sourcing market is cheapest'. EXPORTS ARE NOT PRODUC
  • 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.
Show 18 more
  • 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 wit
  • 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 · FREE. 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 prin
  • trade.codes · Resolve a country to the UN M49 code the trade tools require, and list the HS headings this catalog maps. FREE. Call this BEFORE trade.flow, trade.partners or trade.ranking: those take a reporter code and there is no other way to discover o
  • minerals.list · Which minerals the dossier covers, the HS code curated for each, and the caveats on comparing supply to trade. FREE. Worth calling before minerals.dossier for two reasons: the cobalt and lithium HS headings exist nowhere else in this API, s
  • cash.reports · Which USDA AMS daily cash grain bid reports exist, which state and commodities each covers, and how fresh each is. FREE. Call before cash.bids to learn which states are covered and which reports have stopped publishing: liveness is current,
  • price.bundle · The latest observation for up to 20 instruments in ONE call. A separate tool from price.latest rather than an optional argument on it, because the two are priced differently and nothing binds a payment to a request body — one multiplexed en
  • stats.bundle · Volatility, change and range for up to 20 instruments in ONE call. A separate tool from price.stats, for the same pricing reason as price.bundle. Returns the same derived statistics over the full retained history per instrument, with per-in
  • producer.prices.bundle · FAOSTAT farm-gate producer prices by country for up to 20 crops in ONE call. A separate tool from producer.prices, for the same pricing reason as price.bundle. This is what a grower was paid at the farm gate — NOT an export unit value and N
  • account.quota · How many credits the calling Pro key has left in the current billing period, and which scopes it may read. FREE, and requires an API key in the Authorization header — x402 callers pay per request and have no quota to report. Use it to decid
  • minerals.dossier · Who mines a mineral, who holds its reserves, and who exports it — USGS Mineral Commodity Summaries production and reserves by country, joined to UN Comtrade export flows and realised unit values, with supply concentration and US net import
  • cash.bids · A country elevator's cash bid for physical grain, from USDA AMS daily cash grain bid reports, searched across every state report at once — which AMS itself cannot do, because MARS is report-centric with no commodity-wide search. Returns bas
  • releases.next · The release calendar joined to what each report last said: expected_at with a real Eastern offset, the last print's values, week-on-week change, the 5-year comparison, and a surprise label. Use this instead of calendar.get when you need the
  • 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.

What "online" means: the server answered an MCP connection at the time of the check. It is not a guarantee of security, quality or continuous uptime. How we test: we open an MCP session and ask for the tool list, as an AI assistant would. We never run a tool and never send a key. Checked every few days. Method

Is this your server? Monitoring Pro: a check every 30 minutes and an email within the hour when it stops answering. Launch offer: $39.99 once, for life.

Facts & evidence

Each fact shows where it was seen and when.
FactValueEvidenceSourceLast confirmed
Hosted endpointhttps://api.commodities.sh/api/mcpDECLAREDSRC-001 Official MCP Registry3h ago
Repositoryhttps://github.com/sawftware-apps/commoditiesDECLAREDSRC-001 Official MCP Registry3h ago
Version0.2.0DECLAREDSRC-001 Official MCP Registry3h ago
Local install (package)noDECLAREDSRC-001 Official MCP Registry3h ago
Remote access (hosted)yesDECLAREDSRC-001 Official MCP Registry3h ago
Registry statusactiveDECLAREDSRC-001 Official MCP Registry3h ago
MCP serveryesDECLAREDSRC-001 Official MCP Registry3h ago

Change history

  • VERSION15 Nov 2026
    0.1.0 → 0.2.0

Is this page accurate?

Flag it and our robot re-checks the official source. Reports never change a score.

Do you run Primary Source Commodities? Know when it stops answering

For publishers · optional

Its hosted endpoint can be monitored. Monitoring Pro connects every 30 minutes like an AI assistant, emails you within the hour when it stops answering, keeps a 90-day availability history and adds your answer rate to your badge.

Monitor Primary Source CommoditiesLaunch offer $39.99 once, for life instead of $9.99/month · All plans

Monitoring never changes a score or a rank.

Are you the publisher of Primary Source Commodities?

Free · show your listing

An independent listing builds trust with your buyers. Announce it, and add the badge to your website or README.

Announce it on LinkedIn
Listed on Electra IndexListed on Electra Index
<a href="https://electraindex.com/mcp/primary-source-commodities?utm_source=badge&utm_medium=share&utm_campaign=listing"><img src="https://electraindex.com/api/badge/primary-source-commodities/card" width="260" height="72" alt="Listed on Electra Index"></a>

Questions about Primary Source Commodities

How do I connect Primary Source Commodities?

Use the hosted endpoint https://api.commodities.sh/api/mcp in your assistant's MCP settings. The exact settings are in "How to connect" above, as declared in the Official MCP Registry.

What tools does Primary Source Commodities offer?

When Electra Index connected on 15 Nov 2026, it listed 30 tools: catalog.list, catalog.search, price.latest, price.stats, trade.calculate, trade.flow, sourcing.compare, producer.prices and more. The full list is in "Live check" above.

Is Primary Source Commodities online?

Yes. Its hosted endpoint answered an MCP connection from Electra Index 20h ago.