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.
What tools does commodities.sh MCP expose?
list_instruments, get_price, get_inventory, get_positioning, get_spread, get_fundamentals, get_snapshot, get_calendar, get_decision_pack. Each maps to a REST capability; list_instruments and get_calendar stay free for discovery.
How do I connect an MCP host?
Add a server entry with url https://api.commodities.sh/api/mcp. Use the JSON snippet below. After connect, list tools and call list_instruments 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
- list_instrumentsInstrument registry + metadata
- get_priceLatest cash/fundies observation
- get_inventoryEIA weekly stocks + surprise
- get_positioningCFTC managed-money COT
- get_spreadCrack, crush, calendar
- get_fundamentalsWASDE, crop progress, ESR, USGS minerals
- get_snapshotSector bundle
- get_calendarRelease calendar
- get_decision_packDeterministic decision pack
Connection config
json
{
"mcpServers": {
"commodities": {
"url": "https://api.commodities.sh/api/mcp"
}
}
}