INDIVIDUAL MCP TOOL

catalog.list

List every commodity instrument in the catalog with sector, unit, primary source, and freshness metadata.

commodities.shnone authenticationAvailability not checked

LIVE ENDPOINT

https://api.commodities.sh/api/mcp

No auth detected

Connect to this endpoint to inspect the live schema for catalog.list and invoke it with your own arguments.

{}

Inferred read-only · medium confidence · heuristic, not a guarantee.

No write-capable action terms were found; this is not proof that invocation has no side effects.

CONNECT WITH APPROVAL

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

[mcp_servers.commodities-sh]
url = "https://api.commodities.sh/api/mcp"
enabled = true

Claude Code

.mcp.json

{
  "mcpServers": {
    "commodities-sh": {
      "type": "http",
      "url": "https://api.commodities.sh/api/mcp"
    }
  }
}

Claude Desktop

Settings → Connectors → Add custom connector

Name: commodities-sh
Remote MCP URL: https://api.commodities.sh/api/mcp

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "commodities-sh": {
      "url": "https://api.commodities.sh/api/mcp"
    }
  }
}

Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code

{
  "servers": {
    "commodities-sh": {
      "type": "http",
      "url": "https://api.commodities.sh/api/mcp"
    }
  }
}

Generic MCP

Client-specific MCP configuration

{
  "name": "commodities-sh",
  "transport": "streamable-http",
  "url": "https://api.commodities.sh/api/mcp"
}

MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

price.latest — Return the latest cash/fundies observation for one instrument code.
inventory.get — Fetch EIA weekly petroleum inventory levels.
positioning.get — Return the latest CFTC Commitments of Traders managed-money positioning for an instrument code.
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).
price.history — Return historical observations for an instrument code (up to 500 points).
fx.latest — Return the latest FX rate observation for a pair or FRED FX series.
fundamentals.get — Fetch a fundamentals document: USDA WASDE, crop progress, export sales, or USGS mineral summaries.
snapshot.get — Build a sector snapshot bundling prices, inventories, spreads, and related fundies for energy, metals, ags, or all sectors.