Primary Source Commodities

REMOTE · API.COMMODITIES.SH · SCANNED AUG 3

Primary-source commodities data for AI agents — EIA, FRED, CFTC, USDA, USGS via x402 on Base.

Available components

+6 this week 72 72 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →

Endpoint Security80

The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one. See how to fix → View diagnostics → Partial
HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail

Transport & Reachability100

Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass

Schema Quality & AI Usability77

AI-judged instruction clarity (excellent).Pass
Tool/resource definitions use about 850 tokens (~77/item across 11 items; 11 tools + 0 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass
Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass

Capabilities20

Spec-recency check failed: implements MCP spec 2024-11-05; the latest is 2026-07-28. See how to fix → Fail

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

remote · api.commodities.sh

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

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

# ~/.codex/config.toml

[mcp_servers.sawftware-apps-commodities-sh]
url = "https://api.commodities.sh/api/mcp"

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sawftware-apps-commodities-sh": {
      "type": "remote",
      "url": "https://api.commodities.sh/api/mcp",
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add sawftware-apps-commodities-sh --url https://api.commodities.sh/api/mcp --transport streamable-http

# ~/.hermes/config.yaml

mcp_servers:
  sawftware-apps-commodities-sh:
    url: "https://api.commodities.sh/api/mcp"

// mcp.json

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

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

2 Aug 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.
31 Jul 26 +3
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
29 Jul 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.
28 Jul 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.
27 Jul 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
26 Jul 26 66

First indexed and scored.

Show 6 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Probed https://api.commodities.sh/api/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject	Issuer	Valid from	Valid until	Key	Signature	Serial
CN=api.commodities.sh	CN=YR2,O=Let's Encrypt,C=US	12 Jul 2026	10 Oct 2026	RSA 2048	SHA256-RSA	5583a5587a0288b1ffcbe272d1fa2e52e00
SANs: api.commodities.sh
CN=YR2,O=Let's Encrypt,C=US (CA)	CN=Root YR,O=ISRG,C=US	3 Sept 2025	2 Sept 2028	RSA 2048	SHA256-RSA	4ebd24947e24d394802d84a52fd5b319
CN=Root YR,O=ISRG,C=US (CA)	CN=ISRG Root X1,O=Internet Security Research Group,C=US	13 May 2026	2 Sept 2032	RSA 4096	SHA256-RSA	f24b6d17f9d9ad7cb1c9fea78782699f

DNSSEC insecure

Validation of api.commodities.sh. — Not signed

Zone	DS	Keys	Algorithms	Outcome
.	trust_anchor	20326, 38696	8, 8	Verified
sh.	present	55297	8	Verified
commodities.sh.	absent			Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation

Authentication No authorisation required

The endpoint answered without asking for a token. Anyone who knows the URL can reach it.

Result	No authorisation required
HTTP status	200

Header	Value
strict-transport-security	max-age=63072000

Transports 2 probes

Transport	URL	Outcome	Status	Location
streamable-http	https://api.commodities.sh/api/mcp	Verified	200
http (plaintext)	http://api.commodities.sh/api/mcp	HTTPS enforced	308	https://api.commodities.sh/api/mcp

MCP tools — 11 exposed · ~776 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

calendar.get Release Calendar ~48

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

Input Output Examples

Input schema present but exposes no named parameters.

Name	Type	Req	Description
events	array	yes	Upcoming / recurring release events

No examples provided.

catalog.list List Instruments ~49

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.

Input Output Examples

Input schema present but exposes no named parameters.

Name	Type	Req	Description
instruments	array	yes	Instrument registry rows

No examples provided.

decision.get Decision Pack ~69

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.

Input Output Examples

Name	Type	Req	Description
sector	string	yes	Sector for the decision pack. Use all to bundle every sector.

Name	Type	Req	Description
disclaimer	string	—	Non-advice / methodology disclaimer
generated_at	string	yes	ISO timestamp when the pack was generated
method	string	yes	Deterministic method identifier
model_version	string	—	Always null for rule-based packs; reserved field
sector	string	—	Present for single-sector packs
sectors	object	—	Present when sector=all
signals	array	—	Directional signals with rationale
snapshot	object	—	—

No examples provided.

fundamentals.get USDA/USGS Fundamentals ~65

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 Examples

Name	Type	Req	Description
kind	string	yes	Fundamentals report kind. Example: wasde for World Agricultural Supply and Demand Estimates.

Name	Type	Req	Description
as_of	string	yes	Report as-of date
id	string	yes	Document id
kind	string	yes	Report kind echoed from the request
observed_at	string	yes	ISO timestamp when retrieved
payload	object	yes	Kind-specific payload (quality, note, license_tag, freshness_class, and report fields)

No examples provided.

fx.latest Latest FX Rate ~61

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 Examples

Name	Type	Req	Description
pair	string	yes	FX pair or series id. Example: EURUSD, USDCNY, DTWEXBGS.

Name	Type	Req	Description
as_of	string	yes	As-of date for the observation
derived	boolean	yes	True when value is derived
formula	string	—	Derivation formula when derived
freshness_class	string	yes	Freshness class for the series
id	string	—	Stable observation id
inputs	array	—	Input series ids when derived
instrument	string	yes	Instrument code, e.g. CL
license_tag	string	yes	License / redistribution tag
name	string	yes	Human-readable instrument name
observed_at	string	yes	ISO timestamp when observed
provenance	object	yes	Retrieval / cache provenance
quality	string	yes	Data quality label
raw_hash	string	—	Hash of raw source payload
series_id	string	yes	Underlying series id
source	object	yes	Primary source provenance
unit	string	yes	Unit of measure
value	number	yes	Observed numeric value

No examples provided.

inventory.get EIA Inventory ~80

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.

Input Output Examples

Name	Type	Req	Description
series	string	—	Optional EIA inventory series key. Omit to return all latest inventory rows. Example: crude_stocks.

Name	Type	Req	Description
data	array	—	All latest inventory points when series is omitted
latest	object	—	Latest point when a series key is provided
surprise_label	string	—	Surprise classification when series is provided
vs_5y	number	—	Deviation vs five-year average when series is provided
wow_change	number	—	Week-over-week change when series is provided

No examples provided.

positioning.get COT Positioning ~65

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 Examples

Name	Type	Req	Description
code	string	yes	Instrument code from catalog.list. Example: CL, NG, GC, ZC.

Name	Type	Req	Description
commodity_name	string	yes	CFTC commodity name
id	string	yes	COT row id
instrument	string	yes	Instrument code
mm_long	number	yes	Managed-money long contracts
mm_net	number	yes	Managed-money net contracts
mm_net_change	number	yes	Week-over-week change in managed-money net
mm_short	number	yes	Managed-money short contracts
observed_at	string	yes	ISO timestamp when observed
report_date	string	yes	CFTC report date
source_url	string	yes	CFTC source URL

No examples provided.

price.history Price History ~80

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 Examples

Name	Type	Req	Description
code	string	yes	Instrument code from catalog.list. Example: CL, GC, ZC.
limit	number	—	Number of historical points to return. Max 500, default 60.

Name	Type	Req	Description
count	number	yes	Number of points returned
data	array	yes	Historical observations, newest first or as stored
instrument	string	yes	Instrument code
series_id	string	yes	Underlying series id

No examples provided.

price.latest Latest Price ~70

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.

Input Output Examples

Name	Type	Req	Description
code	string	yes	Instrument code from catalog.list. Example: CL, GC, ZC.

Name	Type	Req	Description
as_of	string	yes	As-of date for the observation
derived	boolean	yes	True when value is derived
formula	string	—	Derivation formula when derived
freshness_class	string	yes	Freshness class for the series
id	string	—	Stable observation id
inputs	array	—	Input series ids when derived
instrument	string	yes	Instrument code, e.g. CL
license_tag	string	yes	License / redistribution tag
name	string	yes	Human-readable instrument name
observed_at	string	yes	ISO timestamp when observed
provenance	object	yes	Retrieval / cache provenance
quality	string	yes	Data quality label
raw_hash	string	—	Hash of raw source payload
series_id	string	yes	Underlying series id
source	object	yes	Primary source provenance
unit	string	yes	Unit of measure
value	number	yes	Observed numeric value

No examples provided.

snapshot.get Sector Snapshot ~76

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.

Input Output Examples

Name	Type	Req	Description
sector	string	yes	Sector to snapshot. Use all to receive energy, metals, and ags together.

Name	Type	Req	Description
as_of	string	yes	Snapshot as-of timestamp
cot	array	—	COT rows when relevant
crack_321	object	—	—
crop_progress	object	—	Crop progress when relevant
crush	object	—	—
export_sales	object	—	Export sales when relevant
freshness_note	string	—	Freshness summary
inventory	array	—	Inventory rows when relevant
prices	array	—	Latest prices for the sector
sector	string	—	Present for single-sector responses
sectors	object	—	Present when sector=all
wasde	object	—	WASDE payload when relevant

No examples provided.

spread.get Derived Spread ~113

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

Input Output Examples

Name	Type	Req	Description
root	string	—	Optional root symbol for calendar spreads. Example: CL. Ignored for crack/crush/basis.
type	string	yes	Spread type to compute. Example: crack for 3-2-1 gasoline/distillate crack.

Name	Type	Req	Description
as_of	string	—	As-of date for the observation
available	boolean	—	False when the spread cannot be computed
derived	boolean	—	True when value is derived
formula	string	—	Derivation formula when derived
freshness_class	string	—	Freshness class for the series
id	string	—	Stable observation id
inputs	array	—	Input series ids when derived
instrument	string	—	Instrument code, e.g. CL
legs_quality	array	—	Per-leg quality when inputs are mixed
license_tag	string	—	License / redistribution tag
name	string	—	Human-readable instrument name
note	string	—	Explanation when unavailable or partially degraded
observed_at	string	—	ISO timestamp when observed
provenance	object	—	Retrieval / cache provenance
quality	string	—	Data quality label
raw_hash	string	—	Hash of raw source payload
root	string	—	Calendar root when type=calendar
series_id	string	—	Underlying series id
source	object	—	Primary source provenance
unit	string	—	Unit of measure
value	number	—	Observed numeric value

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

26 Jul 3 Aug

Day	Score
26 Jul	66
27 Jul	66
28 Jul	67
29 Jul	68
30 Jul	68
31 Jul	71
1 Aug	71
2 Aug	72
3 Aug	72