Primary Source Commodities
REMOTE · API.COMMODITIES.SH
Primary-source commodities data for AI agents — EIA, FRED, CFTC, USDA, USGS via x402 on Base.
Available components
Last scanned (19 hours ago)
Scores higher than 90% of remote servers
Reachable. Last reached 5 Nov 2026.
Category Finance and Payments
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. Nothing on it is marked destructive, but we can't show that an anonymous caller can only read: full credit needs the server to list at least one tool and every tool to be verifiably read-only. We use a best-effort check of tool names and descriptions to tell read-only tools from tools that change things, so some genuinely read-only tools may not get full credit. Names that start with a read verb (get, list, read, search and similar) and accurate readOnlyHint annotations help. Meet that to earn full credit, or require authorisation. 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 868 tokens (~78/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
Checks we ran (13)
- TLS certificate
- Authorization
- HTTPS
- HSTS header
- DNSSEC
- Transport
- Schema quality
- Stability
- Tool coverage
- Injection markers
- Destructive annotations
- Judged manipulation
- MCP protocol
Does not apply to this hosted endpoint (2)
- Supply Chain SecurityScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
- Provenance & TransparencyScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
The score does not measure everything. What the score does not measure →
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 Nov 26 0
- Tool “calendar.get” rewrote its description, which is the text the model reads security
- Tool “spread.get” rewrote its description, which is the text the model reads security
- 28 Sept 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
- 25 Sept 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 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
- 25 Aug 26 0
- Stability: 0.97 → pass security
- 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
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 5 Nov 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. | DS published | 34349 | 8 | Verified |
| commodities.sh. | No DS | 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 ~58
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.
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 |
| cite | string | – | One-line citation for agents |
| 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 |
| pct_change | number | – | Percent change vs prior print |
| prior | number | – | Previous print value when history exists |
| 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 |
| short_history | array | – | Newest-first short history (≤8 points) |
| 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 |
| cite | string | – | One-line citation for agents |
| 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 |
| pct_change | number | – | Percent change vs prior print |
| prior | number | – | Previous print value when history exists |
| 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 |
| short_history | array | – | Newest-first short history (≤8 points) |
| 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 ~121
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.
| 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 |
| cite | string | – | One-line citation for agents |
| 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 |
| pct_change | number | – | Percent change vs prior print |
| prior | number | – | Previous print value when history exists |
| 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 |
| short_history | array | – | Newest-first short history (≤8 points) |
| source | object | – | Primary source provenance |
| unit | string | – | Unit of measure |
| value | number | – | Observed numeric value |
No examples provided.
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'
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 794 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 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What did VerifyMCP test on the Primary Source Commodities MCP server?
VerifyMCP ran 13 checks on Primary Source Commodities, covering TLS certificate, Authorization, HTTPS, HSTS header and 9 more. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.