Analytics

commodities.sh

Provides commodity market data including prices, inventories, positioning, and derived spreads for financial analysis.

x402 supported1 endpoint11 known toolsFirst detected August 15, 2026Last detected August 15, 2026

ENDPOINT 1

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

No auth detected

MCP server metadata

Name: commodities.sh
Version: 0.1.0

Capabilities

tools

Server instructions

Primary-source commodities MCP. Start with catalog.list (free) to discover instrument codes, then price.latest / inventory.get / positioning.get for observations. Use snapshot.get for a sector bundle and decision.get for deterministic signal packs. calendar.get (free) lists EIA/USDA/CFTC release cadence. Paid tools settle via x402 USDC on Base.

Known tools 11

catalog.list

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

Inferred read-only

price.latest

Return the latest cash/fundies observation for one instrument code.

Inferred read-only

inventory.get

Fetch EIA weekly petroleum inventory levels.

Inferred read-only

positioning.get

Return the latest CFTC Commitments of Traders managed-money positioning for an instrument code.

Inferred read-only

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).

Inferred read-only

price.history

Return historical observations for an instrument code (up to 500 points).

Inferred read-only

fx.latest

Return the latest FX rate observation for a pair or FRED FX series.

Inferred read-only

fundamentals.get

Fetch a fundamentals document: USDA WASDE, crop progress, export sales, or USGS mineral summaries.

Inferred read-only

snapshot.get

Build a sector snapshot bundling prices, inventories, spreads, and related fundies for energy, metals, ags, or all sectors.

Inferred read-only

calendar.get

List EIA, USDA, and CFTC release calendar entries with cadence, typical Eastern time, and next-hint notes.

Inferred read-only

decision.get

Build a deterministic decision pack for energy, metals, ags, or all sectors.

Inferred read-only

CONNECT WITH APPROVAL

Client installation

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.

TRUST AND VERIFICATION EVIDENCE

Loading Trust v2 evidence…

Checking the associated registrable domain. The BuiltWith key remains server-side.

Indexed

Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.