Skip to main content
Glama

Primary Source Commodities

Server Details

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

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2024-11-05
URL
ChatGPT
–
Claude
–

TDQS

A4/5.0

Scored across 30 tools

Disambiguation4/5

Most tools have clearly distinct resource+action targets, and the descriptions actively draw boundaries (price.latest vs price.bundle, calendar.get vs releases.next, producer.prices vs trade.ranking vs sourcing.compare). A few clusters still crowd each other: snapshot.get vs decision.get both 'build a sector bundle', and the price.latest/price.history/price.stats trio plus their bundle twins require reading carefully to pick correctly.

Naming Consistency4/5

Strong, predictable namespace.action convention (price.latest, trade.flow, minerals.dossier, catalog.list) used almost everywhere. Minor breaks: stats.bundle sits unnamespaced next to price.stats, and sourcing.compare is a one-off namespace rather than trade.*. Readable and mostly mechanical.

Tool Count3/5

30 tools is heavy for one server, though the breadth (prices, trade, minerals, producer economics, calendars, decisions) means most earn their place. The parallel *.bundle twins (price.bundle, producer.prices.bundle, stats.bundle) add surface that is justified by billing design but still inflates the set.

Completeness4/5

Covers the full data lifecycle for the domain: discovery, current prices, history, stats, fundamentals, inventory, positioning, trade flows/partners/rankings, derived spreads, and decision/snapshot products. Gaps are deliberate and documented (no forward curves beyond a free stub, producer prices limited to seven crops, no weather or news layer), so agents rarely hit a dead end.

Available Tools

30 tools
account.quotaRemaining Credits on This KeyA
Read-onlyIdempotent
Inspect

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 decide whether to spend on a bundle or a pack before calling one.

Inputs: no named parameters. Returns: plan, scopes, credits_used, billing_period, +2 more

calendar.getRelease CalendarA
Read-onlyIdempotent
Inspect

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 prints.

Inputs: no named parameters. Returns: events

cash.bidsCash Grain Bids and BasisA
Read-onlyIdempotent
Inspect

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 basis in CENTS per bushel against a named futures month, price in DOLLARS per bushel, location, grade, elevator class, freight and delivery. THIS IS NOT a futures settlement and NOT the NASS season-average price received that price.latest returns for ZC/ZW/ZS; all three are correct and all three differ. Values are ranges where the report published a range. Latest published print only — there is no stored history, so this cannot tell you whether basis is strengthening; read each row's basis_change, which is the agency's own answer. Wheat must name its class: CBOT soft red winter, KCBT hard red winter and MGE hard red spring traded 35 cents apart on the same page. Paid.

Inputs: commodity (required), limit, month, state, +2 more. Returns: bids, notes, commodity, instrument, +2 more

cash.reportsAMS Cash Grain Report IndexA
Read-onlyIdempotent
Inspect

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, stale (served and flagged), unlisted (AMS no longer lists it) or unknown. Three reports are published as covered-but-unparsed rather than omitted, because a visible gap beats a silent absence.

Inputs: no named parameters. Returns: reports, report_count

catalog.listList InstrumentsA
Read-onlyIdempotent
Inspect

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.

Inputs: no named parameters. Returns: instruments

catalog.searchSearch InstrumentsA
Read-onlyIdempotent
Inspect

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. Returns nothing rather than a guess when no instrument matches. Free discovery tool — no payment required.

Inputs: q (required), limit. Returns: query, results

decision.getDecision PackA
Read-onlyIdempotent
Inspect

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.

Inputs: sector (required). Returns: method, sector, sectors, signals, +4 more

fundamentals.getUSDA/USGS FundamentalsA
Read-onlyIdempotent
Inspect

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.

Inputs: kind (required). Returns: id, kind, as_of, payload, +1 more

fx.latestLatest FX RateA
Read-onlyIdempotent
Inspect

Return the latest FX rate observation for a pair or FRED FX series. Useful alongside commodity prices when converting cash values across currencies.

Inputs: pair (required). Returns: id, cite, name, unit, +17 more

inventory.getEIA InventoryA
Read-onlyIdempotent
Inspect

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.

Inputs: series. Returns: data, vs_5y, latest, wow_change, +1 more

minerals.dossierCritical Minerals Supply and TradeA
Read-onlyIdempotent
Inspect

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 reliance. REFUSES three things: no ratio between the supply side and the trade side, because USGS counts contained metal while HS counts the gross weight of a traded article and for lithium those differ by about five times; no price of any kind; no criticality or supply-risk score. EXPORTS ARE NOT PRODUCTION — for gold and silver the largest reporters refine and vault rather than mine, so the two halves rank different countries for good reasons. The HS code matches the USGS production basis, so copper, nickel and zinc point at ore and concentrate headings rather than the refined-metal headings their instruments use. Annual data. Paid.

Inputs: mineral (required), year, limit. Returns: notes, trade, supply, mineral, +5 more

minerals.listMineral Coverage and HS PairingsA
Read-onlyIdempotent
Inspect

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, since trade.codes lists headings only for catalog instruments and neither mineral has one; and the HS code here is chosen to match the USGS production basis, so copper, nickel and zinc point at ore headings rather than the refined-metal headings their instruments use. Also reports which minerals currently have US net import reliance and which column it was read from.

Inputs: no named parameters. Returns: edition, minerals, not_mapped

observation.resolveResolve ObservationA
Read-onlyIdempotent
Inspect

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>.

Inputs: id (required). Returns: id, cite, name, unit, +17 more

positioning.getCOT PositioningA
Read-onlyIdempotent
Inspect

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.

