mcpbeat

Primary Source Commodities MCP Server

io.github.sawftware-apps/commodities-sh
not responding

Primary Source Commodities is listed as active in the registry but did not answer our last check. It exposes 11 tools.

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

Uptime history 39 hours of history · worst hour 0%
39 hours agonow
0.0%
Uptime 24h
0 of 91 checks
11
Tools
read from the server
112 ms
Response time
average over 24h
open, no key
Access
streamable-http

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 13 min ago.

run in your terminal
claude mcp add commodities-sh --transport http https://api.commodities.sh/api/mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "commodities-sh": {
      "url": "https://api.commodities.sh/api/mcp"
    }
  }
}
~/.codex/config.toml
[mcp_servers.commodities-sh]
url = "https://api.commodities.sh/api/mcp"
.cursor/mcp.json
{
  "mcpServers": {
    "commodities-sh": {
      "url": "https://api.commodities.sh/api/mcp"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "commodities-sh": {
      "url": "https://api.commodities.sh/api/mcp"
    }
  }
}

Available tools 11

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

price
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.
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 provenance and license tags.
calendar
calendar.get
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.
catalog
catalog.list
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.
decision
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, rule-based only.
fundamentals
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.
inventory
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 label for that series.
latest
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.
positioning
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.
snapshot
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 when you need a full sector picture.
spread
spread.get
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.

Endpoints

URLTransportStateLatencyChecked
https://api.commodities.sh/api/mcp streamable-http answering 112 ms 13 min ago

Primary Source Commodities — questions

Answers built from our own checks of this server.

What can Primary Source Commodities do?
It exposes 11 tools, read directly from the server on our last check. Among them: calendar.get, catalog.list, decision.get, fundamentals.get, fx.latest, inventory.get and 5 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →
Is Primary Source Commodities working right now?
We send a real MCP handshake every 15 minutes. Over the last 24 hours 0 of 91 checks got a reply (0.0%), average response time 112 ms. The bar chart above shows every period we have measured.
The registry lists Primary Source Commodities as active — why does it not respond?
The official MCP registry stores what the author submitted; it does not verify that the server still runs. We check the endpoint ourselves, and this one does not answer. Catalogues that copy the registry without checking will show it as working.
How do I connect Primary Source Commodities?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.
Does Primary Source Commodities need an API key?
No. Primary Source Commodities completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 11 of them are readable on this page. This is what we observed, not what the docs claim.