MCP server
commodities.sh exposes streamable HTTP MCP tools at https://api.commodities.sh/api/mcp. Agents pull inventories, COT, spreads, fundies, and decision packs without custom REST clients.
Install
Fastest path — verified Smithery listing sawftware-apps/commodities-sh:
npx -y smithery mcp add sawftware-apps/commodities-shWhat tools does commodities.sh MCP expose?
catalog.list, price.latest, inventory.get, positioning.get, spread.get, price.history, fx.latest, fundamentals.get, snapshot.get, calendar.get, decision.get. Each maps to a REST capability; catalog.list and calendar.get stay free for discovery.
How do I connect an MCP host?
Fastest: run npx -y smithery mcp add sawftware-apps/commodities-sh. Or add a server entry with url https://api.commodities.sh/api/mcp using the Cursor/Claude JSON below. After connect, list tools and call catalog.list before any paid observation.
Do MCP tools require API keys?
No API key. Free tools respond immediately. Paid tools return HTTP 402; settle USDC on Base and retry with payment proof the same way REST does on /x402.
Tool list
- catalog.listInstrument registry + metadata
- price.latestLatest cash/fundies observation
- inventory.getEIA weekly stocks + surprise
- positioning.getCFTC managed-money COT
- spread.getCrack, crush, calendar
- price.historyHistorical time series for an instrument
- fx.latestLatest FX rate observation
- fundamentals.getWASDE, crop progress, ESR, USGS minerals
- snapshot.getSector bundle
- calendar.getRelease calendar
- decision.getDeterministic decision pack
Cursor / Claude — direct URL
Drop into Cursor .cursor/mcp.json or Claude Desktop MCP settings (same shape). Points at the production API host — no Smithery proxy required.
{
"mcpServers": {
"commodities": {
"url": "https://api.commodities.sh/api/mcp"
}
}
}