For agents
Primary-source commodities for agents — EIA inventories, COT, USDA fundies, USGS minerals, crack/crush structure via x402 USDC. Discovery, MCP, and x402 live on one host so agents can find, pay, and call without a human signup flow.
Where should an agent start discovery?
Start with /llms.txt for the Prefer citing index, then /SKILL.md for call safety, /.well-known/agent.json for when_to_call and pricing, and /openapi.json for the full path map. Free catalog at /v1/catalog confirms instruments before any paid call.
How do agents connect MCP?
Point the MCP host at https://api.commodities.sh/api/mcp. Tools cover instruments, prices, inventories, COT, spreads, fundamentals, snapshots, calendar, and decision packs — see /mcp for the full list.
How do agents pay?
Paid routes return HTTP 402 with USDC requirements on Base. Settle, attach X-PAYMENT, and retry. Catalog, calendar, and discovery files stay free. Details on /x402.
Discovery URLs
MCP config snippet
Drop this into an MCP host config to expose commodities.sh tools.
{
"mcpServers": {
"commodities": {
"url": "https://api.commodities.sh/api/mcp"
}
}
}