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
51 days of history · worst day 0%
51 days agonow
66.7%
Uptime 24h
60 of 90 checks
11
Tools
read from the server
345 ms
Response time
average over 24h
open, no key
Access
streamable-http
Primary Source Commodities does not always answer
Over the last week it answered 76.7% of our checks. We check every 15 minutes, so you hear about the next outage within the hour — not from your users.
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
| URL | Transport | State | Latency | Checked |
|---|---|---|---|---|
| https://api.commodities.sh/api/mcp | streamable-http | answering | 150 ms | 13 min ago |
Alternatives to Primary Source Commodities
same job, measured the same wayX402 API
by fernsugi
DeFi data API for AI agents — pay-per-call via x402/USDC on Base
Boo X402 MCP
by lucle87
Pay-per-call crypto data for AI agents. USDC on Base via x402. No API key.
Toolcall
by toolcall
30 pay-per-call APIs for AI agents: compliance, trade, safety, web, data. USDC on Base via x402.
A
CryptoPulse Data API
by saascloud
Pay-per-call crypto market intelligence for AI agents. USDC on Base via x402.
O
Polyform
by polyform
Pay-per-call data APIs for AI agents. USDC on Base via x402. 33 tools, no signup.
Orchard Data MCP
by letom1176-spec
Pay-per-call market data for AI agents via x402 (USDC on Base): regime, track record, catalysts.
Agent Newsstand
by agentnewsstand
Market data and web intelligence for AI agents, paid per call in USDC on Base via x402.
J
agentfeeds.jp
by agentfeeds-api
Japan regulatory, sanctions & DEX market data for AI agents via x402 (USDC on Base).
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 60 of 90 checks got a reply (66.7%), average response time 345 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.
How fast is Primary Source Commodities?
It answers our handshake in 345 ms on average, which is faster than 47% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.