Primary Source Commodities
REMOTE · API.COMMODITIES.SH · SCANNED SEP 21
Primary-source commodities data for AI agents — EIA, FRED, CFTC, USDA, USGS via x402 on Base.
Available components
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 → Why this is hard to 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 Usability81
- 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 Management100
- No destabilizing schema changes in the last 30 days.Pass
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
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 11 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 12 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities20
- Spec-recency check failed: implements MCP spec 2024-11-05; the latest is 2026-07-28. See how to fix → Fail
How do I install the Primary Source Commodities MCP server?
Primary Source Commodities is a hosted endpoint at https://api.commodities.sh/api/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · api.commodities.sh
claude mcp add --transport http sawftware-apps-commodities-sh 'https://api.commodities.sh/api/mcp'
{
"mcpServers": {
"sawftware-apps-commodities-sh": {
"url": "https://api.commodities.sh/api/mcp"
}
}
} {
"servers": {
"sawftware-apps-commodities-sh": {
"type": "http",
"url": "https://api.commodities.sh/api/mcp"
}
}
} [mcp_servers.sawftware-apps-commodities-sh] url = "https://api.commodities.sh/api/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"sawftware-apps-commodities-sh": {
"type": "remote",
"url": "https://api.commodities.sh/api/mcp",
"enabled": true
}
}
} openclaw mcp add sawftware-apps-commodities-sh --url 'https://api.commodities.sh/api/mcp' --transport streamable-http
mcp_servers:
sawftware-apps-commodities-sh:
url: "https://api.commodities.sh/api/mcp" {
"McpServers": {
"sawftware-apps-commodities-sh": {
"Transport": "http",
"Url": "https://api.commodities.sh/api/mcp"
}
}
} assistant mcp add sawftware-apps-commodities-sh -t streamable-http -u 'https://api.commodities.sh/api/mcp'
{
"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.
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.
- 26 Aug 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 25 Aug 26 0
- Stability: 0.97 → pass security
- 24 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.
- 11 Aug 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
- 31 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
- 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
- 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 0
First indexed and scored.
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 21 Sept 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 | 13 Sept 2026 | 12 Dec 2026 | RSA 2048 | SHA256-RSA | 5be9e6b38f998aef6dfb069c43b3aebc768 |
| 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 |
Background: What to check on a remote MCP endpoint →
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 |
Background: How OAuth 2.1 works in the 2026 MCP spec →
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 |
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. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
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 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 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
What is the Primary Source Commodities MCP server?
Primary Source Commodities is an MCP server listed in the public MCP registry as io.github.sawftware-apps/commodities-sh. Primary-source commodities data for AI agents, EIA, FRED, CFTC, USDA, USGS via x402 on Base. This page covers its hosted endpoint (https://api.commodities.sh/api/mcp).
Is the Primary Source Commodities MCP server safe to use?
Primary Source Commodities scores 85 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Primary Source Commodities MCP server expose?
Primary Source Commodities exposes 11 tools: catalog.list, price.latest, inventory.get, positioning.get, spread.get, and 6 more. Their descriptions and schemas cost roughly 776 tokens of context every time the server is loaded.
Does the Primary Source Commodities MCP server require authentication?
No. We connected to Primary Source Commodities without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.
Is the Primary Source Commodities MCP server still maintained?
Primary Source Commodities is still listed as active in the MCP registry. We last reached this channel on 21 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.