Inputs: code (required). Returns: id, mm_net, mm_long, mm_short, +6 more

price.bundleLatest Prices for Several InstrumentsA
Read-onlyIdempotent
Inspect

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 entry point would let a caller quote the single price and send the bundle. Use this instead of looping price.latest: it is one settlement and one round trip. Codes that do not resolve come back with an error field rather than being dropped, and codes past the cap are listed in dropped_codes. Paid; charged only if at least one code resolves.

Inputs: codes (required). Returns: count, observations, dropped_codes

price.historyPrice HistoryA
Read-onlyIdempotent
Inspect

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.

Inputs: code (required), limit. Returns: data, count, series_id, instrument

price.latestLatest PriceA
Read-onlyIdempotent
Inspect

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.

Inputs: code (required), currency. Returns: id, cite, name, unit, +17 more

price.statsPrice StatisticsA
Read-onlyIdempotent
Inspect

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 price.history and computing yourself. Descriptive only: no signals or view, which live in decision.get.

Inputs: code (required), windows. Returns: unit, as_of, range, change, +6 more

producer.pricesProducer Prices by CountryA
Read-onlyIdempotent
Inspect

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 farmer received, and differs from price.latest and from the export unit value in trade.partners — all three can be correct and several-fold apart. Covers seven crops only (ZC ZW ZS ZR KC CC CT); sugar, palm and livestock are deliberately unmapped because FAOSTAT prices a different product for those. Annual, usually one to two years behind.

Inputs: commodity (required), year. Returns: year, notes, source, commodity, +8 more

producer.prices.bundleFarm-Gate Prices for Several CropsA
Read-onlyIdempotent
Inspect

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 NOT the benchmark price.latest returns; all three are correct and differ. Paid; charged only if at least one crop resolves.

Inputs: codes (required), year. Returns: count, commodities, dropped_codes

releases.nextNext Releases With Last PrintA
Read-onlyIdempotent
Inspect

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 numbers as well as the timing — calendar.get answers only when. last is null when nothing is stored yet and surprise_label is null when no 5-year band exists; neither is ever guessed. Paid.

Inputs: release_id, window_days. Returns: releases

snapshot.getSector SnapshotA
Read-onlyIdempotent
Inspect

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.

Inputs: sector (required). Returns: cot, as_of, crush, wasde, +8 more

sourcing.compareCompare Sourcing CountriesA
Read-onlyIdempotent
Inspect

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 named observable field — there is NO opportunity score, because the weights would be invented. Supply freight_usd / duty_rate_pct to add a landed cost; absent costs are never defaulted, they are listed in missing. Annual data: this supports structural comparison, not an arbitrage claim. Covers the seven crops FAOSTAT prices.

Inputs: commodity (required), year, currency, incoterm, +5 more. Returns: year, notes, missing, partial, +8 more

spread.getDerived SpreadA
Read-onlyIdempotent
Inspect

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.

Inputs: type (required), root. Returns: id, cite, name, note, +21 more

stats.bundleStatistics for Several InstrumentsA
Read-onlyIdempotent
Inspect

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-instrument errors rather than a whole-call failure when one has no history. Paid; charged only if at least one instrument resolves.

Inputs: codes (required), windows. Returns: count, stats, dropped_codes

trade.calculateTrade CalculationA
Read-onlyIdempotent
Inspect

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 excluded from the total and reported in missing, never defaulted to zero. Use price.latest first if you want a benchmark price to pass as unit_price.

Inputs: calculation (required), amount, fx_rate, incoterm, +15 more. Returns: unit, notes, value, formula, +6 more

trade.codesCountry and HS Code ReferenceA
Read-onlyIdempotent
Inspect

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 one. Accepts ISO3, ISO2, a numeric M49 or an exact country name. Historical entities are excluded by default — twelve ISO3 codes resolve to more than one UN Comtrade entry and the expired one is never preferred, so IND gives India rather than pre-1974 India.

Inputs: country. Returns: note, resolved, commodities

trade.flowBilateral Trade FlowA
Read-onlyIdempotent
Inspect

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-equivalent discovery via /v1/trade/codes for valid values. Annual data; the response says whether the rows reconcile with the upstream's own total.

Inputs: year (required), reporter (required), commodity (required), flow, +1 more. Returns: flow, year, found, source, +9 more

trade.partnersTrading Partners RankedA
Read-onlyIdempotent
Inspect

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 markets. Pass the reporter as ISO alpha-3 (GHA, IND). Annual data. Completeness is verifiable for this shape: the response says whether the partner rows reconcile with the upstream's own World total.

Inputs: year (required), reporter (required), commodity (required), flow, +1 more. Returns: flow, year, notes, source, +9 more

trade.rankingCountries Ranked by TradeA
Read-onlyIdempotent
Inspect

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 PRODUCTION: a country can be a large exporter of something it does not grow — the Netherlands ranks sixth in cocoa exports and grows none. Completeness cannot be verified for this shape, so complete is always null.

Inputs: year (required), commodity (required), flow, limit. Returns: flow, year, notes, source, +6 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      maintenance
      38 AI data tools for Claude and any MCP-compatible agent covering crypto, DeFi, equities, commodities, energy, real estate, government intelligence, security audits, and more.
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      38 AI data tools for Claude and any MCP-compatible agent — crypto, DeFi, equities, commodities, energy, real estate, government intelligence, security audits, and more.
      45
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Financial intelligence for AI agents. 31 tools across 8 data sources — regime, derivatives, stablecoin flows, momentum, volatility, macro, DeFi, weather patterns, political cycles, seasonality. The context layer between your agent and a bad trade.
      31
      22 npm
      9
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources