# Primary Source Commodities (remote · api.commodities.sh)

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

- Trust score: 72/100 (medium)
- Change this week: +6
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `api.commodities.sh`: 72/100 (this document), [markdown](https://verifymcp.io/servers/sawftware-apps-commodities-sh/api-mcp.md), [page](https://verifymcp.io/servers/sawftware-apps-commodities-sh/api-mcp)

## Channel facts

- Endpoint: `https://api.commodities.sh/api/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.1.0`

## Trust breakdown

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. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 80/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 77/100
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 850 tokens (~77/item across 11 items; 11 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 20/100
  - Spec-recency check failed: implements MCP spec 2024-11-05; the latest is 2026-07-28.

## Install

### Claude

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

### Codex

```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
    }
  }
}
```

### OpenClaw

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

### Hermes

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

### Other

```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 recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 72, +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.

### 2026-07-31 (score 71, +3)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 68, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-29 (score 68, +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.

### 2026-07-28 (score 67, +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.

### 2026-07-27 (score 66, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 66)

First indexed and scored.

## MCP tools (11)

### `catalog.list` (~49 tokens)

List Instruments

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.

Output parameters:

- `instruments` (array): Instrument registry rows

### `price.latest` (~70 tokens)

Latest Price

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 parameters:

- `code` (string, required): Instrument code from catalog.list. Example: CL, GC, ZC.

Output parameters:

- `as_of` (string): As-of date for the observation
- `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
- `license_tag` (string): License / redistribution tag
- `name` (string): Human-readable instrument name
- `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
- `series_id` (string): Underlying series id
- `source` (object): Primary source provenance
- `unit` (string): Unit of measure
- `value` (number): Observed numeric value

### `inventory.get` (~80 tokens)

EIA Inventory

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 parameters:

- `series` (string): Optional EIA inventory series key. Omit to return all latest inventory rows. Example: crude_stocks.

Output parameters:

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

### `positioning.get` (~65 tokens)

COT Positioning

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 parameters:

- `code` (string, required): Instrument code from catalog.list. Example: CL, NG, GC, ZC.

Output parameters:

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

### `spread.get` (~113 tokens)

Derived Spread

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 parameters:

- `root` (string): Optional root symbol for calendar spreads. Example: CL. Ignored for crack/crush/basis.
- `type` (string, required): Spread type to compute. Example: crack for 3-2-1 gasoline/distillate crack.

Output parameters:

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

### `price.history` (~80 tokens)

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 parameters:

- `code` (string, required): Instrument code from catalog.list. Example: CL, GC, ZC.
- `limit` (number): Number of historical points to return. Max 500, default 60.

Output parameters:

- `count` (number): Number of points returned
- `data` (array): Historical observations, newest first or as stored
- `instrument` (string): Instrument code
- `series_id` (string): Underlying series id

### `fx.latest` (~61 tokens)

Latest FX Rate

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

Input parameters:

- `pair` (string, required): FX pair or series id. Example: EURUSD, USDCNY, DTWEXBGS.

Output parameters:

- `as_of` (string): As-of date for the observation
- `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
- `license_tag` (string): License / redistribution tag
- `name` (string): Human-readable instrument name
- `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
- `series_id` (string): Underlying series id
- `source` (object): Primary source provenance
- `unit` (string): Unit of measure
- `value` (number): Observed numeric value

### `fundamentals.get` (~65 tokens)

USDA/USGS Fundamentals

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 parameters:

- `kind` (string, required): Fundamentals report kind. Example: wasde for World Agricultural Supply and Demand Estimates.

Output parameters:

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

### `snapshot.get` (~76 tokens)

Sector Snapshot

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 parameters:

- `sector` (string, required): Sector to snapshot. Use all to receive energy, metals, and ags together.

Output parameters:

- `as_of` (string): 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

### `calendar.get` (~48 tokens)

Release Calendar

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.

Output parameters:

- `events` (array): Upcoming / recurring release events

### `decision.get` (~69 tokens)

Decision Pack

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 parameters:

- `sector` (string, required): Sector for the decision pack. Use all to bundle every sector.

Output parameters:

- `disclaimer` (string): Non-advice / methodology disclaimer
- `generated_at` (string): ISO timestamp when the pack was generated
- `method` (string): 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)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/sawftware-apps-commodities-sh/api-mcp#diagnostics

## Score history

- 2026-08-03: 72
- 2026-08-02: 72
- 2026-08-01: 71
- 2026-07-31: 71
- 2026-07-30: 68
- 2026-07-29: 68
- 2026-07-28: 67
- 2026-07-27: 66
- 2026-07-26: 66

## Links

- Remote endpoint: https://api.commodities.sh/api/mcp
- Changelog RSS feed: https://verifymcp.io/servers/sawftware-apps-commodities-sh/api-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/sawftware-apps-commodities-sh/api-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/sawftware-apps-commodities-sh/api-mcp