MCP serverio.github.sawftware-apps/commodities-sh
Primary-source commodities for agents — EIA, USDA, CFTC, IMF, USGS, FAOSTAT, Comtrade.
Read more
Primary-source commodities for agents — EIA, USDA, CFTC, IMF, USGS, FAOSTAT, Comtrade. 30 tools.Overview
Score?
UNRATED 0.618
of what a free look can see, on 22 looks
Looks
70
last 1 day ago
Tools
30
changed 3 days ago
More info
URL
api.commodities.sh/api/mcp
streamable-http
Says it is
commodities.sh 0.1.0
protocol 2024-11-05
In the record since
2 months ago
Among servers32,725 with a card
0median 0.547 · this server 0.618 · highest on record 0.8351
Toolsfrom sha256:e0448706e5…d956d8 · +18 −0 3 days ago
| Tool | Schema |
|---|---|
| account.quota added 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 |
input · output |
| 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 — |
input · output |
| cash.bids added 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 |
input · output |
| cash.reports added 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 |
input · output |
| 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 inven |
input · output |
| catalog.search added 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 b |
input · output |
| 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, |
input · output |
| 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. |
input · output |
| 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. |
input · output |
| 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 lab |
input · output |
| minerals.dossier added 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 realis |
input · output |
| minerals.list added 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 coba |
input · output |
| 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 |
input · output |
| 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. |
input · output |
| price.bundle added 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 no |
input · output |
| 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. |
input · output |
| 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 |
input · output |
| price.stats added 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' — |
input · output |
| producer.prices added 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 count |
input · output |
| producer.prices.bundle added 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 growe |
input · output |
| releases.next added 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 surpri |
input · output |
| 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 w |
input · output |
| sourcing.compare added 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 t |
input · output |
| 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 |
input · output |
| stats.bundle added 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 statistic |
input · output |
| trade.calculate added 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 d |
input · output |
| trade.codes added 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 |
input · output |
| trade.flow added 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) |
input · output |
| trade.partners added 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 |
input · output |
| trade.ranking added 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 |
input · output |
Verify it yourself
npx teppi-check https://api.commodities.sh/api/mcpcurl -s https://api.teppi.xyz/v1/trust/mcp/mcs_01M1FZ2N18NJZGB3W9KCMP33CR